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

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

Certains modèles possèdent des paramètres, du texte qui doit être renseigné lors d'un appel à ce modèle. Ces paramètres doivent être précédés d'une barre verticale « | » (Alt GR + 4) dans l'appel du modèle.

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

Certains modèles utilisent plusieurs paramètres. Dans la plupart des cas, ces paramètres portent des noms à indiquer dans le code d'appel. Les noms de ces paramètres sont listés dans la documentation du modèle. 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 : le code d'appel de Modèle:Fichier utilise trois paramètres appelés Source, Média et Créateur. Le code d'appel sera donc présenté ainsi :

Types de modèles

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

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

{|style="border:1px solid silver; font-size:90%; width:60%; text-align:center; clear:both;" align="center"
| class="entete" | '''Titre'''
|-
| 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

<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

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

• Voir : Aide:Modèle/Avancé