Unmodèle sert à reproduire sur plusieurs pages le même message, ou la mêmemise en page, parfois en fonction de paramètres.
Il s'agit d'un élément pré-écrit, plus ou moins complexe, destiné à être incrusté dans une page afin d'obtenir instantanément le résultat visuel souhaité (formatage, affichage d'éléments spécifiques, etc.). Lesbandeaux en haut des articles, lesinfobox, l'affichage des siècles... sont des modèles.
Enwikicode, un modèle est délimité par des doubles accolades, « {{ » et « }} » ; l'éditeur visuel le caractérise par une pièce de puzzle.
Un modèle est lié à une page de l'espace de noms « Modèle ». Il est souvent symbolisé dans les discussions par son nom entouré de{{ et}}.
Les modèles sont accessibles en édition par tous les contributeurs, c'est pourquoi il est nécessaire de les documenter. Il faut aussi les retoucher avec prudence, car une modification apparaît sur de nombreuses pages (parfois plusieurs milliers) et provoque sur les serveurs des mises à jour decache en cascade[1].
Prenons comme exemple le modèle « {{Article détaillé}} » qui est inséré dans une page en utilisant la syntaxe{{article détaillé|article 1|article 2}}. On l'utilise pour indiquer par exemple dans l'articleLoup dans la culture qu'il existe un article détaillé sur leLoup dans la culture européenne, on insère le code{{article détaillé|Loup dans la culture européenne}} à l'emplacement où le bandeau doit apparaître :
Ce contenu n'est pas enregistré dans le texte de l'article, mais dans la pageModèle:Article détaillé. Celle-ci est utilisée par l'article, il charge le contenu de la pageModèle: pour l'afficher. Chaque texte entre{{ }} correspond donc à une page existante commençant parModèle:.
Pour retrouver rapidement un modèle existant, écrivez « Modèle:<nom du modèle> » (sans les balises {{ }}) dans le champ de recherche.
La liste des modèles utilisés dans une page est présente :
en sélectionnant « modifier le code » : sous le titreModèles utilisés par cette page en bas de page, en dessous des boutons « Publier les modifications », « Prévisualiser », etc. ;
en sélectionnant « Information sur la page » : sous le titrePropriétés de la page.
Pour insérer un modèle, il faut effectuer un appel par des doubles accolades en suivant lasyntaxe :{{Nom du modèle}}. Par exemple, en saisissant{{Merci}}, le contenu duModèle:Merci est affiché sur une page : « Merci ». Les modifications deModèle:Merci s’appliquent sur les diverses pages où est inséré le modèle.
Les modèles, comme tous les articles de Wikipédia, sontindifférents à la casse uniquement pour leur lettre initiale :{{Nom du modèle}} est équivalent à{{nom du modèle}} mais pas à{{NOM DU MODÈLE}}.
Certains modèles (par exemple{{Article détaillé}}) ont besoin deparamètres pour adapter leur comportement. Ces paramètres, obligatoires ou facultatifs, sont séparés par desbarres verticales (|). Ces paramètres peuvent être soit :
positionnels, qui sont renseignés les uns à la suite des autres :{{Nom du modèle |Paramètre 1 |Paramètre 2…}};
nommés, identifiés par leur nom : exemple avec{{boîte déroulante}} :{{boîte déroulante| titre =titre voulu | couleur =couleur choisie }}, les paramètres sonttitre etcouleur.
La substitution permet de remplacer l’appel au modèle{{Nom du modèle}} par le code du modèle (c’est-à-dire le patron du modèle). Elle s’effectue par la syntaxe{{subst:Nom du modèle}}. Il n’est généralement pas nécessaire de substituer un modèle car, si le modèle d’origine est modifié, les substitutions ne le sont pas. La substitution n’a pas vocation à être utilisée dans les articles. À noter qu’il n’existe aucune norme sur l’usage dusubst: et que son utilisation doit donc être réfléchie.
Un modèle contenant un lien temporaire ou susceptible de changer devrait être ajouté par{{subst:Nom du modèle}}. Un exemple d’utilisation de la substitution est lors de l’ajout de{{Bienvenue nouveau}} sur la page de discussion d’un nouvel utilisateur ; ce dernier pourra alors, en modifiant sa page, prendre pleinement conscience de lasyntaxe utilisée sur le site.
La substitution ne fonctionne pas entre les balises <ref></ref> utilisées pour lesréférences, il s'agit d'un bug connu, voirT4700 etgerrit:272916.
Deux types particuliers : les palettes et les infobox
Les infobox sont des tableaux qui se placent en haut à droite d’un article. Il en existe plusieurs générations, les dernières versions (V2 et V3) étant construites sur unmodèle modulaire.
Dans un cas standard, l'accès au code s'obtient via l'onglet « Modifier le code » à partir de la pageModèle:Nom du modèle. Les cas où le modèle est codé enLua sont traités dans la pagemodule.Il est conseillé de recopier le contenu du modèle dans la sous-page/Bac à sable du modèle (Modèle:Nom du modèle/Bac à sable), d'y effectuer sa modification et de la tester dans la sous-page de test (Modèle:Nom du modèle/Test).
Un lien à ces deux pages se trouve en bas du modèle de documentation.
Sur la page du modèle, avant modification, on peut cliquer sur l’hyperlien « Pages liées » du menu de gauche pour consulter les pages utilisant le modèle et vérifier qu’elles ne seront pas perturbées.
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 desconventions sur les titres aussi dans les noms de modèle.
Ce paragraphe d'aide décrit les liens interlangues situés dans le texte des pages de Wikipédia, utilisés pour les catégories et les modèles notamment. Depuis le 6 mars 2013,les articles utilisentWikidata pour générer les liens interlangues. Vous pouvez consulter la page donnant lesinstructions pour modifier les liens interlangues via Wikidata.
Si le modèle contient unlien interlangue, 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 interlangue vers une même autre langue se trouvent dans une page, le résultat est imprévisible. On évitera ces conflits en utilisantles balises d’exclusion sélective et d’inclusion sélective.
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é. Il faut toutefois une mise à jour du cache de chaque page.
Attention : le nombre d'appels à certainesParserFunctions est plafonné à 500 par article, au-delà, on se heurte au message suivant : « Attention : Cette page contient trop d'inclusions de modèles. Certaines inclusions ne seront pas effectuées. », ou à celui-ci : « Attention : cette page contient de trop nombreux appels à des fonctions coûteuses de l'analyseur syntaxique. Il devrait y avoir moins de500 appels, alors qu'il y en a maintenantxxx. ». Il faut alors envisager de simplifier et limiter le nombre d'appels aux modèles, ou descinder l'article.
On peut trouver le nombre d'appels de fonctions parseurs dans un article en recherchant « Expensive parser function count: » dans le codeHTML généré (voirCatégorie:Page avec trop d'appels dispendieux de fonctions parseurs pour les articles concernés).Depuis 2013 ou 2014, si l'on modifie en wikicode tout l'article, avec uneprévisualisation, en bas de la page apparait une section « Données d’optimisation de l’analyseur » présentant un tableau avec la ligne « Nombre de fonctions d’analyse coûteuses ».
(fr)Templatecount permet de connaître le nombre de pages dans lesquelles le modèle est inclus.
(fr)wstat.fr permet de prendre connaissance d'un certain nombre de statistiques concernant un modèle : le nombre de paramètres, le nombre de pages où ce modèle est inclusdirectement, les paramètres utilisés, la liste des articles qui utilisent des paramètres en double ou inexistants. Attention.
Ce site ne présente que les pages où le modèle est utilisé directement, c'est-à-dire le nombre de fois où son nom ou celui d'une de ses redirections est utilisé. Si c'est un second modèle qui l'utilise, les inclusions de ce second modèle ne sont pas comptées. Il est ainsi possible de savoir quelle est la charge de travail en cas de modification du modèle. Exemple : (à venir)
Par défaut, les statistiques ne prennent pas en compte les pages utilisateur et discussion ; cliquez sur le lien « Avec utilisateur: et discussion* » pour les prendre en compte.
