Différences entre les versions de « Aide:Modèle »

Un modèle est une fonctionnalité du Wiki qui permet d'insérer du texte sans avoir à le copier-coller entièrement. Cela est particulièrement utile pour utiliser un long bloc de code sans avoir à le recopier entièrement. Chaque modèle dispose d'une page dédiée, où se trouve le texte de base, et s'affiche lorsqu'on place le nom de cette page entre les doubles accolades ({{Nom du modèle}}).

Les infobox sont des modèles spéciaux : voir Aide:Infobox. Une liste des modèles peut être trouvé dans la catégorie dédiée.

Utilisation[modifier]

Un modèle s'affiche lorsque son titre est affiché entre doubles accolades {{ }}, utilisables en maintenant sur le clavier alphabétique les touches Alt Gr + 4 pour l'accolade gauche, et Alt Gr + = pour l'accolade droite.

Exemple : pour afficher le modèle Armes, on utilise soit le code {{Modèle:Armes}} soit le code {{Armes}}.

Chaque modèle dispose d'une page dédiée commençant par l'identifiant « Modèle: ». Cette page contient le code du modèle, ainsi que la documentation nécessaire à son utilisation.

Exemple : le modèle Armes est défini sur la page Modèle:Armes.

Paramètres[modifier]

Certains modèles requièrent des paramètres, du texte qui doit être renseigné lors d'un appel à ce modèle afin de compléter son résultat final. Ces paramètres doivent être précédés d'une barre verticale « | » (Alt GR + 4) dans l'appel du modèle. Un paramètre peut être anonyme, ou bien nommé. Dans ce deuxième cas, il faudra indiquer le nom du paramètre avant sa valeur. Il est préférable d'utiliser des retours à la ligne dans le code des modèles avec plusieurs paramètres par souci de lisibilité.

Exemple 1 : à l'appel de Modèle:V, qui sert à mettre aux normes typographiques le nom des vaisseaux, le nom du vaisseau est un paramètre anonyme obligatoire. Le code d'appel sera par exemple {{V|Pillar of Autumn}} (qui affiche : UNSC Pillar of Autumn).

Exemple 2 : le code d'appel de Modèle:Fichier utilise trois paramètres nommés, appelés Source, Média et Créateur. Le code d'appel sera donc présenté ainsi :

Quand plusieurs paramètres sont requis, ils doivent tous être séparés par une barre verticale. Si ces multiples paramètres sont nommés, leur ordre n'a pas d'importance, mais si ces paramètres sont anonymes, ils doivent être définis dans un ordre précis. Il est possible de laisser vide la valeur d'un paramètre. L'ordre d'appel ou les noms de ces paramètres sont listés dans la documentation du modèle.

Attention dans le cas des paramètres anonymes : puisque le nom d'un paramètre est identifié par la présence du signe « = », si la valeur qu'on veut donner au paramètre contient ce signe, le système interprétera le texte de la valeur avant le « = » comme un nom de paramètre (cela peut arriver avec les adresses url qui contiennent ce signe). Pour afficher correctement la valeur, il faut introduire le paramètre comme on le ferait pour un paramètre nommé, mais avec le chiffre de l'ordre d'appel (dans l'exemple 1, on utiliserait donc le code {{V|1=Pillar of Autumn}}).

Types de modèles[modifier]

Il existe plusieurs types de modèles, dont l'emplacement sur la page est différent. Pour une explication détaillée, voir Aide:Construction des pages.

• Modèles de navigation : ces modèles sont des tableaux rassemblant des liens vers d'autres pages similaires à celle sur laquelle il est affiché. Ainsi, sur la page du Fusil d'assaut, on trouvera le code {{Armes}}, qui affiche le modèle affichant un tableau où sont réunis des liens vers les autres armes de l'univers Halo. Ces modèles sont affichés en bas de page.

• Modèles d'avertissement : ces modèles sont composés d'un bandeau situé tous en haut de la page, qui a pour but d'avertir le lecteur sur une particularité de la page, et de l'ajouter dans la catégorie correspondante. Ainsi, si la page contient des spoilers sur un support récent, on affichera le code {{Spoilers}} qui affichera un bandeau avertissant de la présence de spoilers.

• Modèles de complétion : ces modèles sont placés tout en haut de page, et servent à indiquer qu'une page doit être complétée. Ils servent également à comptabiliser la page dans les catégories liées à ce besoin de complétion. Par exemple, si une page a besoin d'images, on affichera le code {{toillustrate}} qui affichera un bandeau demandant à ce qu'on illustre la page.

Création[modifier]

Il apparaît parfois nécessaire de créer un modèle. Les codes ci-dessous peuvent être copiés-collés dans une page vide, dont le nom commencera par Modèle: suivi du nom du modèle.

Pour maintenir un design cohérent sur le Wiki, il est déconseillé de modifier le code CSS définissant les modèles.

Modèle de navigation[modifier]

{{Navigation
|titre=
|categories=
|pagename=
|CatHide={{{CatHide|}}}
}}
| Contenu
|-
|}
<noinclude>[[Catégorie:Modèle de navigation]]</noinclude>

Recommandations :

• Pour ajouter une ligne, ajoutez un signe « | » (Alt Gr + 6), et écrivez à la suite. Pour passer une ligne, ajoutez « |- ». C'est le comportement d'un tableau.
• Pour séparez des liens, utilisez le signe • (Alt + 0149 (sur pavé numérique)).
• Vous pouvez mettre un lien dans le titre.
• Ne pas utiliser le retour à la ligne (<br>) afin de préserver la cohérence de l'affichage. Déclarer une nouvelle ligne de tableau suffit.

Modèle d'avertissement/de complétion[modifier]

<div class="entete-info">Message</div>

[[Catégorie:Catégorie correspondante]]

L'attribut class peut contenir les valeurs suivantes :

• entete-important (manque critique d'informations)
• entete-standard (manque non critique d'informations et avertissement sur le contenu)
• entete-info (indication générale)
• entete-wikipol (indication sur une politique propre au WikiHalo)

Documentation[modifier]

Tout modèle doit être accompagné d'une documentation qui explique les conditions de son utilisation et ses éventuels paramètres et pages liées.

Pour séparer le code et la documentation et prévenir les erreurs de catégories, il est nécessaire d'accoler au code du modèle (sans retours à la ligne) la balise <includeonly> au début, et la balise </includeonly> à la fin. La documentation doit commencer par la balise <noinclude> et se terminer par la balise </noinclude>.

• Voir le schéma à suivre pour présenter la documentation sur Aide:Modèle/Documentation.

Technique avancée[modifier]

• Voir : Aide:Modèle/Avancé

Modèles dans les recherches[modifier]

Lors d'une recherche standard, c'est le contenu d'un article ainsi que le contenu de ses modèles qui est inspecté. Cela implique que, par défaut, il n'est pas possible de rechercher l'appel à un modèle.

Pour rechercher le texte « brut » d'un article, sans le contenu des modèles, il faut précéder la recherche du tag insource:.