GW2Wiki:Formatage/Modèles

Les modèles sont des pages de code avec des fonctions et qui sont utilisés pour générer du contenu au style identique en n'insérant que quelques paramètres.

Type et emplacement

• Modèles d'entête : Ces modèles s'utilisent au sommet de page avant tout contenu spécifique à la page. Ils s'utilisent pour alerter le lecteur en tout premier lieu.
• Modèles d'infobox : Ces modèles génèrent une infobox où les valeurs des paramètres sont modifiables. Il existe une infobox par type d'élément du jeu. Une seule infobox est autorisée par page et elle est placée en tête du contenu d'une page.
• Modèles de liste : Ces modèles génèrent des listes automatiques et s'emploient au sein même du contenu de la page.
• Modèles de navigation : Ces modèles génèrent une palette qui contient des liens facilitant la navigation entre eux. Ils se placent à la fin d'une page avec les catégories et interwikis.

Création et édition de modèles

Les modèles sont du code plus complexe que celui d'une page. Il est important de comprendre qu'un modèle est souvent utilisé par des dizaines voire par des milliers d'autres pages et leurs modifications ne doivent pas être prises à la légère. Elles ont des conséquences en arrière-plan sur le wiki ainsi qu'en premier plan lors d'affichage de la page.

Il est préférable de demander de l'aide à un utilisateur vétéran que de se lancer dans leurs créations et éditions seul et de discuter au préalable avec la communauté avant d'en modifier.

Général

• Les modèles sont créés sur l'espace de nom Modèle.
• La page du modèle n'est ni un espace de travail ni un espace de tests :
  • Ils doivent être créés sur un espace personnel avant publication. Un modèle publié est un modèle terminé.
  • Ils ne doivent pas être modifiés sans test au préalable sur un espace autre et encore moins à l'arrachée.
  • Les modifications en masse et en boucle d'un modèle sont proscrites et peuvent causer des problèmes sur toutes les pages utilisant le modèle.
• Il faut éviter de cumuler les modèles et de créer un modèle pour chaque cas particulier. Il est préférable d'adapter d'autres modèles équivalents.
• Les {{ #ifexist }} doivent être remplacés par le modèle:ifexists.

Structure du code et sections

Un modèle est séparé en une section includeonly et une section noinclude.

Section includeonly

• La section incluondeoly du modèle est toujours en première dans le code de la page et consiste à entourer le code de balises <includeonly></includeonly>
• Le code doit être organisé et optimisé pour faciliter son édition.
• Les catégories et propriétés sémantiques générées par le modèle sont placées en fin de code.

Section noinclude

• Chaque modèle est accompagné d'une description et des sections suivantes entourés de balises <noinclude></noinclude>:
  • La section Paramètres qui décrit chaque paramètre du modèle.
  • La section Exemples qui montre des exemples d'utilisation du modèle avant le code en <pre>prévisualisation</pre> et ce qu'il donne.

Propriétés sémantiques

Pour faciliter la mise à jour du wiki, des propriétés sémantiques sont créées pour attribuer des valeurs aux pages selon les paramètres insérés dans les modèles qu'elle utilise.

• Les propriétés sémantiques sont créées sur l'espace de nom Attribut avec le type de propriétés dont il s'agit.
• Les propriétés sémantiques ne doivent pas être attribuées si le modèle est employé sur une page avec un espace de nom.
• Les propriétés sémantiques ne doivent surtout pas être modifiées ni être créées à l'arrachée sans tests au préalable. Le changement de type d'une propriété peut avoir de fortes conséquences.

---