Aide:Syntaxe

Ébauche

Cet article est une ébauche concernant Syntaxe. Vous pouvez partager vos connaissances en l’améliorant.

Cette page détaille la syntaxe usuelle pour la rédaction d'un article sur la GBT.

Créer une section

Voici comment créer des sections :

• Intertitre de niveau 1 :

== Intertitre ==

• Intertitre de niveau 2 :

=== Intertitre ===

• Intertitre de niveau 3 :

==== Intertitre ====

• Intertitre de niveau 4 :

===== Intertitre =====

• Intertitre de niveau 5 :

====== Intertitre ======

L’intertitre à signes égal simples (= Titre =) est interdit dans les articles, car il est réservé au titre principal de la page.

Par convention, les intertitres de section ne doivent être ni en gras ni en italique ni soulignés.

Le sommaire sera créé automatiquement dès que quatre intertitres de section seront présents.

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 modèles et des légendes d'images, car le texte doit occuper le moins d'espace possible. Elle est fortement déconseillée dans les articles. 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 /> ou <br/>.

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.

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

Syntaxe	Rendu
'''Gras''' ''Italique'' '''''Les deux'''''	Gras Italique Les deux
<span style="color: #FF0000;">Texte</span> ou <span style="color: red;">Texte</span>	Texte ou Texte
<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

Position du texte

Syntaxe	Rendu
Positionnement du texte
<center>Texte</center> {{droite|et à droite ?}}	Texte et à droite ?

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 noms : il est indifférent du point de vue technique d'écrire dans les liens [[Catégorie:Bibliothèque]], [[catégorie:Bibliothèque]], [[Catégorie:bibliothèque]], etc. ; mais écrire [[tamriel]] donnera tamriel et non Tamriel.

Liens internes

Les liens internes sont les liens qui pointent vers un autre article de la GBT.

[[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 la GBT avec la syntaxe suivante :

[[Nom de l'article#Nom de la section]]

Pour faire apparaître un texte quelconque à la place du titre du lien, on peut utiliser la barre verticale (pipe) (|).

[[Tamriel|texte à faire apparaître]]

texte à faire apparaître

Liens externes

Les liens externes sont des hyperliens qui mènent vers d'autres sites web que la GBT. Ils sont rarement utilisés sur la GBT ; essentiellement pour citer l'origine d'un texte hors-jeu.

Syntaxe	Rendu
[http://www.imperial-library.info/ The Imperial Library]	The Imperial Library
http://www.imperial-library.info/	http://www.imperial-library.info/
[http://www.imperial-library.info/]	[1]

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, des modèles…

Une syntaxe simple au fil du texte telle que [[Catégorie:…]] ou [[Image:…]] catégoriserait la page dans la GBT 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:Bibliothèque]] a été réorganisée. J'ai réduit en vignette l'[[:image:Dragon2.jpg]].	La Catégorie:Bibliothèque a été réorganisée. J'ai réduit en vignette l'image:Dragon2.jpg.

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

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

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.

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
; 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

Placer une catégorie

Chaque article de la GBT devrait être classé selon son sujet dans une ou plusieurs catégories. Ainsi, il est facile de le retrouver parmi les autres articles du même thème.

Pour ce faire, il suffit d'écrire :

[[Catégorie:Nom de la Catégorie]]

Pour trouver la ou les bonnes catégories, il faut partir de catégories vastes, telles que Catégorie:Sciences ou Catégorie:Géographie, pour pouvoir, à travers des sous-catégories, trouver celle(s) qui convien(nen)t.

Placer une image

Pour pouvoir placer une image sur la GBT, 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 :

[[Image:Nom de l'image|thumb|alt=Texte alternatif|Légende]]

Où :

• Nom de l'image doit être remplacé par le nom de l'image (Dragon2.jpg).
• Texte alternatif 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 placement dans la page comme ceci :

[[Image:Nom de l'image|thumb|left|alt=Texte alternatif|Légende]]

Où left est le positionnement à gauche. On utilisera center pour centrer (il est inutile de préciser le positionnement à droite : c'est celui par défaut, qui s'appliquera en l’absence d’autre indication).

Placer un modèle

Les modèles ont été créés pour permettre 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}}

On rencontre fréquemment des modèles s'écrivant de cette manière simple : {{Homonymie}} ; {{à sourcer}} ; {{article incomplet}}.

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 : {{Nom du modèle | valeur du paramètre}} Paramètres multiples non nommés : {{Nom du modèle | Valeur1 | Valeur2 | …}} Paramètres multiples nommés : {{Nom du modèle | Paramètre1 = Valeur1 | Paramètre2 = Valeur2 | …}}

Exemples

Code	Rendu
{{Avancement|85}}
{{Homonymie}}	Cette page d’homonymie répertorie les différents sujets et articles partageant un même nom.
Article relu le {{Date|22|février|2008}}.	Article relu le Modèle:Date.
{{boîte déroulante|titre=Modèles destinés aux copies multiples|contenu={{Avertissement|Une page ou partie de page peut être incluse dans une autre sans création d'un modèle.}}}}	Modèles destinés aux copies multiples Modèle:Avertissement

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

Code :

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

Rendu :

Texte ici. Texte là.