Utilisateur:Yodaspirine/Aides et principes/Syntaxe

Retour au sommaire de l'aide

Cette page donne les éléments de syntaxe pour répondre aux besoins courants de la rédaction d'un article.

Syntaxe de base

Didacticiel vidéo apprenant la syntaxe wiki, par Wikimédia France.

Dans le mode Édition, un mémo de la syntaxe est intégré à la barre d'édition(cliquer sur Modifier, et sur le dernier élément de la barre, Aide).

Mettre en forme le texte

Forme du texte

Il est possible de mettre le texte en gras, en italique, etc., 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).

N'oubliez pas d'utiliser le modèle {{lang}} pour indiquer un changement de langue à l'intention des lecteurs d'écrans. Excepté « pour un nom propre, pour un terme technique, pour un mot dont la langue est indéterminée ou pour un mot ou une expression faisant partie du langage courant ».

Syntaxe	Rendu
'''Gras''' ''Italique'' '''''Les deux'''''	Gras Italique Les deux
<span style="color: #FF0000;">Texte</span> ou <span style="color: red;">Texte</span> ou {{Rouge|Texte}} {{droite|Voir aussi [[Aide:couleurs]], la [[:Catégorie:Modèle de couleur de texte|liste des modèles]] et la [[Wikipédia:Limitez l'usage de la couleur dans les articles|recommandation sur l'usage de la couleur dans les articles]].}}	Texte ou Texte ou Texte Voir aussi Aide:couleurs, la liste des modèles et la recommandation sur l'usage de la couleur dans les articles.
<small>Petit</small> <big>Grand</big> <u>Souligné</u> <s>Barré</s>	Petit Grand Souligné Barré
Indice{{ind|2}} Exposant{{exp|3}} <center>ou</center> Indice<sub>2</sub> Exposant<sup>3</sup>	Indice2 Exposant3 ou Indice2 Exposant3
Pour les balises mathématiques, voir Aide:Formules TeX. Pour mettre en forme correctement les nombres avec leurs unités, voir {{Unité}}.

Position du texte

Syntaxe	Rendu
Positionnement du texte
<center>Texte</center> {{droite|et à droite ?}}	Texte et à droite ?
Masquer le texte
{{boîte déroulante | titre = Titre | contenu = Texte }}	Syntaxe à éviter dans les articles. Aide:Boîte déroulante et autres modèles déroulants. Rendu du code : Titre Texte
Plusieurs colonnes
{{colonnes|nombre=3| * premier * second * troisième * quatrième * cinquième * sixième }}	3 ou 4 colonnes sont généralement un maximum dans les articles afin de tenir compte des petits écrans. Rendu du code : premier second troisième quatrième cinquième sixième NB : Ne fonctionne pas sous le navigateur Microsoft Internet Explorer.

Créer un lien interne

Les liens internes sont les liens qui pointent vers un autre article de Wikipédia.

