Aide:Modèle

De NainWiki
Aller à : Navigation, rechercher


Sommaire

Définition

Pour Wikipedia, un modèle est un bloc d'information qui peut être inclus dans les autres pages. Il peut servir à :

  • insérer un message standard, exemple : le message indiquant qu'un article est encore à l'état d'ébauche Modèle:ébauche
  • insérer un tableau commun à plusieurs pages d'un même domaine. Exemple : le tableau utilisé pour les armes Modèle:arme. Ce modèle est paramétrable, c'est-à-dire qu'il y a un fond de tableau commun et des variables dont le contenu change dans chaque article.
  • insérer une palette de navigation dans toutes les pages d'un même domaine. Exemple : euh... non en fait ça on en a pas encore ^^
  • etc.

Dans tous les cas le modèle est inséré dans un article en y ajoutant, à l'emplacement adéquat, le libellé {{Nom du modèle}}

Les modèles sont des pages comme les autres et donc accessibles à l'édition par tous les contributeurs. Il faut toutefois les modifier avec prudence car le résultat apparaît sur de nombreuses pages. Lorsque la page correspondant au modèle est affichée, on peut cliquer sur l'hyperlien Pages liées du menu de gauche pour consulter les pages utilisant le modèle et vérifier, avant modification, que ces pages ne seront pas perturbées.

Création d'un modèle

La méthode est identique à celle de la création d'une page quelconque. Le plus simple est d'insérer un appel au modèle dans un article, puis de cliquer sur le lien (qui apparaîtra en rouge). Genre [[Modèle:nom de mon modèle]]

Trucs et astuces

Si le modèle appartient à une catégorie, c'est à dire que la page du modèle contient un libellé de la forme [[Catégorie:Nom d'une catégorie]], et si l'on ne fait pas simultanément usage de la balise d'inclusion sélective "noinclude", tous les articles contenant le modèle appartiendront à cette catégorie. On peut utiliser cette astuce, par exemple, pour obtenir la liste de tous les articles ébauche d'un domaine donné.

Documentation du modèle

À la suite du modèle, à même la page, il est recommandé de fournir toutes les explications nécessaires à son utilisation dans une zone de documentation qui ne sera pas visible de la page où il est inclus.

Utilisation

