Aide:Modèle
Cette page propose quelques explications simples pour comprendre les modèles dans un wiki.
Pour avoir des explications plus complètes, consultez la page Aide:Modèle sur Wikipédia.
Définition d'un Modèle
Un modèle est une page du wiki qui est située dans l'espace Modèle:
.
Il sert à définir un texte ou une mise en forme qui est reproduite sur différentes pages du wiki.
Utilisation d'un modèle
Pour utiliser un modèle dans une page, il suffit de mettre le nom du modèle, sans le nom de l'espace Modèle:
entre une double accolade.
Exemple : lorsque vous voulez séparer deux références contiguës par une virgule en exposant, au lieu de mettre le code <sup>, </sup>
, utilisez le modèle Modèle:,
qui fait le même chose, en plaçant dans la page ce code {{,}}
.
Les paramètres
Un code peut avoir plusieurs paramètres. Il faut mettre la double accolade ouvrante, le nom du modèle, une barre verticale (|), le premier paramètre, une autre barre verticale (|), le deuxième paramètre, et ainsi de suite jusqu'au dernier paramètre, et enfin la double accolade fermante.
Par exemple, si vous voulez mettre une référence sur un épisode de la web série, utilisez le modèle Modèle:Web série Noob
, mais ce modèle ne peut pas fonctionner seul, il faut lui préciser la saison et l'épisode. Par exemple, pour l'épisode 7 de la saison, 5, il faut placer {{Web série Noob|saison=5|épisode=7}}
, ce qui donne « Phases finales (Saison 5, épisode 7)vidéo ».
Dans l'exemple précédent, les paramètres sont explicites, c'est à dire que leur nom est spécifié : le premier paramètre a pour nom saison
et vaut 5
, le second a pour nom épisode
et vaut 7
. Les paramètre peuvent aussi être implicite, dans ce cas il prennent pour nom leur position dans la liste des paramètres.
Par exemple, le modèle Modèle:Exemple
. Vous pouvez le placer sans nommer les paramètres {{Exemple|A|B|C|D}}
. Les paramètres auront les noms et valeurs suivantes :
- 1=A
- 2=B
- 3=C
- 4=D
Lorsque les paramètres sont explicites, leur ordre n'est pas important, vous pouvez les inverser sans problème. Ainsi :
{{Web série Noob|saison=5|épisode=7}}
donne « Phases finales (Saison 5, épisode 7)vidéo ».{{Web série Noob|épisode=7|saison=5}}
donne « Phases finales (Saison 5, épisode 7)vidéo », c'est à dire la même chose.
Ce n'est évidemment pas le cas des paramètres implicites, où la position du paramètre dans la liste des paramètres permet de nommer le paramètre.
Enfin, un modèle peut utiliser des paramètres explicites et implicites en même temps. Là encore, la position du paramètre explicite parmi les paramètres implicite n'a pas d'importante :
{{Exemple|A|B|C|D|p=P}}
|
{{Exemple|A|B|C|p=P|D}}
|
{{Exemple|A|B|p=P|C|D}}
|
{{Exemple|A|p=P|B|C|D}}
|
{{Exemple|p=P|A|B|C|D}}
|
|
|
|
|
|
Introduire un saut de ligne ou un espace entre deux paramètres ne pose pas de problème. Ainsi, les trois codes suivants auront le même effet :
{{Infobox personnage non joueur |nom=Arthéon de Färgoth |faction=sans |image=Artheon sourcelame.jpg |légende= |taille image=200 |type=pnj |sous-type=Olydrien |détail sous-type=World Boss |lieu de vie= |classe=[[guerrier]] |ancien nom=Arthéon |ancienne guilde=[[guilde Noob]] |ancienne faction=Empire |nature=humain |identité IRL=[[Stanislas Châtelain]] |statut IRL=salarié de [[Neuropa Entertainment]] }}
|
|
Pour une question de lisibilité, la première forme est à préférer.
Quelques modèles utilisables
Modèles de mise en forme | Modèle de source | Modèle de description d'image | Modèles d'infobox |
---|---|---|---|
Création ou modification d'un modèle
Partie utile et documentation
La plupart des pages de modèle contiennent deux parties :
- une partie utile, qui est le texte inséré dans les pages où le modèle est apposé,
- la documentation du modèle.
Pour définir la partie documentation, qui ne doit pas être insérée dans les autres pages, il faut la délimiter par les balises <noinclude>
et </noinclude>
.
Il arrive parfois que l'on ne souhaite pas que la partie utile soit visible dans la page du modèle. C'est le cas où des paramètres sont obligatoires et leur absence donne un rendu inesthétique. Par exemple le modèle {{Roman Noob}} sans paramètre donne : Erreur du paramètre 'saison' dans le modèle {{roman Noob}} (paramètre absent ou valeur erronée (seules valeurs permises 1.5, 2.5, 3.5 et 4.5).
Pour éviter cet affichage, il faut utiliser les balises <includeonly>
et </includeonly>
. Dans ce cas, il faut prévoir dans la documentation des exemples pour montrer le rendu du modèle.
Paramètres d'un modèle
Dans un modèle ses paramètres apparaissent sous la forme {{{nom du paramètre|valeur par défaut}}}
.
Pour illustrer, voici la partie utile du modèle {{Citation}} :
<includeonly>« {{{1|}}} »</includeonly>
Ce modèle s'utilise avec la syntaxe suivante :
{{Citation|Le texte à citer}}
Dans l'appel ci dessus, les paramètres sont implicites, il n'y en a qu'un, de nom 1
qui vaut Le texte à citer
.
Le résultat du modèle consiste à mettre ce texte entre guillemets : « Le texte à citer ».
Les paramètres peuvent s'utiliser dans des liens wiki. Le modèle {{m}}, qui sert à faire un lien sur un modèle et à le mettre en accolade, a le code suivant (le code est en fait plus complexe, j'ai simplifié pour une meilleure compréhension ; le paramètre est mis en bleu pour une meilleur compréhension) :
<includeonly>[[Modèle:{{{1|}}}|{{{{{1|}}}}}]]</includeonly>
.
Un modèle peut en appeler un autre et même utiliser un paramètre pour sélectionner le modèle appelé. Par exemple, le modèle {{Web série Noob}} appelle, en fonction de la saison, l'un des six modèles suivants :
- {{Web série Noob/Saison 1}}, pour la première saison
- {{Web série Noob/Saison 2}}, pour la seconde saison
- {{Web série Noob/Saison 3}}, pour la troisième saison
- {{Web série Noob/Saison 4}}, pour la quatrième saison
- {{Web série Noob/Saison 5}}, pour la cinquième saison
- {{Web série Noob/Saison hors}}, pour les épisodes hors saison
{{Web série Noob}} est appelé avec deux paramètres obligatoires, saison
et épisode
. Il a dans sa partie utile le code : {{Web série Noob/Saison {{{saison|}}} | {{{épisode}}} }}
appel du sous-modèle en fonction de la valeur de saison, avec un paramètre implicite qui est égal à la valeur du paramètre épisode
.
Les parser Functions
Les parser Functions sont des fonctions pour effectuer des analyses sur les paramètres. Elles sont assez variées, les plus fréquentes sont :
{{#if:texte|à afficher si le texte est non vide|à afficher si le texte est vide}}
, pour tester la valeur d'un paramètre.- Exemple : vous avez un modèle qui utilise les paramètres
ethnie
etfaction
que vous voulez afficher, avec la faction entre parenthèse. Si la faction n'est pas précisée, les parenthèses ne doivent pas apparaître. Le code à mettre est :{{{Ethnie|}}} {{#if:{{{faction|}}} | ({{{faction|}}}) | }}
- Exemple : vous avez un modèle qui utilise les paramètres
{{#ifeq:valeur1|valeur 2|à afficher si les deux valeurs sont égales|à afficher si les deux valeurs sont différentes}}
, pour tester la valeur d'un paramètre.
{{#ifexist:nom d'une page du wiki|à afficher si la page existe|à afficher si la page n'existe pas}}
, pour tester l'existence d'une page.- Exemple : dans le modèle {{Web série Noob|saison=|épisode=}}, avant d'utiliser un des sous modèles mentionné quelques lignes plus haut, on vérifie l'existence de ce sous-modèle :
{{#ifexist: Web série Noob/Saison {{{saison|}}} | {{Web série Noob/Saison {{{saison|}}} | {{{épisode}}} }} | }}
- Exemple : dans le modèle {{Web série Noob|saison=|épisode=}}, avant d'utiliser un des sous modèles mentionné quelques lignes plus haut, on vérifie l'existence de ce sous-modèle :
{{#switch:paramètre | valeur1 = à afficher si paramètre=valeur1 | valeur2 = à afficher si paramètre=valeur2 | valeur3 = à afficher si paramètre=valeur3 |...| #default = à afficher dans les autres cas }}
, pour le cas où un paramètre peut avoir plusieurs valeurs.- Exemple : le code de {{Roman Noob}} :
{{#switch: {{{saison|}}} | 1.5=''{{#if:{{{noarticle|}}}||La }} Pierre des âges'' (roman saison 1.5) | 2.5=''{{#if:{{{noarticle|}}}||Le }} Continent sans retour'' (roman saison 2.5) | 3.5=''{{#if:{{{noarticle|}}}||Les }} Fantômes du passé'' (roman saison 3.5) | 4.5=''{{#if:{{{noarticle|}}}||La }} Faction du Chaos'' (roman saison 4.5) |#default=<span style="color: #FF0000;">Erreur du paramètre ''''saison'''' dans le modèle {{m|roman Noob}} (paramètre absent ou valeur erronée (seules valeurs permises 1.5, 2.5, 3.5 et 4.5)</span> }}
Pour une explication détaillée de toutes les parser Functions, je vous conseille cette page.