[[Nom de l'article]]

Il est aussi possible de faire un lien interne à l'article (lien ancré) en utilisant un titre de section avec la syntaxe [[#nom de la section]] ou vers une section d'un autre article de Wikipédia avec la syntaxe.

[[Article#section de l'article|Texte affiché]]

Créer un lien externe

Les liens externes sont des hyperliens qui mènent vers d'autres sites web que Wikipédia. Cependant, tous les hyperliens ne sont pas autorisés. Les liens vers Facebook, Twitter (ou tout autre réseau social), un forum, un blog personnel, des sites d'hébergement de vidéos (Youtube...) ou une adresse mail sont très fortement déconseillés sur Wikipédia, en raison de leur caractère généralement non-encyclopédique.

Syntaxe	Rendu
[http://www.wikimedia.fr Association Wikimédia France]	Association Wikimédia France

Les deux syntaxes ci-après sont déconseillées dans les articles, car moins esthétiques et moins accessibles (pour les lectures en mode texte)

Syntaxe	Rendu
http://www.wikimedia.fr	http://www.wikimedia.fr
[http://www.wikimedia.fr]	[1]

Créer un titre de section

Le niveau 1 (= Titre =) est interdit dans les articles, car il est réservé au titre de la page.

• Titre de niveau 2 :
  • Exemple: == Titre ==
  • Rendu: Titre
• Titre de niveau 3 :
  • Exemple: === Titre ===
  • Rendu: Titre
• Titre de niveau 4 :
  • Exemple: ==== Titre ====
  • Rendu: Titre
• Titre de niveau 5 :
  • Exemple: ===== Titre =====
  • Rendu: Titre

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.

Placer une catégorie

Placer une image

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	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 infobox et 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 <br /> un retour à la ligne.	Cette balise permet de faire un retour à la ligne.

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>	La balise poem permet le saut à la ligne sans balise br

Voir aussi {{Clr}} pour sauter les blocs flottants.

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
* Élément * Autre élément ** Sous-élément * Élément final	Élément Autre élément Sous-élément Élément final
Liste numérotée
# Élément 1 # Élément 2 ## Sous-élément 1 # Élément 3	Élément 1 Élément 2 Sous-élément 1 Élément 3
Il est possible de faire une liste en combinant les deux symboles
# Titre I #* Sous-titre A #* Sous-titre B # Titre II	Titre I Sous-titre A Sous-titre B Titre II
Liste de définitions Bonne pratique : ne pas oublier les « : » dans les listes de définitions sinon elles ne sont pas accessibles
; terme à définir : définition ; autre terme : définition plus complète : sur une ou plusieurs lignes	terme à définir définition autre terme définition plus complète sur une ou plusieurs lignes

Abréviations

La signification d'une abréviation peut être indiquée :

• En faisant un lien vers l'article correspondant, si son titre explicite l'abréviation. Par exemple, comme l'article Société nationale des chemins de fer français existe, il est possible faire un lien [[Société nationale des chemins de fer français|SNCF]] qui donnera SNCF où la signification de l'abréviation est accessible en survolant le lien.
• Ou en utilisant l'un des modèles {{abréviation}} ou {{abréviation discrète}} : {{abréviation|SNCF|Société nationale des chemins de fer français}} donnera SNCF où la signification de l'abréviation est accessible en survolant le sigle.

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<ref>Texte de la note</ref>	Faire un appel de note
Il est possible d'appeler la même note<ref name="nom de la ref">Texte de la note nommée</ref> en plusieurs endroits différents comme ceci<ref name="nom de la ref" />	Il est possible d'appeler la même note en plusieurs endroits différents comme ceci
{{références}} ou bien <references />

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<ref group="A">Texte de la note</ref>	Faire un appel de note au groupe A
Puis en faire une autre<ref group="A">Texte de la note</ref> et enfin un autre groupe<ref group="B">Texte de la note</ref>.	Puis en faire une autre et enfin un autre groupe.
On peut aussi faire des appels multiples à une même note groupée. Par exemple : faire un appel de note dans un groupe C<ref group="C">Texte de la note C1</ref>. Puis faire un autre appel de note dans le même groupe <ref group="C" name="2_occ">Texte de la note C2</ref>, appel que l'on utilise une seconde fois <ref group="C" name="2_occ" />, et enfin un autre appel dans le même groupe C<ref group="C">Texte de la note C3</ref>.	On peut aussi faire des appels multiples à une même note groupée. Par exemple : faire un appel de note dans un groupe C. Puis faire un autre appel de note dans le même groupe , appel que l'on utilise une seconde fois , et enfin un autre appel dans le même groupe C.
A <references group="A"/> B <references group="B"/> C <references group="C"/>	A B C

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 Wikipédia 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:Cinéma]] a été réorganisée. J'ai réduit en vignette l'[[:image:Train.jpg]]. Merci de relire la traduction de la page [[:en:Help:Editing]] !	La Catégorie:Cinéma a été réorganisée. J'ai réduit en vignette l'image:Train.jpg. Merci de relire la traduction de la page en:Help:Editing !

Il existe deux méthodes pour citer un modèle (par exemple, le modèle démographie) et insérer un lien vers sa page :

• Citer simplement sa page [[Modèle:démographie]] → Modèle:démographie
• Utiliser la syntaxe {{m|démographie}} → {{démographie}}

La notation {{nom du modèle}} induit l'inclusion du modèle dans la page, par exemple le bandeau {{ébauche}} en début d'article.

Placer un modèle

Les liens interlangues

Les dates

Cette aide définit les règles de nommage pour les dates. Ces règles de nommage concernent aussi bien les années, les décennies, les siècles que les millénaires, que ce soit avant ou après l'an 1.

Pour le modèle fondé sur le s, l'usage du suffixe « - » désactive la génération du lien.

Syntaxe	Rendu
[[-332]] {{s|III|e}} ou {{IIIe siècle}} {{s-|III|e}} {{-s|III|e}} {{-s-|III|e}} {{Ier millénaire}} {{Date||janvier|2008}} {{Date|1|janvier|2008}} {{Date|1|janvier|2008|en musique}}	-332 IIIe siècle ou IIIe siècle IIIe siècle IIIe siècle av. J.-C. IIIe siècle av. J.-C. Ier millénaire janvier 2008 1er janvier 2008 1er janvier 2008
Voir la liste des modèles

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 :

#REDIRECTION [[Article vers lequel la redirection pointe]]

Commentaire invisible

Un commentaire est une fraction de texte qui n'est pas visible lors de l'affichage de la page ; mais il reste dans le texte source, et est donc visible en mode édition. Le but est de laisser une information ou une trace sur l'édition pour les éditeurs suivants (y compris soi-même). Il ne s'agit pas là de discuter du contenu de la page, ce qui doit être fait sur la page de discussion, mais uniquement de commenter l'édition proprement dite.

Question syntaxe, un commentaire est placé entre les balises spéciales <!-- et -->.

<!-- Ceci est un exemple de commentaire invisible à l'affichage. -->

Ce qui donne :

Syntaxes complexes

Créer un tableau

Créer un organigramme ou un arbre généalogique

Différents modèles permettent de créer des organigrammes ou des arbres généalogiques. Lorsqu'il convient au type d'arbre souhaité, l'usage du modèle {{Arbre début}} est recommandé.

Liens vers les autres projets

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 section. Pour créer les titres et sous-titres de section, voyez la partie « Créer une section » ci-avant.

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 ».

Modèles pour les sommaires

Il est également possible de positionner le sommaire à droite en utilisant le modèle {{Sommaire à droite}}, ou encore de modifier sa forme grâce au modèle {{Sommaire alphabétique}} (pour d’autres modèles, voir la liste).

Mots magiques

ParserFunctions

Voici les principales ParserFunctions et leur utilisation :

Syntaxe	Exemple	Rendu	Analyse
{{ #if: <vrai> | <alors> | <sinon> }}	{{ #if: 3 | chien | chat }}	chien	3 est vrai en logique.
{{ #ifeq: <texte à comparer 1> | <texte à comparer 2> | <si égal> | <si différent> }}	{{ #ifeq: C | B | égal | différent }}	différent	C est différent de B.
{{ #ifexist: <nom de la page> | <si la page existe> | <si la page n'existe pas> }}	{{ #ifexist: Chien | Chien | Chat }}	Chien	La page chien existe.
{{ #switch: <valeur du paramètre> | <valeur1> = <résulat1> | <valeur2> = <résultat2> | #default = <résultat par défaut> }}	{{ #switch: {{{parametre|2}}} | 1 = un | 2 = deux | #default = trois }}	deux	Le paramètre a reçu la valeur 2, ce qui induit le résultat deux.
{{ #expr: expression }}	{{ #expr: 3/2*6-5 }}	4	[3 ÷ 2] = 1,5 ; [1,5 × 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>

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 PNG est produite par le serveur. Ce comportement par défaut peut être configuré dans les préférences.

Pour des raisons d'accessibilité des pages aux mal-voyants et de lisibilité, il est recommandé d'utiliser, dans le texte, une syntaxe TeX qui ne génère pas d'image PNG, et de réserver la syntaxe plus élaborée aux formules hors texte.

Caractères spéciaux et entités HTML

Les nombres

Voir aussi les conventions concernant les nombres.

Via le modèle {{Unité}}, les nombres et leur(s) unité(s) sont automatiquement mis en forme selon la syntaxe suivante :

Syntaxe	Rendu
''G'' = {{Unité|6,674.28{{x10|-8}}|cm|3|g|-1|s|-2}} La [[vitesse de la lumière]] est {{unité|299792458|m/s}}	G = 6 674,28 × 10−8 cm3 g−1 s−2 La vitesse de la lumière est 299 792 458 m/s

Il est aussi possible d'écrire les nombres avec la syntaxe suivante :

Syntaxe	Rendu
1,57×10{{exp|-6}} cm ou 2,447{{x10|-15}}	1,57×10-6 cm ou 2,447 × 10-15
Attention dans {{formatnum:}} à l'utilisation du point « . » comme séparateur décimal et à l'usage de la virgule « , »
{{formatnum:1234567.70985}} {{formatnum:-987654.321}} Valeur de [[Pi|π]] : {{formatnum:3.141,592,653,589,79}}…	1 234 567,70985 −987 654,321 Valeur de π : 3,141,592,653,589,79…
Le {{nobr|15 000{{e}} visiteur}} Le {{n°}}8 La {{1re}} de la classe Le {{1er}}, {{2e}}, le {{3e}}, le {{4e}} de la liste	Le 15 000e visiteur Le no 8 La 1re de la classe Le 1er, 2e, le 3e, le 4e de la liste