Aide:Syntaxe
Le wikitexte ou wikicode est un langage de balisage léger qui définit la mise en forme d'une page wiki. Cette page apporte une aide aux contributeurs débutants. Pour vous familiariser avec le système de modification d'articles des Archives de Vault-Tec, vous pouvez utiliser votre de page de brouillon.
Syntaxe de base
Créer une rubrique
On crée une rubrique en entourant un texte avec le symbole =
.
== Rubrique de niveau 1 == === Rubrique de niveau 2 === ==== Rubrique de niveau 3 ==== ===== Rubrique de niveau 4 ===== ====== Rubrique de niveau 5 ======
Il est interdit d'utiliser la rubrique = Rubrique =
car elle est réservée au titre principal de la page.
Par convention, les rubriques ne doivent être ni en gras, ni en italique, ni soulignées. L'italique est acceptée pour les titres d'œuvres écrites ou artistiques, les revues, journaux et périodiques.
Créer un sommaire
Le sommaire sera créé automatiquement dès que quatre rubriques seront présentes. Pour les opérations plus complexes sur les sommaires voyez la rubrique « Modifier le sommaire » ci-après.
Faire une retour à la ligne
Un saut à la ligne ne suffit pas à créer un nouveau paragraphe. 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 |
La balise <br/>
, <br />
ou <br>
permet de faire un retour à la ligne avec un espace simple entre deux lignes. Elle sert souvent à séparer deux contenus dans les tables ou les modèles, comme les {{infobox}}. Mais son utilisation est interdite dans les articles.
Syntaxe | Rendu |
---|---|
Cette phrase est coupée grâce <br/> à cette balise. |
Cette phrase est coupée grâce |
Il est possible de sauter les blocs flottants en utilisant le modèle {{Clear}}.
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 :
[[Sauve l'Initié du Centre.]]
donnant Sauve l'Initié du Centre. ;[[sauve l'Initié du Centre.]]
donnant sauve l'Initié du Centre..
En revanche, le restes des lettres doivent être exactes :
[[Sauve l’Initié du Centre.]]
donnant Sauve l’Initié du Centre. ;[[Sauve l'initié du Centre.]]
donnant Sauve l'initié du Centre..
Liens internes
Les liens internes sont des wikiliens dont la destination est une autre page des Archives de Vault-Tec. Les wikiliens verts permettent d'accéder à une page qui existe, et les wikiliens rouges vers un article qui n'existe pas.
[[Nom de l'article]]
Il est possible de faire un lien interne à l'article (lien ancré) en utilisant le titre d'une rubrique avec la syntaxe [[#Nom de la rubrique]]
. S'il faut rediriger vers la rubrique d'un article, la syntaxe est la suivante :
[[Nom de l'article#Nom de la rubrique]]
Pour faire apparaître un texte quelconque à la place du titre du lien, on peut utiliser la barre verticale (pipe) (|).
Syntaxe | Rendu |
---|---|
[[Accueil|texte à faire apparaître]] |
Liens externes
Les liens externes sont des hyperliens qui mènent vers d'autres sites web que les Archives de Vault-Tec. Il est autorisé d'ajouter des liens externes au wiki que s'il s'agit d'articles de Wikipédia. S'il est pertinent d'ajouter un lien vers un autre site web alors ce lien doit se trouver dans la rubrique Voir aussi, avant la liste des palettes.
Un lien externe se présente comme ceci :
Syntaxe | Rendu |
---|---|
[https://fallout-generation.com Fallout Génération] |
|
https://fallout-generation.com |
|
[https://fallout-generation.com] |
Si le lien externe dirige vers un site web écrit en anglais, alors on peut le préciser en utilisant le modèle {{en}} :
Syntaxe | Rendu |
---|---|
{{en}} [https://www.nma-fallout.com nma-fallout.com] |
(en) nma-fallout.com |
Comment créer une référence
Une référence est une information hors texte à laquelle on accède par renvoi numéroté dans le texte. Elle permet de prouver une information en citant un dialogue présent dans un jeu, un guide, une interview, etc. Toutes les références doivent rassemblées dans la rubrique Références, au dessus de la rubrique Voir aussi.
Syntaxe | Rendu |
---|---|
Faire un appel de note<ref>Texte de la note.</ref>. |
Faire un appel de note[1]. |
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[2] en plusieurs endroits différents comme ceci[2]. |
{{Références}} ou bien <references /> |
Rassembler des références
Il est possible de regrouper des références en utilisant l'attribut group
. Et il est possible de combiner cet attribut avec l'attribut name
.
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[A 1]. |
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>. |
|
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[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]. |
<references group="A"/>
<references group="B"/>
<references group="C"/> |
|
Une bonne pratique consiste à regrouper les références en fonction de leur nature :
- Dialogues ;
- Guides ;
- Forums ;
- etc.
Voir la page d'aide Référence pour en savoir plus.
Liens vers des catégories, des images, des modèles…
Si on souhaite créer un lien vers une catégorie mais en utilisant la syntaxe [[Catégorie:Nom de la catégorie]]
, alors on ne ferait que catégoriser la page. De même en utilisant la syntaxe [[Fichier:Nom de l'image]]
pour créer un lien vers un fichier, ça ne ferait qu'afficher l'image dans la page. Pour éviter ces comportements, il faut placer le symbole :
devant le nom complet de la page.
Exemples | Rendus |
---|---|
La [[:Catégorie:Quêtes de Fallout]] est complète. J'ai réduit en vignette le [[:Fichier:Fnv Cazador.png]]. Merci de relire la traduction de la page [[:Aide:Référence]] ! |
La Catégorie:Quêtes de Fallout est complète. J'ai réduit en vignette le Fichier:Fnv Cazador.png. Merci de relire la traduction de la page Aide:Référence ! |
On peut également utiliser cette méthode pour citer un modèle. Mais il est préférable d'utiliser la syntaxe {{m|Nom du modèle}}
.
Générer une liste
Il est possible de générer une liste non ordonnée avec le symbole *
. Et pour une liste ordonnée, ce sera avec le symbole #
.
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 |
|
Liste numérotée | |
# É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 |
|
; terme à définir : définition ; autre terme : première définition de l’autre terme : seconde définition de l’autre terme |
|
Mettre en forme le texte
Il est possible de mettre en forme le texte différemment. Mais notez bien qu'il est fortement déconseillé d'abuser de la mise en forme. Le gras est utilisé pour l'emphase du titre de la page. L'italique est utilisé pour les citations dans une langue étrangère, les titres d'œuvres écrites ou artistiques, les revues, journaux et périodiques. Changer la couleur du texte est surtout utilisé dans les modèles, il est déconseillé de la changer pour ne pas gêner la lecture de l'article.
Syntaxe | Rendu |
---|---|
'''Gras''' ''Italique'' '''''Gras et italique''''' |
Gras Italique Gras et italique |
{{Couleur|Texte}} {{Couleur|red|Texte}} <span style="color: #FF0000;">Texte</span> <span style="color: red;">Texte</span> |
texte ? Texte Texte Texte |
{{Petit|Pour écrire petit}} {{Grand|Pour écrire grand}} |
Pour écrire petit Pour écrire grand |
Exposant{{exp|3}} Indice<sub>2</sub> Exposant<sup>3</sup> |
Exposant3 Indice2 Exposant3 |
Position du texte
Syntaxe | Rendu |
---|---|
{{Boîte déroulante | titre = Titre | contenu = Texte }} |
Les boîtes déroulantes ne doivent pas êtres utilisées dans les articles Rendu du code : Titre Texte |
{{colonnes|2| * premier * deuxième * troisième * quatrième * cinquième * sixième }} |
Il faut éviter de faire plus de 3 colonnes sinon le texte sera fortement compressé sur les petits écrans, comme les mobiles. Deux colonnes est un bon compromis. Rendu du code :
|
Placer une catégorie
Tous les articles des Archives de Vault-Tec doivent être classés dans au moins une catégorie. Il est ainsi plus facile de la retrouver parmi les autres articles d'un même thème.
Pour trouver la bonne catégorie, il peut être pratique de voir la liste des catégories d'une autre page du même thème. On peut aussi partir de la catégorie principale d'un jeu, comme par exemple Catégorie:Fallout 3, puis descendre dans les sous-catégories.
Pour ajouter un article dans une catégorie, on utilise la syntaxe suivante :
[[Catégorie:Nom de la catégorie]]
La bonne pratique consiste à ajouter toutes les catégories en bas du wikicode de l'article, en dessous des palettes.
Clé de tri
Dans une catégorie, les articles sont rangés dans des groupes correspondant à la première lettre du nom de l'article. Mais le premier mot d'un article n'est pas toujours pertinent pour classer un article. On peut donc modifier la clé de tri pour forcer un article à se ranger dans un groupe particulier en utilisant la syntaxe suivante :
[[Catégorie:Nom de la catégorie|clé de tri]]
Par exemple, le magazine Le chirurgien du Massachusetts est classé dans le groupe L de la catégorie Catégorie:Magazines de Fallout 4. Mais si on souhaite le classer dans C, on peut écrire [[Catégorie:Magazines de Fallout 4|Chirurgien du Massachusetts (Fallout 4), le]]
.
Placer une image
Avant de pouvoir placer une image sur les Archives de Vault-Tec, il faut d'abord l'importe sur le serveur.
Pour insérer une image, il suffit d'écrire :
[[Fichier:Nom de l'image|vignette|upright|alt=Texte alternatif|Légende]]
Où :
Nom de l'image
est le nom du fichier.upright
est la taille de l'image, par défaut à 1 par rapport aux préférences de l'utilisateur. Écrireupright=0.5
permet de diminuer ses dimensions de moitié.Texte alternatif
est le texte à afficher si l'image n'est pas chargée.Légende
est un commentaire qui sera placé sous l'image.
Placer un modèle
Un modèle est un élément paramétrable ou non qui permet de reproduire la même mise en page sur plusieurs pages. On les inclue dans un article en utilisant cette syntaxe :
{{Nom du modèle}}
Les modèles sont présents sur toutes les pages de contenu car elles permettent de les structurer. Certains n'ont pas besoin de paramètres mais la majorité en nécessite. On ajoute des paramètres en les séparant la barre verticale (|). Un paramètre peut être nommé, on utilise donc le symbole =
pour séparer la valeur du nom de son paramètre.
- Paramètre unique :
{{Nom du modèle | valeur du paramètre}}
- Paramètres multiples :
{{Nom du modèle | Valeur1 | Valeur2 | …}}
- Paramètres multiples nommés :
{{Nom du modèle | Paramètre1 = Valeur1 | Paramètre2 = Valeur2 | …}}
Exemples :
Code | Rendu |
---|---|
|
|
|
|
|
|
{{Boîte déroulante |titre = Liste de personnages |contenu = {{Colonnes|2| * Aradesh * Caesar * Lanius * Richard Moreau * Tandi }} }} |
Liste de personnages
|
Pour citer un modèle, on utilisera la syntaxe {{m|Nom du modèle}}
. S'il faut ajouter des paramètres nommés, il faut indiquer le signe =
. La syntaxe {{m|Interactions|mort{{=}}oui}}
donne {{Interactions|mort=oui}}.
Les redirections
Une redirection est une page renvoyant automatiquement le lecteur 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.
#REDIRECTION [[Article vers lequel la redirection pointe]]
Il est utile d'utiliser des redirections pour des termes qui parlent de la même chose. La série Fallout étant passée entre plusieurs équipes de traduction, il arrive que des sujets soient nommés différemment. On utilise donc les redirections pour qu'un lecteur puisse chercher le nom d'un sujet dans toutes les traductions possibles.
Commentaire invisible
Un commentaire est un fragment de texte visible uniquement dans le wikicode d'un article. Il ne s'affichera pas dans l'article. Le but est de laisser une information dans l'éditeur. Les commentaires ne doivent pas être utilisés pour discuter entre contributeur.
Pour placer un texte en commentaire, il suffit de le placer entre les balises <!--
et <!---->
Code | Rendu |
---|---|
Du texte ici<!-- Ce commentaire ne sera pas visible sur l'article. --> et là. |
Du texte ici et là. |
Syntaxe complexe
Créer un tableau
Leur facilité à structurer des informations fait que les tableaux sont souvent utilisés à tort. Mais elles s'adaptent mal aux différentes tailles d'écran et déforment rapidement le texte. Ils sont donc fortement déconseillés. Ils ne doivent être employés que pour représenter des données tabulaires.
Pour formater le tableau au thème des Archives de Vault-Tec, il faut ajouter la classe va-table
.
Syntaxe | Rendu | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
{| class="va-table" style="width:80%;" |+ Tableau |- ! scope=col | Colonne 1 ! scope=col | Colonne 2 ! scope=col | Colonne 3 |- | style="width:33%;" | Contenu 1 | style="width:34%;" | Contenu 2 | style="width:33%;" rowspan="2" | Contenu 5 |- | style="width:33%;" | Contenu 3 | style="width:34%;" | Contenu 4 |- | style="text-align:center;" colspan="3" | Ligne 1 |} |
|
Modifier le sommaire
La table des matières est automatiquement lorsqu'au moins quatre rubriques sont présentes sur l'article. Mais il est possible de modifier son comportement.
- Écrire
__NOTOC__
en début de page permet de supprimer le sommaire. - Écrire
__TOC__
ajoute le sommaire à l'endroit précis où ce code a été ajouté. - Pour forcer l'apparition du sommaire à son endroit habituel, on peut utiliser
__FORCETOC__
.
Il n'est pas conseillé de modifier le comportement du sommaire pour le contenu général. Ces mots sont souvent utilisés pour les portails et certaines pages spécifiques.
Mots magiques
Un mot magique est un mot-clé reconnu par le moteur MediaWiki qui l'interprète comme une fonction.
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 |
19 |
Noms de page (ne s'applique qu'à la page courante ; le nom de page Utilisateur:Kharmitch/Brouillon est utilisé pour les exemples) | ||
|
nom complet de la page (sans l'espace de noms) |
Kharmitch/Brouillon |
Dénombrements | ||
|
Taille en octets de la source wiki de la page en paramètre. Nombre de pages de la catégorie en paramètre. |
Taille de l'accueil 7 808 octets. 0 pages dans la catégorie Quêtes de Fallout. |
Autres | ||
|
Ne pas afficher le sommaire Afficher le sommaire ici Cacher cette catégorie dans les articles (à placer dans une catégorie) |
ParserFunctions
L'extension ParserFunctions ajoute des fonctions d'analyse. Ceci permet de créer des expressions logiques. Le tableau ci-dessous en présente quelques-unes.
Syntaxe | Exemple | Rendu | Analyse |
---|---|---|---|
{{ #if: <vrai> | <alors> | <sinon> }} |
{{ #if: 3 | RNC | Légion }} |
RNC |
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: RNC | RNC | Légion }} |
RNC |
La page RNC 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 |
Les balises
Les balises se présentent sous la forme <début du bloc> wikicode </fin du bloc>
et permettent de formater le texte ou de déclencher des fonctions spéciales.
Afficher le wikicode en lecture - empêcher l'interprétation MediaWiki
Il existe des balises qui empêchent le moteur MediaWiki d'interpréter du wikicode.
- Les balises
<nowiki></nowiki>
empêchent l'interprétation. - Les balises
<pre></pre>
empêchent l'interprétation tout en formatant le texte dans un cadre et une police adaptée à la lecture du code. - Les doubles balises
<code><nowiki>texte</nowiki></code>
empêchent l'interprétation avec un rendu proche des balises<pre></pre>
.
Syntaxe | Rendu |
---|---|
[[RNC]] | RNC |
<nowiki>[[RNC]]</nowiki> | [[RNC]] |
<pre>[[RNC]]</pre> | [[RNC]] |
<code><nowiki>[[RNC]]</nowiki></code> | [[RNC]]
|
<code>texte</code> | texte
|
<pre style="white-space:pre-wrap;">[[RNC]]</pre> | [[RNC]] |
Afficher du code source avec une coloration syntaxique
Les balises <syntaxhighlight></syntaxhighlight>
ont la capacité de formater du code source.
Syntaxe | Rendu |
---|---|
<syntaxhighlight lang="rust"> // Function that returns a boolean value fn is_divisible_by(lhs: u32, rhs: u32) -> bool { if rhs == 0 { return false; } // Une expression ne nécessite pas le mot-clé // 'return' pour retourner une valeur lhs % rhs == 0 } </syntaxhighlight> |
// Fonction retournant un booléen
fn is_divisible_by(lhs: u32, rhs: u32) -> bool {
if rhs == 0 {
return false;
}
// Une expression ne nécessite pas le mot-clé
// 'return' pour retourner une valeur
lhs % rhs == 0
}
|
Écrire une formule mathématique
Il est possible de formater proprement une formule mathématique en utilsant les balises <math> ... </math>
associées à du code LaTex. La page d'aide Aide:Formules TeX de Wikipédia présente rapidement ce langage.
Exemple :
<math> x = a_0 + \frac{1}{a_1 + \frac{1}{a_2 + y^2}} </math>
donne le résultat suivant :
Inclusion
L'inclusion, ou la transclusion, permet de charger le contenu d'une page dans une autre page. Elle se fait facilement avec la syntaxe {{Nom de la page}}
, mais il n'est pas conseillé de l'utiliser directement car elle charge tout le contenu d'une page. Il est préférable d'utiliser le modèle {{Extrait}} car il permet de sélectionner une section ou une rubrique précise.
Il est possible de faire une inclusion sélective :
- Les balises
<onlyinclude>contenu à inclure</onlyinclude>
permettent d'inclure le contenu entre balises de la future inclusion. - Les balises
<noinclude>contenu à exclure</noinclude>
permettent d'exclure un contenu entre balises de la future inclusion.