Aide:Modèle

Les modèles sont un mécanisme permettant d'inclure dans les pages une partie de texte et tout changement apporté à cette partie est immédiatement visible dans les pages concernées.

Introduction

Pour créer un nouveau modèle personnalisé, il suffit de créer une page dans l'espace de nommage (namespace) "Modèle", ce que l'on obtient en préfixant un lien par Modèle: suivi du nom choisi pour le modèle. La page créée servira de contenu au modèle en question.

ATTENTION : Ne pas inclure de liens inter-projets ou de catégorisation ([[Catégorie:Nom de la catégorie]]) dans un modèle à moins que vous ne soyez absolument certain que ces liens soient applicables à toutes les pages qui utiliseront le modèle ! Si deux liens inter-linguistiques vers une même autre langue apparaissent (l'un dans la page, l'autre dans le modèle utilisé par la page), les résultats sont imprévisibles.

Un modèle est inclus dans une page au moyen d'une balise présentée ainsi (la première lettre du nom du modèle n'est pas sensible à la casse) :

• {{NomDuModèle}} : se contente de charger le modèle à chaque appel de la page sans changer le contenu de celle-ci. En d'autres termes, quand le modèle est mis à jour, vous n'avez pas besoin de changer les pages utilisant ce modèle.
• {{subst:NomDuModèle}} : copie le texte du modèle à l'endroit voulu dans le corps de l'article de manière définitive après une première sauvegarde.

Ainsi, un modèle bref et temporaire destiné à être rapidement supprimé devrait être copié avec subst:, dont l'avantage est qu'il apparaît directement dans la source de l'article. Une notice normale destinée à rester sur une page pour une longue durée ou bien à jamais devrait être incluse au moyen de {{NomDuModèle}}, de manière à ce que les mises à jour éventuelles soient plus aisées. Un modèle contenant un lien temporaire ou susceptible de changer ne devrait cependant pas être ajouté par {{NomDuModèle}}. Cette méthode, en effet, ne met pas à jour le lien Pages liées à moins que chaque article contenant le {{NomDuModèle}} soit effectivement modifié après la modification du lien dans le modèle en question.

• Il est possible d'inclure du texte provenant d'autres espaces de nommage ; comme par exemple {{Wikibéral:Modifications récentes}}.
• 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=valeur}} avec des balises {{{param}}} 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,
• Mais un modèle ne peut pas être lui-même paramètre d'un autre modèle.
• Les REDIRECTs entre modèles fonctionnent.

Dans un modèle, pour faire un lien vers une page qui dépend d'un paramètre d'un modèle, les liens de type externe sont souvent utilisés même pour des liens internes afin d'éviter qu'on aboutisse sur la page en mode d'édition même si cette page existe.

Pseudo-modèles

Il existe aussi des modèles spéciaux avec un contenu prédéfini :

{{NAMESPACE}}	le nom de l'espace de nommage dans lequel se trouve la page :	"Aide"
{{PAGENAME}}	le nom de la page sans le préfixe de l'espace de nommage :	"Modèle"
{{PAGENAMEE}}	le nom de la page dans le format utilisé dans les URL :	"Mod%C3%A8le"
{{SITENAME}}	le nom du site :	"Wikiberal"
{{SERVER}}	le nom du site :	"https://www.wikiberal.org"
{{localurl:nomdepage}}	l'URL correspondant à une page :	"/wiki/Nomdepage"
{{localurl:nomdepage|paramètres}}	idem mais avec des paramètres :	"/index.php?title=Nomdepage&paramètres"
{{CURRENTMONTH}}	le mois :	"04"
{{CURRENTMONTHNAME}}	le nom du mois :	"avril"
{{CURRENTMONTHNAMEGEN}}	le mois :	"avril"
{{CURRENTDAY}}	le jour du mois :	"19"
{{CURRENTDAYNAME}}	le jour de la semaine :	"vendredi"
{{CURRENTYEAR}}	l'année :	"2024"
{{CURRENTTIME}}	l'heure courante :	"22:30"
{{NUMBEROFARTICLES}}	le nombre d'articles :	"7 252"

Exemples d'utilisation de pseudo-modèles

{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAMEE}}|action=edit}}	https://www.wikiberal.org/index.php?title=Aide:Mod%C3%A8le&action=edit
{{SERVER}}{{localurl:Special:Whatlinkshere|target={{NAMESPACE}}:{{PAGENAMEE}}}}	https://www.wikiberal.org/index.php?title=Sp%C3%A9cial:Whatlinkshere&target=Aide:Mod%C3%A8le
[[{{NAMESPACE}}:{{PAGENAMEE}}_1]]	Aide:Modèle_1
{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAMEE}}_1}}	https://www.wikiberal.org/wiki/Aide:Mod%C3%A8le_1

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:Planète mineure se lit en partie :

{| align="right" rules="all" cellpadding="4" cellspacing="0" style="margin: 0 0 1em 1em; border: 1px solid #999; border-right-width: 2px; border-bottom-width: 2px; background-color: #CEDAF2"

...

| style="background: #003399" align="center" width="100%" |<font color=white size=4>'''{{{nom}}}'''

| padding=15px|

|}

|-

! bgcolor="#6295DA" colspan="2" align="center" | Découverte

|-

| Qui || {{{découvreur}}}

|-

| Quand || {{{date_découverte}}}

|-

| [[Désignation des astéroïdes|Désignation(s) provisoire(s)]] || {{{désignations}}}

|-

...

| [[Température]] de surface || {{{température}}}

|}

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 (en gras) les paramètres nom, découvreur, date_découverte, désignations et température.

Sur la page 14 Irène, on trouve, en partie :

{{Planète mineure | nom=14 Irène (14 Irene)

| découvreur=[[John Russell Hind]]

| date_découverte=[[19 mai]] [[1851]]

| désignations=A906 QC; A913 EA;<br>1952 TM

| catégorisation=[[ceinture d'astéroïdes]]

| orbite=386,730 [[gigamètre|Gm]] (2,585 [[unité astronomique|ua]])

...

| dimensions=181,8 km ^{[http://spiff.rit.edu/richmond/parallax/phot/LCSUMPUB.TXT 1]}

...

| température=~234 [[kelvin|K]]}}

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. Idéalement, comme on le constate ci-haut, il peut y avoir un retour à la ligne avant chaque "|" sauf le premier. 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 dimensions) ou intérieur (par exemple, orbite). On remarquera que la syntaxe habituelle des liens wiki est possible (c'est-à-dire [[page visée|texte qui apparaîtra]]).