Pour inclure un modèle il faut utiliser la syntaxe Wikipédia suivante (la première lettre du nom du modèle n'est pas sensible à la casse) :

  • {{Nom du modèle}} pour que le modèle soit inclus à chaque chargement d'une page l'utilisant. Ainsi, dès que le modèle est modifié, la modification devient visible dans toutes les pages utilisant le modèle.
  • {{subst:Nom du modèle}} pour que le modèle soit copié une fois pour toute dans la page l'utilisant. Dans ce cas-ci, une modification du modèle n'a aucune incidence sur la page.
  • Tous les caractères sont acceptés, y compris les espaces.
  • Tout changement d'un modèle efface automatiquement le cache de toutes les pages utilisant ce modèle.
  • Les modèles peuvent prendre des arguments, référencés par position ou par nom (voir l'exemple plus élaboré ci-dessous). La syntaxe est la suivante: {{chose|paramètre=valeur}} avec des balises {{{paramètre}}} dans le modèle, ou bien {{brol|valeur1|valeur2}} avec {{{1}}}, {{{2}}}, etc. Notez que les balises de paramètres dans le modèle demandent trois accolades et non deux.
  • Un modèle peut inclure un ou plusieurs autres modèles,
  • Un modèle ne peut pas être lui-même paramètre d'un autre modèle.
  • Les redirections entre modèles fonctionnent.

Modèles à paramètres

Un modèle peut être écrit afin d'accepter des paramètres. Cela permet de créer, par exemple, des tableaux pré-formatés dont seules certaines valeurs changent selon la page invoquant le modèle.

Par exemple, le modèle Modèle:arme se lit en partie :

{| align=right rules="all" cellpadding=4 style="margin-left: 15px; border:1px solid #999; color:#000000; background-color:#F7F7F7;"
|- 
| align="center" | {{{image|}}} || align="center" | <big>'''{{{nom|{{PAGENAME}}}}}'''</big>'''
|-
| align="center" | '''type''' || align="center" | arme
|-
| align="center" | '''utilisation''' || align="center" | {{{utilisation|?}}} PA
|- 
| align="center" | '''portée''' || align="center" | {{{portee|?}}} case(s)
|- 
| align="center" | '''dommages''' || align="center" | {{{dommages|}}}
|- 
| align="center" | '''rechargement''' || align="center" | {{{rechargement|?}}} jour(s)
|}

Le contenu de ce modèle est un tableau formaté, spécifiant couleurs, alignement, etc. Les parties apparaissant entre triple accolades sont les paramètres qui seront utilisés par la page invoquant le modèle. On voit ci-dessus les paramètres image, nom, utilisation, portee, dommages et rechargement.

Sur la page calto, on trouve, en partie :

{{arme
|image=http://www.nainwak.com/images/objets/calculette.gif
|utilisation=3
|portee=0
|dommages=7
|rechargement=0
}}

Afin d'améliorer la lisibilité lors de l'édition, des retours à la ligne peuvent apparaître dans le modèle, à la façon des tableaux. Les valeurs des paramètres sont spécifiées en écrivant paramètre=valeur. Il ne doit pas y avoir de retour à la ligne dans la valeur, mais <br /> est permis. La valeur peut inclure un lien extérieur (par exemple, le paramètre image) ou intérieur. On remarquera que la syntaxe habituelle des liens wiki est possible (c'est-à-dire [[page visée|texte qui apparaîtra]]).

Valeur par défaut d'un paramètre

Lors de l'appel du modèle, les paramètres qui ne sont pas définis sont remplacés par leur nom "tel quel". Exemple: {{{portee}}}.

Chaque remplacement peut aussi prendre une valeur prédéfinie par l'utilisateur, comme ceci: {{{portée|?}}} (s'il n'y a pas de paramètre portee, on utilise ? à la place).

Il est possible de ne rien écrire par défaut: {{{dommages|}}} (en n'écrivant rien après la barre verticale, pas même un espace).

Modèles spéciaux

Ces modèles, appelés variables, sont prédéfinis et ne doivent pas être utilisés comme nom de modèles. Les variables concernant les noms de pages comprennent généralement une variable duale qui comprend un 'E' en plus à la fin et est encodé dans les URL ({{PAGENAME}} (ici "Modèle") et {{PAGENAMEE}} (ici "Mod%C3%A8le").

 Noms de page (exemple donnés pour [[NainWiki:Proposition articles de qualité/Linux]])
{{NAMESPACE}} le nom de l'espace de noms dans lequel se trouve la page NainWiki
{{PAGENAME}} le nom de la page sans le préfixe de l'espace de noms Proposition articles de qualité/Linux
{{PAGENAMEE}} le nom de la page sans le préfixe de l'espace de noms dans le format utilisé dans les URL Proposition_articles_de_qualit%C3%A9/Linux
{{FULLPAGENAME}} le nom de la page avec le préfixe de l'espace de noms NainWiki:Proposition articles de qualité/Linux
{{FULLPAGENAMEE}} le nom de la page avec le préfixe de l'espace de noms dans le format utilisé dans les URL NainWiki:Proposition_articles_de_qualit%C3%A9/Linux
{{SUBPAGENAME}} le nom de la dernière sous-page la plus imbriquée Linux
{{BASEPAGENAME}} le nom de base de la page, utile dans les sous-pages Proposition articles de qualité
{{TALKPAGENAME}} la page de discussion associée (elle-même si déjà en page de discussion) Discussion NainWiki:Proposition articles de qualité/Linux
 Fabrication d'URL
{{SERVER}} l'URL du site "http://wiki.nainwak.com"
{{localurl:nom d'une page}} l'URL correspondant à une page "/index.php?title=Nom_d%27une_page"
{{localurl:nom d'une page|paramètres}} idem mais avec des paramètres "/index.php?title=Nom_d%27une_page&paramètres"
{{fullurl:nom d'une page}} l'URL complet de la page, correspond à {{SERVER}}{{localurl:nom d'une page}} "http://wiki.nainwak.com/index.php?title=Nom_d%27une_page"
{{fullurl:nom d'une page|paramètres}} idem mais avec des paramètres "http://wiki.nainwak.com/index.php?title=Nom_d%27une_page&paramètres"
 Date et heure
{{CURRENTMONTH}} le mois "05"
{{CURRENTMONTHNAME}} le nom du mois "mai"
{{CURRENTMONTHNAMEGEN}} le mois aussi (avec particularité dans certaines langues) "mai"
{{CURRENTDAY}} le jour du mois "24"
{{CURRENTDAYNAME}} le jour de la semaine "vendredi"
{{CURRENTYEAR}} l'année "2024"
{{CURRENTTIME}} l'heure courante "17:24"
 Autres
{{SITENAME}} le nom du site "NainWiki"
{{NUMBEROFARTICLES}} le nombre d'articles "714"
{{ns:7}} le nom d'un espace de nom d'après son numéro "Discussion fichier"

Exemples d'utilisation de modèles spéciaux

{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}|action=edit}} http://wiki.nainwak.com/index.php?title=Aide:Mod%C3%A8le&action=edit
{{SERVER}}{{localurl:Special:Whatlinkshere|target={{NAMESPACE}}:{{PAGENAME}}}} http://wiki.nainwak.com/index.php?title=Sp%C3%A9cial:Whatlinkshere&target=Aide:Modèle
{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}_1}} http://wiki.nainwak.com/index.php?title=Aide:Mod%C3%A8le_1
{{fullurl:{{NAMESPACE}}:{{PAGENAME}}_1}} http://wiki.nainwak.com/index.php?title=Aide:Mod%C3%A8le_1

Les balises d’inclusion sélective

Balisage <noinclude>...</noinclude>

  • Note : cette balise est recommandée dans les modèles pour expliquer l'utilisation du modèle. Cf Modèle:Arme par exemple.

Il est parfois utile de placer certains éléments dans le code source du modèle sans que ces éléments n’apparaissent sur la page où le modèle est inséré. Pour ce faire, on place les éléments à exclure de l’insertion entre les balises <noinclude> et </noinclude>.

Il est recommandé de laisser au moins un saut de ligne ou espace entre le dernier signe "=" d’une ligne de titre et une balise <includeonly>...</includeonly>.

Il est également recommandé, lorsqu’on place une séquence <noinclude>...</noinclude>, de ne faire précéder ou suivre la séquence entière d’AUCUN saut de ligne ou espace supplémentaire car ils seraient conservés à l’inclusion du modèle (au contraire du contenu de la séquence qui sera ignoré) et pourraient nuire à la présentation de son contenu. Par contre on peut mettre des blancs et sauts de lignes à volonté à l'intérieur (et c'est recommandé pour y placer des catégories ou des liens interwikis, chacun sur une ligne séparée). Par exemple, un Modèle:Exemple contenant normalement

''(contenu ''{{{1|}}}'' à compléter...)''

et qui affiche ceci dans l’article qui l’inclue :

(contenu à compléter...)

peut être complété d’une catégorie et d'un lien interwiki destinés à sa propre classification, mais non destinés aux articles qui incluent ce modèle:

''(contenu ''{{{1|}}}'' à compléter...)''<noinclude>

[[Catégorie:Modèle]]
[[Catégorie:Exemple]]

</noinclude>

Notez ci-dessus l’absence de tout saut de ligne entre le contenu et le début de la section noinclude. Pour catégoriser les modèles ou leur ajouter des liens interwikis, il est vivement recommandé de le faire au sein d’une section noinclude placée à la fin du modèle comme ci-dessus.

  • Lorsque le modèle est affiché sur sa propre page, les catégories et liens interwikis apparaîtront, exactement comme si les deux balises <noinclude> et </noinclude> étaient absentes du code ci-dessus, mais leur contenu conservé (y compris les sauts de lignes et espaces à l’intérieur)
  • Lorsque le modèle est inclus dans un article par le code {{Exemple}}, cette dernière séquence d’appel sera remplacée exactement comme le premier exemple de code montré ci-dessus (mais sans le dernier saut de ligne présent naturellement en fin de tout modèle et qui est toujours ignoré lors de l’inclusion de n’importe quel modèle).

Balisage <includeonly>...</includeonly>

  • Cette balise est non recommandée dans les modèles

Balise d’inclusion sélective et substitution

Lors d’une insertion par substitution (avec la syntaxe spéciale {{subst:modèle}} utilisée uniquement lors de l’édition du code Wiki d’un article ou d’un autre modèle) les balises <noinclude>...</noinclude> ainsi que le texte qu'elles encadrent ne sont pas reproduites.

Voir aussi