Aide:Syntaxe

Aide des Archives de Vault-Tec › 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 modifier

Créer une rubrique modifier

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 modifier

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 modifier

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 à cette balise.

Il est possible de sauter les blocs flottants en utilisant le modèle {{Clear}}.

Créer un lien modifier

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 modifier

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]]	texte à faire apparaître

Liens externes modifier

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]	Association Wikimédia France
https://fallout-generation.com	https://fallout-generation.com
[https://fallout-generation.com]	[1]

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 modifier

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

↑ Texte de la note.
↑ ^2,0 et ^2,1 Texte de la note nommée.

Rassembler des références modifier

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>.	Puis en faire une autre^{[A 2]} et enfin un autre groupe^{[B 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<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]}.
A <references group="A"/> B <references group="B"/> C <references group="C"/>	A ↑ Texte de la note. ↑ Texte de la note. B ↑ Texte de la note. C ↑ Texte de la note C1. ↑ ^2,0 et ^2,1 Texte de la note C2. ↑ Texte de la note C3.

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… modifier

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 modifier

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	É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
; terme à définir : définition ; autre terme : première définition de l’autre terme : seconde définition de l’autre terme	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 modifier

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>	Exposant³ Indice₂ Exposant³

Position du texte modifier

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 :

{{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 :

premier
deuxième
troisième
quatrième
cinquième
sixième

Placer une catégorie modifier

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 modifier

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 modifier

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. Écrire upright=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 modifier

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
`{{FNVCS}}`	Les informations suivantes se basent sur le contenu inutilisé de Fallout: New Vegas et n'ont pas été confirmées par des sources officielles.
`{{FNVCS\|fin}}`	Fin des informations basées sur le contenu inutilisé de Fallout: New Vegas.
`Un {{Wikipédia\|Scepticisme scientifique\|lien vers Wikipédia}}.`	Un lien vers Wikipédia.
{{Boîte déroulante \|titre = Liste de personnages \|contenu = {{Colonnes\|2\| * Aradesh * Caesar * Lanius * Richard Moreau * Tandi }} }}	Liste de personnages Aradesh Caesar Lanius Richard Moreau Tandi

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 modifier

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 modifier

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 

Code	Rendu
Du texte ici<!-- Ce commentaire ne sera pas visible sur l'article. --> et là.	Du texte ici et là.

Syntaxe complexe modifier

Créer un tableau modifier

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

Tableau
Colonne 1	Colonne 2	Colonne 3
Contenu 1	Contenu 2	Contenu 5
Contenu 3	Contenu 4	Contenu 5
Ligne 1

Modifier le sommaire modifier

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 modifier

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)
`{{CURRENTDAY}}` `{{CURRENTDAYNAME}}` `{{CURRENTMONTH}}` `{{CURRENTMONTHNAME}}` `{{CURRENTWEEK}}` `{{CURRENTYEAR}}` `{{CURRENTTIME}}` `{{CURRENTHOUR}}`	jour du mois nom du jour numéro du mois nom du mois numéro de la semaine année heure avec les minutes heure sur deux chiffres	25 jeudi 04 avril 17 2024 03:38 03
Noms de page (ne s'applique qu'à la page courante ; le nom de page Utilisateur:Kharmitch/Brouillon est utilisé pour les exemples)
`{{PAGENAME}}` `{{SUBPAGENAME}}` `{{BASEPAGENAME}}` `{{NAMESPACE}}` `{{FULLPAGENAME}}` `{{TALKPAGENAME}}`	nom complet de la page (sans l'espace de noms) partie distinctive de la sous-page (appelée aussi sous-page) nom de la page de base (sans éventuelles sous-pages) espace de noms de la page nom complet de la page (avec l'espace de noms) nom de la page de discussion associée	Kharmitch/Brouillon Brouillon Kharmitch Utilisateur Utilisateur:Kharmitch/Brouillon Discussion Utilisateur:Kharmitch/Brouillon
Dénombrements
`{{PAGESIZE}}` `{{PAGESINCAT}}`	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 8 362 octets. 0 pages dans la catégorie Quêtes de Fallout.
Autres
`__NOTOC__` `__TOC__` `__HIDDENCAT__`	Ne pas afficher le sommaire Afficher le sommaire ici Cacher cette catégorie dans les articles (à placer dans une catégorie)

ParserFunctions modifier

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 modifier

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 modifier

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 modifier

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 modifier

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 :

$x=a_{0}+{\frac {1}{a_{1}+{\frac {1}{a_{2}+y^{2}}}}}$

Inclusion modifier

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.

[1] Texte de la note.

[nom_de_la_ref-2] 2,0 et ^2,1 Texte de la note nommée.

[3] Texte de la note.

[4] Texte de la note.

[5] Texte de la note.

[6] Texte de la note C1.

[2_occ-7] 2,0 et ^2,1 Texte de la note C2.

[8] Texte de la note C3.

[1]

[2]

[A 1]

[A 2]

[B 1]

[C 1]

[C 2]

[C 3]