Web Analytics

Static Wikipedia: Italiano -Inglese (ridotta) - Francese - Spagnolo - Tedesco - Portoghese
 
Esperanto - Napoletano - Siciliano - Estone - Quality - New - Chinese Standard  - Simple English - Catalan - Gallego - Euskera
Wikipedia for Schools: English - French - Spanish - Portuguese
101 free audiobooks - Stampa Alternativa - The Open DVD - Open Bach Project  - Libretti d'opera - Audiobook PG

Aide:Modèle

Un article de Wikipédia, l'encyclopédie libre.

Cette page présente une aide générale sur les modèles. Pour une liste de modèles en fonction de leur rôle, voir Wikipédia:Modèles.

Un modèle est un motif créé dans le but de le reproduire sur plusieurs pages. Mais attention, un modèle de Wikipédia est plus précisément une page de l'espace de noms "Modèle:" (ou une page méta, par abus de langage) utilisable en inclusion. Il faut donc plutôt parler de patron lorsqu'il s'agit d'un motif à copier-coller (en savoir plus).

Un modèle peut servir à :

  • insérer un message standard, exemple : le message indiquant qu'un article est proposé à la suppression Modèle:Suppression.
  • insérer un tableau commun à plusieurs pages d'un même domaine. Exemple : le tableau biographique utilisé pour les présidents des États-Unis Modèle:FichePresidentUS. 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 : la palette utilisée pour les articles du domaine physique Modèle:physique (branches).
  • 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}}

Note : la notion de modèle de Wikipedia 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. Une page spéciale en donne ainsi une liste alphabétique. Voyez la liste des modèles principaux utilisés dans Wikipédia.

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.

Sommaire

