Arthur : 1 version

2013-08-18T14:23:53Z

1 version

Nouvelle page

{{Confusion|texte=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 [[Aide:Liste de modèles]].}}

{{Navigation Modèle}}

Un '''modèle''' est un code délimité par « <code>{{</code> » et « <code>}}</code> » lié à une page de l'[[Aide:Espace de noms|espace de noms]] « Modèle ».

Par exemple, le code « <nowiki>{{Article détaillé}}</nowiki> » insère le modèle [[Modèle:Article détaillé]].

Il sert à reproduire sur plusieurs pages le même message, ou la même [[mise en page]], parfois en fonction de paramètres.

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 de [[Mémoire cache|cache]] en cascade <ref>La mise à jour de la [[Mémoire cache|cache]] en cascade sur les serveurs est aussi appelée [[mw:Manual:Job queue/fr|{{citation|job queue}}]].</ref>.

== Comment utiliser un modèle ? ==

Pour insérer un modèle, il faut effectuer un appel par des doubles accolades en suivant la [[Aide:syntaxe|syntaxe]] : {{nobr|<code><nowiki>{{Nom du modèle}}</nowiki></code>}}. Par exemple, en saisissant <nowiki>{{Merci}}</nowiki>, le contenu du [[Modèle:Merci]] est affiché sur une page : « {{Merci}} ». Les modifications de [[Modè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, sont [[Sensibilité à la casse|indifférents à la casse]] uniquement pour leur lettre initiale : {{nobr|<code><nowiki>{{Nom du modèle}}</nowiki></code>}} est équivalent à {{nobr|<code><nowiki>{{nom du modèle}}</nowiki></code>}} mais pas à {{nobr|<code><nowiki>{{NOM DU MODÈLE}}</nowiki></code>}} .

Les modèles sont groupés dans un [[Aide:Espace de noms|espace de noms]] « ''Modèle:'' ». En voici une [{{fullurl:Special:Allpages|from=&namespace=10}} liste alphabétique].

=== Paramètres ===

Certains modèles (par exemple {{m|Article détaillé}}) ont besoin de [[paramètre]]s pour adapter leur comportement. Ces paramètres, obligatoires ou facultatifs, sont séparés par des [[barre verticale|barres verticales]] ('''<code>|</code>'''). Ces paramètres peuvent être soit :
* positionnels, qui sont renseignés les uns à la suite des autres : {{nobr|<code><nowiki>{{Nom du modèle | </nowiki>{{Param|Paramètre 1}}<nowiki> |</nowiki> {{Param|Paramètre 2}}<nowiki>…}}</nowiki></code>}}.

*[[Paramètre#Paramètre nommé|nommés]] : {{nobr|<code><nowiki>{{</nowiki>Boîte{{!}} titre {{=}} {{Param|titre voulu}} {{!}} couleur {{=}} {{Param|couleur choisie}} <nowiki>}}</nowiki></code>}}.

Pour plus détails sur les paramètres, se reporter au [[Aide:Créer un modèle#Modèles à paramètres|chapitre ''Modèles à paramètres'']].

=== Substitution ===

La substitution permet de remplacer l’appel au modèle {{nobr|<code><nowiki>{{Nom du modèle}}</nowiki></code>}} par le code du modèle (c’est-à-dire le patron du modèle). Elle s’effectue par la syntaxe {{nobr|<code><nowiki>{{subst:Nom du modèle}}</nowiki></code>}}. 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 du <code>subst:</code> 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 {{nobr|<code><nowiki>{{subst:Nom du modèle}}</nowiki></code>}}. Un exemple d’utilisation de la substitution est lors de l’ajout de {{m|Bienvenue nouveau}} sur la page de discussion d’un nouvel utilisateur ; ce dernier pourra alors, en modifiant sa page, prendre pleinement conscience de la [[Aide:syntaxe|syntaxe]] utilisée sur le site.

=== Deux types particuliers : les palettes et les infobox ===

{{Article détaillé|Aide:Palette de navigation}}
Les palettes de navigations sont des tableaux déroulant qui se placent en bas d’un article.

{{Article détaillé|Aide:Infobox}}
Les infobox sont des tableaux qui se placent en haut à droite d’un article.

=== Modèles spéciaux ===
{{Article détaillé|Aide:Liste des modèles spéciaux}}

Certains modèles permettent d’avoir la date, l’heure{{nobr|, etc.}}

Pour donner un lien vers un modèle, on peut utiliser {{m|m}}.

* ''Note :'' Pour les modèles déclarés par des utilisateurs, voir [[Spécial:Toutes_les_pages/Modèle:|la liste complète des modèles]].

== Comment trouver rapidement un modèle existant ? ==

Pour retrouver rapidement un modèle existant, écrivez « Modèle:<nom du modèle> » (sans les balises <nowiki>{{ }}</nowiki>) dans le champ de recherche.

La liste des modèles utilisés dans une page est présente, le cas échéant, sous le titre ''Modèles utilisés par cette page'' dans la fin de l'onglet « modifier » après le bouton « Publier ». Des liens vers chaque modèle vous sont alors proposés.

== Comment créer un modèle ? ==
{{Article détaillé|Aide:Créer un modèle}}

== Comment documenter un modèle ? ==

{{Article détaillé|Aide:Comment documenter un modèle ?|contenu=Article détaillé : [[Aide:Comment documenter un modèle ?]]}}

== Remarques et astuces ==

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 des [[Wikipédia:conventions sur les titres|conventions sur les titres]] aussi dans les noms de modèle.

{{pas clair
|1=Dans un modèle, des liens de type externe menant à des pages internes sont parfois utilisés afin d’éviter qu’on aboutisse sur la page en mode d’édition même si cette page existe.
|2=Qu'est-ce que ça veut dire ?}}

=== Lien interlangue ===
{{Méta bandeau d'avertissement
| niveau = modéré
| icône = Nuvola apps important.svg
| titre =
| texte = <big>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 utilisent [[Wikidata]] pour générer les liens interlangues'''. Vous pouvez consulter la page donnant les [[Wikipédia:Wikidata#Gestion des liens sous Wikidata|instructions pour modifier les liens interlangues via Wikidata]].</big>}}

Si le modèle contient un [[Aide:lien interlangue|lien 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 utilisant [[#Les balises d’inclusion sélective|les balises d’inclusion sélective]].

=== Catégorisation ===
Si le modèle appartient à une catégorie (c’est-à-dire que la page du modèle contient un libellé de la forme <nowiki>[[Catégorie:Nom d'une catégorie]]</nowiki>) et si l’on ne fait pas simultanément usage de la balise d’inclusion sélective {{Balise|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.

=== Limites ===

Attention : le nombre d'appels aux [[mw:Help:Extension:ParserFunctions|ParserFunctions]] est plafonné à 500 par article, au-delà on a un message « {{rouge|Attention : Cette page contient trop d'inclusions de modèles. Certaines inclusions ne seront pas effectuées.}} » ou « {{rouge|Attention : cette page contient de trop nombreux appels à des fonctions coûteuses de l'analyseur syntaxique. Il devrait y avoir moins de 500 appels, alors qu'il y en a maintenant ''xxx''.}} ». Il faut alors envisager de simplifier et limiter le nombre d'appels aux modèles, ou de [[Aide:Scission|scinder]] l'article (voir [[:en:Wikipedia:Template limits]]).

On peut trouver le nombre d'appels de fonction parser dans un article en recherchant « <code>Expensive parser function count:</code> » dans le code [[HTML]] généré (voir [[:Catégorie:Page avec trop d'appels dispendieux de fonctions parseurs]] pour les articles concernés).

Remarque : Les fonctions considérées comme dispendieuses sont, en août 2012 : <code><nowiki>{{#ifexist:...}} {{PAGESINCATEGORY:...}} {{PAGESINCAT:...}} {{PAGESIZE:...}}</nowiki></code>

== Annexes ==
=== Voir aussi ===

{{Autres projets
| commons = 
| commons titre = 
| commons2 = 
| commons titre2 = 
| wikispecies = 
| wikispecies titre = 
| wiktionary = Aide:Modèle
| wiktionary titre = Aide:Modèle
| wikiversity = 
| wikiversity titre = 
| wikibooks = Aide:Modèle
| wikibooks titre = Aide:Modèle
| wikisource = 
| wikisource titre = 
| wikiquote = 
| wikiquote titre = 
| wikinews = 
| wikinews titre = 
| meta = 
| meta titre = 
}}
* [[Aide:Modèles courants]] : les modèles les plus rencontrés.
* [[Wikipédia:Bac_à_sable#Et_si_vous_voulez_tester_les_modèles|Bac à sable]] (pour s’entraîner à l’utilisation des modèles).
* [[Aide:Créer un modèle]] (mode d'emploi pour créer un modèle)
* [[Modèle:Bac à sable]] (pour s'entraîner à la création des modèles).

===Notes et références===
<references />
{{Palette|Aide}}

[[Catégorie:Aide:Modèle|*]]

Aide:Modèle - Historique des versions

Arthur : 1 version

Arthur : 1 version