Pages particulières
Modèles
Pour un récapitulatif concis des modèles utilisés sur le Wiktionnaires, consulter la page Wiktionnaire:Modèles.
Pour voir tous les modèles dans leur ensemble, consulter la page de tous les modèles.
Pour le Wiktionnaire, un modèle est un bloc d’information qui peut être inclus dans les autres pages. Il s’insère dans une page de la façon suivante :
{{nom_du_modèle}}
Il correspond à une page nommée Modèle:nom_du_modèle
Il peut accepter des paramètres, c’est-à-dire des options permettant de configurer son comportement.
Il existe de nombreux modèles, vous pouvez en créer d’autres pour des éléments qui devront être écrits de nombreuses fois.
Il peut servir à :
{{supprimer ?}}
{{TDM}}
. Ces modèles sont souvent paramétrables.{{Liste}}
utilisée pour diverses listes logiques ou alphabétiques.Dans tous les cas le modèle est inséré dans une page en y ajoutant, à l’emplacement adéquat, le libellé {{Nom du modèle}}
Note : la notion de modèle du Wiktionnaire est différente de celle utilisée dans les logiciels de traitement de texte.
Les modèles sont gérés dans un espace de noms, l’espace Modèle:. Voyez la liste des modèles principaux utilisés dans le Wiktionnaire.
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 latéral pour consulter les pages utilisant le modèle et vérifier, avant modification, que ces pages ne seront pas perturbées.
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 une autre page, puis de cliquer sur le lien (qui apparaîtra en rouge).
Si le modèle contient un lien inter-langue, alors ce lien est inclus dans toutes les pages utilisant le modèle, ce qui n’est généralement pas le résultat voulu. Si deux liens inter-langue vers une même autre langue se trouvent dans une page, le résultat est imprévisible. On évitera ces conflits en utilisant les balises d’inclusion sélective.
Les noms de modèles utilisant des mots abrégés ou collés sont difficiles à retenir car aucune convention ne s’est imposée. Il n’y a pas de raison technique pour ne pas s’inspirer des conventions de Wikipédia sur les titres (lorsque la convention Wiktionnariste n’existe pas) pour les noms de modèle.
Si le modèle appartient à une catégorie, c’est à dire que la page du modèle contient un libellé de la forme ], et si l’on ne fait pas simultanément usage de la balise d’inclusion sélective "noinclude", toutes les pages contenant le modèle appartiendront à cette catégorie. On peut utiliser cette astuce, par exemple, pour obtenir la liste de toutes les pages ébauche d’un domaine donné. Ceci est également valable pour le modèle catégorisant {{Documentation}}
décrit ci-dessous.
Si un modèle bugue à l'affichage, il est possible de coller la page qui l'appelle dans Spécial:ExpansionDesModèles afin de voir ce qui se passe après l'inclusion.
À 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. Pour les documentations plus volumineuses, il vaut mieux créer une sous-page /Documentation
pour soulager la charge du serveur. Pour documenter un modèle déjà créé, utilisez {{Documentation}}
sur sa page et celle de sa documentation (Modèle:Nom du modèle/Documentation).
Pour disposer d’un formulaire de documentation préchargé lors de la création d’un nouveau modèle, mettez le nom de modèle de votre choix dans la boîte suivante et cliquez sur le bouton "créer le modèle" :
Pour inclure un modèle, il faut utiliser la syntaxe suivante (Attention : la première lettre du nom du modèle est 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 contenu du modèle soit copié une fois pour toutes dans la page l’utilisant (cette façon de faire se rapproche de l’usage des modèles en traitement de texte). Dans ce cas-ci, une modification ultérieure du modèle n’aura aucune incidence sur la page.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 la page. Une notice normale destinée à rester sur une page pour une longue durée ou bien à jamais devrait être incluse au moyen de {{Nom du modè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 {{Nom du modèle}}
. Cette méthode, en effet, ne met pas immédiatement à jour le lien Pages liées à moins que chaque page contenant le {{Nom du modèle}}
soit effectivement modifiée après la modification du lien dans le modèle en question (ces liens sont mis à jour par un processus d’arrière-plan qui peut prendre jusqu’à quelques heures à se faire sentir).
{{Wiktionnaire:Modifications récentes}}
.{{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.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’en suivant le lien, on aboutisse sur la page avec la fenêtre de modification même si cette page existe.
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.
(pour plus de détails voir Aide:Modèles)
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: {{{3}}}.
Chaque remplacement peut aussi prendre une valeur prédéfinie par l’utilisateur, comme ceci : {{{3|123}}}
(s’il n’y a pas de 3e paramètre, on utilise 123 à la place). Ou comme cela : {{{paramètre|123}}}
(la même chose avec un paramètre nommé).
Il est possible de ne rien écrire par défaut : {{{3|}}}
(en n’écrivant rien après la barre verticale, pas même un espace).
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èles ») et {{PAGENAMEE}}
(ici « Mod%C3%A8les »).
Noms de page | ||
---|---|---|
{{NAMESPACE}}
|
le nom de l’espace de noms dans lequel se trouve la page | « Aide » |
{{PAGENAME}}
|
le nom de la page sans le préfixe de l’espace de noms | « Modèles » |
{{PAGENAMEE}}
|
le nom de la page sans le préfixe de l’espace de noms dans le format utilisé dans les URL | « Mod%C3%A8les » |
{{FULLPAGENAME}}
|
le nom de la page avec le préfixe de l’espace de noms | « Aide:Modèles » |
{{FULLPAGENAMEE}}
|
le nom de la page avec le préfixe de l’espace de noms dans le format utilisé dans les URL | « Aide:Mod%C3%A8les » |
{{SUBPAGENAME}}
|
le nom de la dernière sous-page la plus imbriquée | « Modèles » |
{{BASEPAGENAME}}
|
le nom de base de la page, utile dans les sous-pages | « Modèles » |
{{TALKPAGENAME}}
|
la page de discussion associée (elle-même si déjà en page de discussion) | « Discussion aide:Modèles » |
Fabrication d’URL | ||
{{SERVER}}
|
l’URL du site | « //fr.wiktionary.org » |
{{localurl:nom d’une page}}
|
l’URL correspondant à une page | « https://dictious.com/fr/nom_d%E2%80%99une_page » |
{{localurl:nom d’une page|paramètres}}
|
idem mais avec des paramètres | « https://fr.wiktionary.org/w/index.php?title=nom_d%E2%80%99une_page¶mètres » |
{{fullurl:nom d’une page}}
|
l’URL complet de la page, correspond à {{SERVER}}{{localurl:nom d’une page}}
|
« //fr.wiktionary.orghttps://dictious.com/fr/nom_d%E2%80%99une_page » |
{{fullurl:nom d’une page|paramètres}}
|
idem mais avec des paramètres | « //fr.wiktionary.orghttps://fr.wiktionary.org/w/index.php?title=nom_d%E2%80%99une_page¶mètres » |
{{urlencode:modèle d’une page}}
|
permet d’encoder une chaîne de caractères sous forme d’URL | « mod%C3%A8le+d%E2%80%99une+page » |
Date et heure | ||
{{CURRENTMONTH}}
|
le mois | « 12 » |
{{CURRENTMONTHNAME}}
|
le nom du mois | « décembre » |
{{CURRENTMONTHNAMEGEN}}
|
le mois aussi (avec particularité dans certaines langues) | « décembre » |
{{CURRENTDAY}}
|
le jour du mois | « 23 » |
{{CURRENTDAYNAME}}
|
le jour de la semaine | « lundi » |
{{CURRENTYEAR}}
|
l’année | « 2024 » |
{{CURRENTTIME}}
|
l’heure | « 08:11 » |
Autres | ||
{{SITENAME}}
|
le nom du site | « Wiktionnaire » |
{{NUMBEROFARTICLES}}
|
le nombre de pages | « 6 502 559 » |
{{ns:7}}
|
le nom d’un espace de nom d’après son numéro | « Discussion fichier » |
{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}|action=edit}}
|
//fr.wiktionary.orghttps://fr.wiktionary.org/w/index.php?title=Aide:Mod%C3%A8les&action=edit |
{{SERVER}}{{localurl:Special:Whatlinkshere|target={{NAMESPACE}}:{{PAGENAME}}}}
|
//fr.wiktionary.orghttps://fr.wiktionary.org/w/index.php?title=Sp%C3%A9cial:Whatlinkshere&target=Aide:Modèles |
{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}_1}}
|
//fr.wiktionary.orghttps://dictious.com/fr/Aide:Mod%C3%A8les_1 |
{{fullurl:{{NAMESPACE}}:{{PAGENAME}}_1}}
|
//fr.wiktionary.orghttps://dictious.com/fr/Aide:Mod%C3%A8les_1 |
''Voir : ].''
|
Voir : Aide Modèles 1. |
]
|
Aide:Modèles_1 |
]
|
Aide:Modèles_1 |
<noinclude>...</noinclude>
Il est parfois utile de placer certains éléments dans le code source du modèle (par exemple les liens interlangues) 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 la page qui l’inclut :
(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 pages qui incluent ce modèle :
''(contenu ''{{{1|}}}'' à compléter...)''<noinclude> ] ] ] </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.
<noinclude>
et </noinclude>
étaient absentes du code ci-dessus, mais leur contenu conservé (y compris les sauts de lignes et espaces à l’intérieur){{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).Ce modèle peut aussi être mis en forme et commenté sur sa propre page de description, sans que cela apparaisse dans les pages qui l’incluent ; par exemple :
<noinclude> Ce modèle n’est qu’un exemple à compléter. === Paramètres === Aucun paramètre obligatoire n’est ici nécessaire pour utiliser ce modèle dans une page. Un paramètre unique (optionnel, vide par défaut) permet d’ajouter du texte au milieu du contenu affiché par ce modèle. === Exemple de rendu dans les pages === </noinclude>''(contenu ''{{{1|}}}'' à compléter...)''<noinclude> === Voir aussi === * ] ] ] ] </noinclude>
Notez ci-dessus comment le code de documentation du modèle intercale le contenu réel du modèle. Ainsi complété, le modèle affichera la page suivante :
Ce modèle n’est qu’un exemple à compléter.
Aucun paramètre obligatoire n’est ici nécessaire pour utiliser ce modèle dans une page.
Un paramètre unique (optionnel, vide par défaut) permet d’ajouter du texte au milieu du contenu affiché par ce modèle.
(contenu à compléter...)
<includeonly>...</includeonly>
Inversement, les éléments qu’on veut voir apparaître en insertion, mais qu’on veut voir disparaître lors de la visualisation du modèle seul sont placés entre les balises <includeonly>
et </includeonly>
.
Notez que le placement d’un titre dans une section "includeonly" peut désorganiser la numérotation du sommaire et des liens "modifier" qui apparaissent à droite des titres.
Par exemple, il peut être parfois nécessaire de montrer plusieurs exemples du modèle lui-même, en fournissant des paramètres. Dans ce cas, le code du modèle sera préférablement placé en tête mais caché dans la page de description. Par exemple :
<includeonly>''(contenu ''{{{1|}}'' à compléter...)''</includeonly><noinclude> Ce modèle n’est qu’un exemple à compléter. === Paramètres === Aucun paramètre obligatoire n’est ici nécessaire pour utiliser ce modèle dans une page. Un paramètre unique (optionnel, vide par défaut) permet d’ajouter du texte au milieu du contenu affiché par ce modèle. === Exemples de rendu dans les pages === # {{Exemple|A}} # {{Exemple|B}} === Voir aussi === * ] ] ] ] </noinclude>
Notez ci-dessus la récursion du modèle : il est possible que lors de l’édition d’un modèle déjà existant, il faille le sauvegarder deux fois pour que l’auto-inclusion dans sa page de description prenne en compte le nouveau contenu du modèle. Notez également comment sont disposés les balises </includeonly><noinclude>
, sans aucun saut de ligne intermédiaire qui tomberait en surplus et qui risquerait d’interrompre par exemple la liste à numérotation automatique montrée dans l’exemple ci-dessus et dans laquelle le modèle est inséré, ou qui pourrait créer une rupture de paragraphe indésirable dans les pages qui incluent le modèle, ou des sauts blancs verticaux en excédent.
L’utilisation du balisage <includeonly></includeonly>
doit donc rester exceptionnel et doit être utilisé avec précaution.
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’une page ou d’un autre modèle) les balises <noinclude>...</noinclude>
ainsi que le texte qu'elles encadrent ne sont pas reproduites.
Afin de créer un modèle non encyclopédique (par ex. destiné à être appelé par une page utilisateur) ou pour faire des tests, nul n'est besoin de « polluer » l'espace des modèles. Cela peut se faire sur une sous-page utilisateur.
Par exemple, si Utilisateur:Quidam veut tester un modèle appelé « Rédaction fastidieuse », il procède comme suit :
<div style="border:1px solid black;background:rgb(80%,100%,80%);text-align:center;padding=0.4ex;"> ''Ceci est une rédaction fastidieuse. Le taux d’ennui est estimé à {{{ennui}}}%.'' </div>
{{Utilisateur:Quidam/Rédaction fastidieuse|ennui=55}}
ce qui donne :
Ceci est une rédaction fastidieuse. Le taux d’ennui est estimé à 55%.
D’une façon générale, la syntaxe (entre doubles accolades) d’appel d’un modèle :
{{espace de nommage:nom d’une page|paramètre1=valeur1}}
reconnait la présence de l’espace de nom:
, qui ne prend la valeur par défaut Modèle:
que quand l’espace de nom n’est pas indiqué explicitement. De même les paramètres peuvent être nommés explicitement, ou implicitement par leur rang d’apparition dans l’appel du modèle.
Rafraîchissement : Pour rafraîchir une page qui est restée inchangée, alors que les modèles qu’elle contient ont été modifiés, créer un lien du type :
et cliquer dessus, ou utiliser {{Purger le cache}}
.
Mise à jour des tables : Quand une page contient une autre page, et que cette dernière est modifiée, la page principale est mise à jour mais pas la table des liens, ni les catégories. Même un &action=purge n’y change rien. Il y a deux moyens pour forcer la mise à jour des liens et des catégories :
Les développeurs ont été mis au courant de tous ces problèmes sur la page Bugzilla N°939.
Pour comprendre les fonctions particulières du langage Wiki utilisées dans certains modèles, vous pouvez aller voir ici.
L’ajout d’une langue dans le Wiktionnaire se déroule très facilement pour les cas simples :
{{langue}}
et en utilisant le code de langue en paramètre ;