[modifier] 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.

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 {{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 à jour le lien Pages liées à moins que chaque article contenant le {{Nom du modè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 nom ; comme par exemple {{Wikipédia: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è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.

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.

[modifier] 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).

[modifier] Trucs et astuces

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 sur les titres aussi 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 [[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é.

[modifier] Demander la fabrication d'un nouveau modèle

  • Si vous avez besoin de l'aide d'utilisateurs expérimentés pour fabriquer un nouveau modèle, vous pouvez passer une commande sur la page Projet:Modèle/À faire.

[modifier] Modification

Dans notre exemple, rendez vous sur la page Modèle:En cours pour le modifier, autrement, remplacer le « En cours » par le nom de la palette souhaitée.

[modifier] 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 <sup>[http://spiff.rit.edu/richmond/parallax/phot/LCSUMPUB.TXT 1]</sup>
...
| 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 externe (par exemple, le paramètre dimensions) ou interne (par exemple, orbite). On remarquera que la syntaxe habituelle des liens wiki est possible (c'est-à-dire [[page visée|texte qui apparaîtra]]).


[modifier] Noms des paramètres

Par défaut, les paramètres sont désignés par des nombres à partir de 1, ce qui forme une suite dont chaque élément correspond au rang des valeurs attendues lors de l'emploi du modèle : le paramètre 3 exprimé par le code {{{3}}} détermine le type de la troisième valeur exigée par le modèle.

Sans nom explicite, une aide peut être nécessaire pour l'utilisation du modèle par tout utilisateur.

Par exemple, le modèle {{Annonce}} utilise un paramètre 1 et un paramètre 6 de cette manière : [[image:{{{1}}}|20px|{{{6}}}]] qui s'interprète ainsi : afficher l'image de nom valeur de 1, dans une taille de 20 pixels, avec comme nom la valeur de 6.

Si les valeurs possibles sont en nombre limité et sont connues, un paramètre auquel s'applique une fonction conditionnelle peut être utilisé pour fournir une de ces valeurs : ainsi si l'utilisateur donne la valeur 4 au 3e paramètre du modèle contenant le code suivant [[Image:{{#switch:{{{3}}}|0=00|1=25|2=50|3=75|4=100}}%.svg]], l'image affichée sera l'icône Image:100%.svg, soit image:100%.svg.

L'usage de modèles complexes peut être facilité par des paramètres nommés ; cette pratique est aussi recommandée pour faciliter les contrôles par des robots.

Pour nommer un paramètre, il suffit d'utiliser un nom représentatif de son rôle au lieu des noms par défaut (1/2/3...), par exemple {{{Avancement}}} au lieu de {{{3}}} dans le code [[Image:{{#switch:{{{Avancement}}}|0=00|1=25|2=50|3=75|4=100}}%.svg]], si les valeurs 0 à 100 expriment les degrés d'avancement d'une opération.

Lors de l'insertion ou l'usage du modèle, le nom du paramètre suivi d'un = apparaît à son rang si l'utilisateur doit fournir la valeur correspondante (la valeur peut aussi être calculée par le modèle ou être donnée par défaut ou par un autre modèle). Une discordance entre le nom du paramètre donné et le nom donné dans le modèle génère une erreur.

[modifier] 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: {{{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).

Voir aussi: les fonctions conditionnelles.

[modifier] Modèles spéciaux

Icône de détail Article détaillé : Aide: Liste des modèles spéciaux.
Note : pour les modèles déclarés par des utilisateurs, voir la liste complète des modèles.

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").

[modifier] Noms de pages et autres fonctions

 Noms de page (exemple donnés pour Wikipédia:Proposition articles de qualité/Linux)
{{NAMESPACE}} le nom de l'espace de noms dans lequel se trouve la page Wikipédia
{{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é/Linux
{{FULLPAGENAME}} le nom de la page avec le préfixe de l'espace de noms Wikipédia: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 Wikipédia:Proposition_articles_de_qualité/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 Wikipédia:Proposition articles de qualité/Linux
{{LINKPAGENAME}} Liste des pages possèdant un lien. Special:Whatlinkshere/Wikipédia:Proposition articles de qualité/Linux
 Fabrication d'URL
{{SERVER}} l'URL du site "http://fr.wikipedia.org"
{{localurl:nom d'une page}} l'URL correspondant à une page "../../../../articles/n/o/m/Nom_d%27une_page.html"
{{localurl:nom d'une page|paramètres}} idem mais avec des paramètres "../../../../articles/n/o/m/Nom_d%27une_page.html"
{{fullurl:nom d'une page}} l'URL complet de la page, correspond à {{SERVER}}{{localurl:nom d'une page}} "http://fr.wikipedia.org../../../../articles/n/o/m/Nom_d%27une_page.html"
{{fullurl:nom d'une page|paramètres}} idem mais avec des paramètres "http://fr.wikipedia.org../../../../articles/n/o/m/Nom_d%27une_page.html"
{{urlencode:modèle d'une page}} permet d'encoder une chaîne de caractères sous forme d'URL "mod%C3%A8le+d%27une+page"
 Autres
{{SITENAME}} le nom du site "Wikipédia"
{{NUMBEROFARTICLES}} le nombre d'articles "672 737"
{{ns:7}} le nom d'un espace de nom d'après son numéro "Discussion_Image"

[modifier] Exemples d'utilisation

{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}|action=edit}} http://fr.wikipedia.org../../../../articles/m/o/d/Aide%7EMod%C3%A8le_9b74.html
{{SERVER}}{{localurl:Special:Whatlinkshere|target={{NAMESPACE}}:{{PAGENAME}}}} http://fr.wikipedia.org../../../../articles/w/h/a/Special%7EWhatlinkshere_6633.html
{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}_1}} http://fr.wikipedia.org../../../../articles/m/o/d/Aide%7EMod%C3%A8le_1_ce78.html
{{fullurl:{{NAMESPACE}}:{{PAGENAME}}_1}} http://fr.wikipedia.org../../../../articles/m/o/d/Aide%7EMod%C3%A8le_1_ce78.html
''Voir : [[{{NAMESPACE}}:{{PAGENAME}}_1|{{NAMESPACE}} {{PAGENAME}} 1]].'' Voir : Aide Modèle 1.
[[{{NAMESPACE}}:{{PAGENAME}}_1]] Aide:Modèle_1
[[{{FULLPAGENAME}}_1]] Aide:Modèle_1

[modifier] Date et heure

[modifier] Changement à minuit, GMT

 Date et heure
{{CURRENTMONTH}} le mois "06"
{{CURRENTMONTHNAME}} le nom du mois "juin"
{{CURRENTMONTHNAMEGEN}} le mois aussi (avec particularité dans certaines langues) "juin"
{{CURRENTDAY}} le jour du mois "18"
{{CURRENTDAYNAME}} le jour de la semaine "mercredi"
{{CURRENTYEAR}} l'année "2008"
{{CURRENTTIME}} l'heure courante "06:49"

[modifier] Changement à minuit, heure d'hiver d'Europe centrale

 Date et heure
{{#time:m|+1hours}} le mois "06"
{{#time:F|+1hours}} le nom du mois "juin"
{{#time:d|+1hours}} le jour du mois "18"
{{#time:l|+1hours}} le jour de la semaine "mercredi"
{{#time:Y|+1hours}} l'année "2008"
{{#time:H:i:s|+1hours}} l'heure courante "07:49:38"
{{#time:H:i:s, l d F Y|+1hours}} la date complète "07:49:38, mercredi 18 juin 2008"

[modifier] Changement à minuit, heure d'été d'Europe centrale

 Date et heure
{{#time:m|+2hours}} le mois "06"
{{#time:F|+2hours}} le nom du mois "juin"
{{#time:d|+2hours}} le jour du mois "18"
{{#time:l|+2hours}} le jour de la semaine "mercredi"
{{#time:Y|+2hours}} l'année "2008"
{{#time:H:i:s|+2hours}} l'heure courante "08:49:38"
{{#time:H:i:s, l d F Y|+2hours}} la date complète "08:49:38, mercredi 18 juin 2008"

[modifier] Les parser functions

Les parser functions sont des modèles « analyseurs » (parser en anglais) qui permettent d'effectuer certaines fonctions selon certains paramètres. Les plus courantes sont #if, qui permet d'afficher 2 textes (ou images) différents en fonction qu'un paramètre est rempli et #switch qui permet de changer un paramètre par un texte ou une image.

Voir plus de détails sur Wikimédia :   Parser Functions

[modifier] Les balises d’inclusion sélective

[modifier] Balisage <noinclude>...</noinclude>

  • Note : cette balise est recommandée dans les modèles

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 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:Espace Modèle]]
[[Catégorie:Exemple]]

[[en:Template:Sample]]
</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).

Ce modèle peut aussi être mis en forme et commenté sur sa propre page de description, sans que cela apparaisse dans les articles qui l’incluent ; par exemple :

''(contenu ''{{{1|}}}'' à compléter...)''<noinclude>
{{Documentation modèle}}
;Utilisation: 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 un article.

; Syntaxe : <code>{{Exemple|1}}</code>
:* <code>1</code> : permet d’ajouter du texte au milieu du contenu affiché par ce modèle (falcultatif, vierge par défaut).

; Exemple : « <code>{{Exemple|de cette section}}</code> » donne <!--
-->« ''(contenu ''de cette section'' à compléter...)'' »

; Voir aussi :
:* [[Aide:Modèle]]

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

[[en:Template:Sample]]
</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 :

Modèle:Exemple

(contenu à compléter...)

informations sur ce modèle

Ci-dessous la documentation de ce modèle. Voir la liste des modèles.

Cliquez ici pour purger le cache lorsque vos modifications n’apparaissent pas.

Utilisation
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 un article.
Syntaxe 
{{Exemple|1}}
  • 1 : permet d’ajouter du texte au milieu du contenu affiché par ce modèle (falcultatif, vierge par défaut).
Exemple 
« {{Exemple|de cette section}} » donne « (contenu de cette section à compléter...) »
Voir aussi 
  • Aide:Modèle

Catégorie : Modèle | Exemple

Autres langues 
English

[modifier] Balisage <includeonly>...</includeonly>

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

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>
{{Documentation modèle}}
;Utilisation: 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 un article.

; Syntaxe : <code>{{Exemple|1}}</code>
:* <code>1</code> : permet d’ajouter du texte au milieu du contenu affiché par ce modèle (falcultatif, vierge par défaut).

; Exemple : « <code>{{Exemple|de cette section}}</code> » donne <!--
-->« ''(contenu ''de cette section'' à compléter...)'' »

; Voir aussi :
:* [[Aide:Modèle]]

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

[[en:Template:Sample]]
</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 articles 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.

[modifier] Documentation d'un modèle

Où documenter ? 
La documentation d’un modèle peut-être faite :
Il faut documenter en sous-page dans les cas suivants :
  1. le modèle est très employé et utilise des paramètres qui prennent de multiples valeurs (il faut alors réduire au minimum le contenu des balises <noinclude>, </noinclude> et surtout, ne pas inclure la documentation).
  2. le modèle et sa documentation sont particulièrement longs.
  3. on souhaite rependre (ie., inclure) la documentation dans une page d’aide.
  4. avant de protéger un modèle, il faut déplacer sa documentation en sous-page
Comment documenter sous le modèle ? 
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 documenter un modèle déjà existant, copiez, collez et adaptez l’un des codes ci-dessous à la fin de la source d’un modèle (c’est-à-dire juste avant son dernier saut de ligne existant, et sans aucun autre saut de ligne inutile ajouté après).
Pour un "petit" modèle simple, sans paramètres nommés, "sur une ligne", et avec un exemple :
<noinclude><!--
  NE PAS insérer de blanc ou de saut de ligne dans la ligne précédente, sinon cela fausse les résultats !
-->
{{Documentation modèle}}

; Utilisation : <!--indiquez quand utiliser ce modèle-->.

; Syntaxe : <code><nowiki>{{</nowiki>{{PAGENAME}}|1|2|etc.}}</code>
:* <code>1</code> : description1 (obligatoire).
:* <code>2</code> : description2 (facultatif, ''défaut2'' par défaut).
:* etc.

; Exemple : « <code><nowiki>{{</nowiki>{{PAGENAME}}|<!-- à compléter -->}}</code> » donne <!--
-->« {{{{PAGENAME}}|<!-- à compléter à l’identique -->}} »<!--pour un modèle simple (sur un ligne) -->

; Variante
:* {{M|<!--nom de modèle connexe-->}}

; Voir aussi
:* [[<!--nom de page à voir-->]]

[[Catégorie:Nom de la catégorie du modèle|{{PAGENAME}}]]

[[de:Template:Nom du modèle germanophone équivalent]]
[[en:Template:Nom du modèle anglophone équivalent]]
[[es:Template:Nom du modèle hispanophone équivalent]]
[[it:Template:Nom du modèle italophone équivalent]]
</noinclude>
Pour un modèle plus complexe (avec arguments nommés) :
<noinclude><!--
  NE PAS insérer de blanc ou de saut de ligne dans la ligne précédente, sinon cela fausse les résultats !
-->
{{Documentation modèle}}

; Utilisation :
: <!--indiquez quand utiliser ce modèle-->.

; Syntaxe :
 <nowiki>{{</nowiki>{{PAGENAME}}
 |paramètre1=valeur1
 |paramètre2=valeur2
 |paramètre3=valeur3
 |etc.
 }}

; Paramètres :
:* <code>paramètre1</code> : description1 (obligatoire).
:* <code>paramètre2</code> : description2 (facultatif, ''défaut2'' par défaut).
:* <code>paramètre3</code> : description3 (optionnel, lorsque <code>paramètre2</code> est fourni, ''défaut3'' par défaut).
:* etc.

; Exemple :
{{Entête tableau "Code Rendu"}}
|-
|<pre><!-- le même code --></pre>
|<!-- le même code -->
|}

; Variante
:* {{M|<!--nom de modèle connexe-->}}

; Voir aussi
:* [[<!--nom de page à voir-->]]

[[Catégorie:Nom de la catégorie du modèle|{{PAGENAME}}]]

[[de:Template:Nom du modèle germanophone équivalent]]
[[en:Template:Nom du modèle anglophone équivalent]]
[[es:Template:Nom du modèle hispanophone équivalent]]
[[it:Template:Nom du modèle italophone équivalent]]
</noinclude>
Comment documenter dans la sous-page du modèle ? 
Copiez, collez et adaptez le code ci-dessous, directement sous la source du modèle
<noinclude>
{{/Documentation}}<!-- Métadonnées (catégories, interwikis, …) en sous-page de documentation -->
</noinclude>
Puis cliquez sur le lien rouge pour éditer la page. La documentation demeure globalement semblable.
Pour un modèle simple :
{{Documentation modèle en sous-page}}

; Utilisation : <!--indiquez quand utiliser ce modèle-->.

; Syntaxe : <code><nowiki>{{</nowiki>{{PAGENAME}}|1|2|etc.}}</code>
:* <code>1</code> : description1 (obligatoire).
:* <code>2</code> : description2 (falcultatif, ''défaut2'' par défaut).
:* etc.

; Exemple : « <code><nowiki>{{</nowiki>{{PAGENAME}}|<!-- à compléter -->}}</code> » donne <!--
-->« {{ {{PAGENAME}}|<!-- à compléter à l'identique -->}} »<!--pour un modèle simple (sur un ligne) -->

; Variante
:* {{M|<!--nom de modèle connexe-->}}

; Voir aussi
:* [[<!--nom de page à voir-->]]

<includeonly>
<!-- Catégories et interwikis du modèle -->
[[Catégorie:Nom de la catégorie du modèle|{{PAGENAME}}]]

[[de:Template:Nom du modèle germanophone équivalent]]
[[en:Template:Nom du modèle anglophone équivalent]]
[[es:Template:Nom du modèle hispanophone équivalent]]
[[it:Template:Nom du modèle italophone équivalent]]
</includeonly>
Pour un modèle plus complexe (avec arguments nommés) :
{{Documentation modèle compliqué en sous-page}}


; Utilisation
: <!--indiquez quand utiliser ce modèle-->.

; Syntaxe
 <nowiki>{{</nowiki><!-- nom du modèle -->
 |paramètre1={{Param|valeur1}}
 |paramètre2={{Param|valeur2}}
 |paramètre3={{Param|valeur3}}
 |etc.
 }}

; Paramètres
:* <code>paramètre1</code> : description1 (obligatoire).
:* <code>paramètre2</code> : description2 (facultatif, ''défaut2'' par défaut).
:* <code>paramètre3</code> : description3 (optionnel, lorsque <code>paramètre2</code> est fourni, ''défaut3'' par défaut).
:* etc.

; Exemple :
{{Entête tableau "Code Rendu"}}
|-
|<pre><!-- le même code --></pre>
|<!-- le même code -->
|}

; Variante
:* {{M|<!--nom de modèle connexe-->}}

; Voir aussi
:* [[<!--nom de page à voir-->]]

<includeonly>
<!-- Catégories et interwikis du modèle -->
[[Catégorie:Nom de la catégorie du modèle|{{PAGENAME}}]]

[[de:Template:Nom du modèle germanophone équivalent]]
[[en:Template:Nom du modèle anglophone équivalent]]
[[es:Template:Nom du modèle hispanophone équivalent]]
[[it:Template:Nom du modèle italophone équivalent]]
</includeonly>
Exemples de modèles bien documentés


[modifier] 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.

[modifier] Modèles utilisateur

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é « Article fastidieux », il procède comme suit :

  • il crée une sous-page utilisateur Utilisateur:Quidam/Article fastidieux dans laquelle il écrit le modèle :
<div style="border:1px solid black;background:rgb(80%,100%,80%);text-align:center;padding=0.4ex;">
''Ceci est un article fastidieux. Le taux d'ennui est estimé à {{{ennui}}}%.''
</div>
  • il l'utilise ensuite dans ses pages et sous-pages personnelles en tapant :
{{Utilisateur:Quidam/Article fastidieux|ennui=55}}

ce qui donne :

Ceci est un article fastidieux. 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 noms:nom d’article|paramètre1=valeur1}}

reconnait la présence de l’espace de noms:, qui ne prend la valeur par défaut Modèle: que quand l'espace de noms 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.

[modifier] Problèmes fréquents sur les pages contenant des modèles

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 :

[http://fr.wikipedia.org/w/index.php?title=nom de la page&action=purge rafraîchir la page] 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 :

  1. Si c'est un problème ponctuel, faire une modification vide sur la page (cliquer sur « Modifier » puis sur « Publier » sans rien changer : rien n'apparaît dans l'historique mais la table des liens est mise à jour)
  2. Si c'est un problème récurrent, ou si de nombreuses pages sont concernées : demander à un robot de passer régulièrement sur la page concernée en utilisant le script touch.py. Déposez votre requête sur Wikipédia:Bot/Requêtes.

Les développeurs ont été mis au courant de tous ces problèmes sur la page Bugzilla N°939.

[modifier] Voir aussi