Aide:Syntaxe
Sommaire
Syntaxe de base
Créer une section
Voici comment les créer :
- Titre de niveau 2 :
== Titre ==
- Titre de niveau 3 :
=== Titre ===
- Titre de niveau 4 :
==== Titre ====
Le niveau 1 (=) est interdit dans les articles, car il est réservé au titre de la page.
Les titres de sections ne doivent être ni en gras, ni en italique ni soulignés, car cela gênerait la création de liens vers des sections précises depuis un autre article.
Créer un sommaire
Le sommaire sera créé automatiquement dès que quatre titres de sections seront présents. Pour les opérations plus complexes sur les sommaires voyez le paragraphe « modifier le sommaire » ci-dessous.
Faire un retour à la ligne
Pour changer de paragraphe, un simple saut à la ligne n'a aucun effet. Il faut intercaler une ligne vide entre les deux paragraphes, comme ceci :
| Syntaxe | Rendu |
|---|---|
|
|
Une ligne vide permet d'espacer les paragraphes |
Il existe une balise permettant de faire uniquement un retour à la ligne : <br />. Elle est la plupart du temps utilisée pour mettre en page des légendes d'images, car le texte doit occuper le moins d'espace possible. Voici un exemple :
| Syntaxe | Rendu |
|---|---|
|
|
Cette balise permet de faire |
Cette balise peut être écrite indifféremment <br>, <br />, <br/>, <br\> ou </br>, mais la syntaxe <br /> semble faire consensus pour éviter des corrections inutiles de fautes supposées.
De plus, pour les citations, les poésies, etc., il existe une balise qui permet d'aller à la ligne dès le saut de ligne : <poem> :
| Syntaxe | Rendu |
|---|---|
|
|
<poem> La balise poem permet le saut à la ligne sans balise br </poem> |
Générer une liste
- Grâce aux
*et#, il est possible d'obtenir des listes numérotées ou non. - Grâce aux
;et:, on peut créer des listes de définitions où des termes sont mis en évidence par rapport à leur description.
| Syntaxe | Rendu |
|---|---|
|
Liste simple | |
|
|
|
|
Liste numérotée | |
|
|
|
|
Il est possible de faire une liste en combinant les deux symboles | |
|
|
|
|
Liste de définitions | |
|
|
|
Mettre en forme le texte
Position du texte
| Syntaxe | Rendu |
|---|---|
| Positionnement du texte | |
|
|
et à droite ?
|
| Plusieurs colonnes | |
|
|
3 ou 4 colonnes est généralement un maximum dans les articles afin de tenir compte des petits écrans.
|
Forme du texte
Il est possible de mettre en gras, en italique etc., le texte pour mettre en valeur les informations d'un texte ou pour écrire le titre d'une œuvre selon les conventions (par exemple, un titre de film doit être en italique).
| Syntaxe | Rendu |
|---|---|
|
|
Gras |
|
|
Texte |
|
|
Texte |
|
|
Indice2 Indice2 |
Créer un lien
Le logiciel ne fait pas de différence typographique pour la première lettre des titres, ni d'ailleurs pour la première lettre de l'espace de nom : il est indifférent du point de vue technique d'écrire dans les liens [[Catégorie:Encyclopédie]] ; [[catégorie:Encyclopédie]] ; [[Catégorie:encyclopédie]] ; etc., mais écrire [[europe]] donnera europe et non Europe.
Liens internes
Les liens internes sont les liens qui pointent vers un autre article du wiki. Les liens internes connexes à un article sont regroupés en fin d'article dans une sous-rubrique Articles connexes de la rubrique Voir aussi. Dans le cas où la rubrique Voir aussi ne présente pas de liens externes, on admet qu'elle soit utilisée pour les articles connexes.
[[Nom de l'article]]
|
Liens externes
Les liens externes sont des hyperliens qui mènent vers d'autres Site Web.
| Syntaxe | Rendu |
|---|---|
|
|
|
|
|
|
|
|
Comment créer une note
Une note ou une référence est une information hors texte à laquelle on accède par renvoi numéroté dans le texte. Il peut s'agir par exemple d'une digression, d'une explication approfondie d'un point s'écartant du sujet de l’article ou de l'indication de la source d'où est extraite l'information.
| Syntaxe | Rendu |
|---|---|
|
|
Faire un appel de note[1]
|
Rassembler des notes ou références
Il est possible de regrouper des notes, notamment les différentes références d'un livre utilisé comme source : on parle de <ref group>, même en combinant des ref name et ref group.
| Syntaxe | Rendu |
|---|---|
|
|
Faire un appel de note au groupe A[A 1]
On peut aussi faire des appels multiples à une même note groupée. Par exemple : faire un appel de note dans un groupe C[C 1]. Puis faire un autre appel de note dans le même groupe [C 2], appel que l'on utilise une seconde fois [C 2], et enfin un autre appel dans le même groupe C[C 3].
|
Liens vers des catégories, des images, ...
Une syntaxe simple au fil du texte telle que [[Catégorie:...]] ou [[Image:...]] catégoriserait la page dans le wiki ou placerait l'image dans cette page. Pour d'autres usages, il est possible de faire un lien interne vers ceux-ci, en plaçant le symbole : avant le nom complet de l'image ou de la catégorie, etc.
| Exemples | Rendus |
|---|---|
|
|
La Catégorie:Modèle de formatage a été réorganisée. |
La notation {{nom du modèle}} induit l'inclusion du modèle dans la page, par exemple le bandeau en haut d'article.
Placer une image
Pour pouvoir placer une image sur le wiki, il faut qu'elle soit préalablement téléchargée sur les serveurs.
Par défaut, l'image se place à droite et ses dimensions dépendent des préférences de l'utilisateur.
Pour insérer une image, il suffit d'écrire :
|
|
Où :
- Nom de l'image doit être remplacé par le nom de l'image (Sakila writer.jpg)
- Alternative textuelle est une brève description de l'image qui la remplacera si elle n'est pas restituée
- Légende est le commentaire de l'image qui sera affiché en-dessous de celle-ci
Options: On peut y ajouter éventuellement des options de dimensions, de placement dans la page comme ceci :
|
|
où 100px est la taille, et left le positionnement (gauche), on utilise center et right respectivement pour centrer ou mettre à droite l'image
|
Placer un modèle
Sur le wiki, ont été créés des modèles dans le but de reproduire la même chose sur plusieurs pages. Pour les utiliser, il faut les inclure dans une page en utilisant cette notation :
{{Nom du modèle}}
|
Cependant, il existe des modèles utilisant des paramètres. Ces derniers s'écrivent de la même manière, mais, il faut ensuite ajouter | après le nom du modèle, pour y insérer le paramètre suivi d'un = et de la valeur que l'on veut donner au paramètre. Si les créateurs du modèle l'ont prévu, plusieurs paramètres peuvent être à la suite, les uns des autres. Si le paramètre est {{{1}}}, alors, il est possible d'écrire directement la valeur du paramètre. Se reporter à la documentation du modèle pour connaître les paramètres, les valeurs autorisées et leurs expressions finales dans les pages.
|
Paramètre unique : |
Pour seulement citer un modèle, il est possible d'écrire [[Modèle:Nom du modèle]] ou d'utiliser la syntaxe {{m|nom du modèle}}
Exemple avec {{sifflote}} qui donnerait l'icône 
.:
[[Modèle:Sifflote]]- Rendu sur la page : Modèle:Sifflote
NB : Pour citer un modèle avec un paramètre nommé, il faut indiquer le signe = entre accolade : {{m|Grossir|Ce texte|facteur{{=}}1.4}}
Les redirections
Une redirection (ou un redirect) est une page renvoyant automatiquement le visiteur sur une autre page. Contenant une redirection, une page de redirection n'est plus visible puisqu'elle renvoie sur la page vers laquelle elle pointe.
Pour créer la redirection, il suffit de placer sur la page qui redirige la syntaxe suivante :
|
|
| Pour rediriger vers une section d'un article, il faut utiliser cette syntaxe :
|
| Il est possible de catégoriser une page de redirection en plaçant la catégorie dans la page de redirection :
|
Cependant, rediriger une page vers un espace de nom différent est déconseillé. En revanche, une redirection vers un autre site n'est pas possible.
Syntaxes complexes
Créer un tableau
| Syntaxe | Rendu | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
| |||||||||||
Modifier le sommaire
Une table des matières sera créée automatiquement dès que l'article comportera au moins quatre titres ou sous-titres de sections. Pour créer les titres et sous-titres de sections, voyez le paragraphe « créer une section » ci-dessus.
Pour les portails ou projets, les pages communautaires ou personnelles (interdit dans les articles!), il est possible de :
- Supprimer le sommaire en inscrivant le code __NOTOC__ en haut de la page.
- Placer le sommaire à un endroit précis avec : __TOC__
- Forcer l'apparition du sommaire à son emplacement habituel en haut de page avec : __FORCETOC__
Les initiales TOC viennent de l'anglais "Table Of Contents" qui veut dire "table des matières".
Mots magiques
Voici les principaux mots magiques (en anglais : magic words) avec leur description. Un mot magique placé dans le code source d'une page est reconnu par le logiciel et déclenche une action au lieu d'afficher son texte. Ils se répartissent en deux groupes :
- les variables ou fonctions de l'analyseur syntaxique (en anglais : parser functions) : elles sont remplacées lors du chargement de la page par un texte variable dépendant du contexte, et elles utilisent la même syntaxe qu'une inclusion de modèle ;
- les codes de changement du comportement : ils n'affichent pas de texte mais modifient l'aspect de la page, et leur syntaxe consiste le plus souvent en un mot tout en capitales encadré par deux tirets bas.
Les tableaux ci-dessous présentent quelques uns de ces mots magiques les plus utiles, la page de référence complète se trouvant sur le site mediawiki.org Help:Magic words
| Mot magique | Description | Exemple de rendu |
|---|---|---|
| Date et heure (le logiciel utilise la date et l'heure d'affichage de la page dans le navigateur du lecteur) | ||
|
|
jour du mois |
18 |
| Noms de pages (Ne s'applique qu'à la page courante. Le nom de page Utilisateur:Stef48/Brouillon est utilisé pour les exemples) | ||
|
|
nom complet de la page (sans l'espace de noms) |
Stef48/Brouillon |
| Dénombrements | ||
|
|
Taille en octets de la source wiki de la page en paramètre. |
Taille de l'accueil 2 024 octets. |
| Autres | ||
|
|
ne pas afficher le sommaire |
|
ParserFunctions
Voici les principales ParserFunctions et leur utilisation :
| Syntaxe | Exemple | Rendu | Analyse |
|---|---|---|---|
|
|
|
chien |
3 est vrai en logique |
|
|
|
différent |
C est différent de B. |
|
|
|
Chat |
La page chien existe. |
|
|
|
deux |
Le paramètre a reçu la valeur 2, ce qui induit le résultat deux. |
|
|
|
4 |
[3:2] = 1,5 ; [1,5 x 6] = 9 ; [9-5] = 4. |
Il existe un moyen lors de l'édition d'une page d'avoir la liste des ParserFunctions :
Les balises <math>
Les formules mathématiques peuvent être écrites avec LATEX. Cette syntaxe est beaucoup plus facile à écrire et à lire que du HTML. Les formules sont présentées en HTML si possible, autrement une image Portable Network Graphics est produite par le serveur. Ce comportement par défaut peut être configuré dans les préférences.
Voir la page d'aide détaillée sur LateX pour plus de détail
Désactivé !!!
Entités HTML
On peut très bien se passer des entités de caractère car on peut directement écrire ou copier-coller les caractères spéciaux sans aucun souci sur le wiki. Cependant, les entités nommées sont parfois plus faciles d’accès que les caractères correspondants, et peuvent être insérées et lues (dans le code source) même si le caractère correspondant est illisible ou inaccessible.
| Syntaxe | Rendu |
|---|---|
| Trémas, accents et autres diacritiques : | |
|
|
À Á Â Ã Ä Å Æ |
|
|
Ç È É Ê Ë Ì Í |
|
|
Î Ï Ñ Ò Ó Ô Õ Œ |
|
|
Ö Ø Ù Ú Û Ü ß |
|
|
à á â ã ä å æ |
|
|
ç è é ê ë ì í |
|
|
î ï ñ ò ó ô õ œ |
|
|
ö ø ù ú û ü ÿ |
| Ponctuations, guillemets : | |
|
|
¿ ¡ § ¶ † ‡ • & |
|
|
« » ’ … — – |
| Caractères spéciaux : | |
|
|
™ © ® ¢ € ¥ £ ¤ espace insécable) |
| Caractères grecs : | |
|
|
Α α Β β Γ γ Δ δ |
|
|
Ε ε Ζ ζ Η η Θ θ |
|
|
Ι ι Κ κ Λ λ Μ μ |
|
|
Ν ν Ξ ξ Ο ο Π π |
|
|
Ρ ρ Σ σ ς Τ τ |
|
|
Υ υ Φ φ Χ χ Ψ ψ |
|
|
Ω ω |
| Caractères mathématiques : | |
|
|
∫ ∑ ∏ √ ± ∞ |
|
|
≈ ∝ ≡ ≠ ≤ ≥ → |
|
|
× · ÷ ∂ ′ ″ ∇ |
|
|
‰ ° ∴ ℵ |
|
|
ø ∈ ∋ ∩ ∪ ⊂ ⊃ ⊆ ⊇ |
|
|
¬ ∧ ∨ ∃ ∀ ⇒ ⇔ |
Voir aussi
- Le bac à sable pour le tests
