« Aide:Modèles » : différence entre les versions

De Wikimedica
(Suppression de contenu non pertinent)
(Adaptation)
Ligne 1 : Ligne 1 :
__TOC__
__TOC__{{Index de l'aide de Wikimedica}}
 
Un modèle est une page spéciale construite pour permettre la réutilisation de son contenu sur d'autres pages. En d'autres mots, il est un élément réutilisable. Wikimedica fait l'usage de [[Spécial:Modèles|plusieurs centaines de modèles]], vous en avez d'ailleurs plusieurs sous les yeux alors que vous consultez cette page.
 
== Comprendre ce qu'est un modèle par l'exemple ==
== Comprendre ce qu'est un modèle par l'exemple ==


Ligne 10 : Ligne 13 :
Ce contenu n'est pas enregistré dans le texte de l'article, mais dans la page [[Modèle:Article détaillé]]. Celle-ci est utilisée par l'article, il charge le contenu de la page ''Modèle:'' pour l'afficher. Chaque texte entre <code><nowiki>{{ }}</nowiki></code> correspond donc à une page existante commençant par ''Modèle:''.
Ce contenu n'est pas enregistré dans le texte de l'article, mais dans la page [[Modèle:Article détaillé]]. Celle-ci est utilisée par l'article, il charge le contenu de la page ''Modèle:'' pour l'afficher. Chaque texte entre <code><nowiki>{{ }}</nowiki></code> correspond donc à une page existante commençant par ''Modèle:''.


== Comment trouver rapidement un modèle existant ? ==
== Comment modifier ou créer un modèle ? ==
 
{{Boîte
Pour retrouver rapidement un modèle existant, écrivez « Modèle:<nom du modèle> » (sans les balises <nowiki>{{ }}</nowiki>) dans le champ de recherche.
| contenu = Si vous désirez modifier un modèle ou sa documentation et ne savez pas comment vous y prendre, demandez à un {{Liste des administrateurs|texte = administrateur}}.
 
| type = information
La liste des modèles utilisés dans une page est présente :
}}
* en sélectionnant « modifier le code » : sous le titre ''Modèles utilisés par cette page'' en bas de page, en dessous des boutons « Publier les modifications », « Prévisualiser », etc.
Pour modifier un modèle, il suffit de se rendre sur sa page (préfixée par <code>Modèle:</code>). Vous pouvez y accéder à même l'interface de l'[[Aide:Éditeur Visuel|Éditeur Visuel]] à partir du formulaire d'ajout de modèle, ou du menu « {{Mediawiki:visualeditor-pagemenu-tooltip}} » [[Fichier:VisualEditor - Icon - Menu.svg|24x24px|lien=https://wikimedi.ca/wiki/Fichier:VisualEditor_-_Icon_-_Menu.svg]], puis « {{MediaWiki:Visualeditor-templatesused-tool}} ». Malheureusement, l'Éditeur Visuel n'est pas disponible pour les pages de modèles, la raison étant la présence de syntaxe beaucoup trop complexe sur ces dernières. C'est aussi pour cette raison que l'aide de Wikimedica n'abordera pas la création de modèles. Cependant, Wikipédia possède une [https://fr.wikipedia.org/wiki/Aide:Cr%C3%A9er_un_mod%C3%A8le page à ce sujet], vous trouverez toute l'information necéssaire.
* en sélectionnant « Information sur la page » : sous le titre ''Propriétés de la page''.
 
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].
 
On peut aussi le rechercher dans la [[:Catégorie:Espace Modèle]].
 
== 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 <code><nowiki>{{Merci}}</nowiki></code>, 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>}} .
 
=== 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]] : exemple avec {{m|boîte déroulante}} : {{nobr|<code><nowiki>{{</nowiki>boîte déroulante{{!}} titre {{=}} {{Param|titre voulu}} {{!}} couleur {{=}} {{Param|couleur choisie}} <nowiki>}}</nowiki></code>}}.
 
Pour plus de 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.
 
La substitution ne fonctionne pas entre les balises <nowiki><ref></ref></nowiki> utilisées pour les [[Aide:Insérer une référence|références]], il s'agit d'un bug connu, voir [https://phabricator.wikimedia.org/T4700 T4700] et [https://gerrit.wikimedia.org/r/#/c/272916/ gerrit:272916].
 
=== Deux types particuliers : les palettes et les infobox ===
 
{{Article détaillé|Aide:Palette de navigation}}
Les palettes de navigation sont des tableaux déroulants 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. Il en existe plusieurs générations, les dernières versions (V2 et V3) étant construites sur un [[Projet:Infobox/Didacticiel infobox modulaire|modèle modulaire]].
 
{{Article détaillé|Aide:Taxobox}}
Les [[Aide:Taxobox|taxobox]] sont une variante des infobox modulaires de [[Projet:Infobox/V3|type V3]].
 
=== 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.}}
 
* ''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]].
 
=== Insérer un lien vers un modèle ===
 
Pour donner un lien vers un modèle, on peut utiliser {{m|m}}.
 
== Comment créer un modèle ? ==
{{Article détaillé|Aide:Créer un modèle}}
 
== Comment modifier un modèle ? ==
Dans un cas standard, l'accès au code s'obtient via l'onglet "''Modifier le code''" à partir de la page <code><nowiki>Modèle:Nom du modèle</nowiki></code>. Dans le cas où le modèle est codé en [[Lua]], il existe une page [[Aide:Module|module]] dédiée.
Il est conseillé de recopier le contenu du modèle dans la sous-page <code>/Bac à sable</code> du modèle ({{nobr|<code>Modèle:{{Param|Nom du modèle/Bac à sable}}</code>}}), d'y effectuer sa modification et de la tester dans la sous-page de test ({{nobr|<code>Modèle:{{Param|Nom du modèle/Test}}</code>}}).
 
Un lien à ces deux pages se trouve en bas du modèle de documentation.
 
== Comment documenter un modèle ? ==
 
{{Article détaillé|Aide:Documentation de modèle|contenu=Article détaillé : [[Aide:Documentation de 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.
 
=== Lien interlangue ===
{{Encart|important|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]].}}
 
 
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 [[Aide:Créer un modèle#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.
 
Tous les modèles sont classés dans les sous-catégories de la [[:Catégorie:Espace Modèle]].
 
=== 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).
Depuis 2013 ou 2014, si l'on modifie en wikicode tout l'article, avec une [[Aide:Prévisualisation|pré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 ».
 
Remarque : Les fonctions considérées comme dispendieuses sont, en août 2012 : <code><nowiki>{{#ifexist:...}} {{PAGESINCATEGORY:...}} {{PAGESINCAT:...}}  {{PAGESIZE:...}}</nowiki></code>
 
[[Catégorie:Aide:Modèle|*]]

Version du 10 août 2018 à 18:02

Un modèle est une page spéciale construite pour permettre la réutilisation de son contenu sur d'autres pages. En d'autres mots, il est un élément réutilisable. Wikimedica fait l'usage de plusieurs centaines de modèles, vous en avez d'ailleurs plusieurs sous les yeux alors que vous consultez cette page.

Comprendre ce qu'est un modèle par l'exemple

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'article Loup dans la culture qu'il existe un article détaillé sur le Loup 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 :

Le rendu sur la page : Modèle:Article détaillé

Cette présentation est ainsi obtenue en quelques secondes, sans avoir à saisir à chaque fois les lignes de code qui insèrent successivement l'icône d'une loupe (trouvée dans la base de données Commons), des séparateurs, un texte, un lien interne, des variantes typographiques, etc., le tout avec l'assurance de respecter l'aspect visuel requis dans tous les articles pour ce type d'avertissement, voté par la communauté.

Ce contenu n'est pas enregistré dans le texte de l'article, mais dans la page Modèle:Article détaillé. Celle-ci est utilisée par l'article, il charge le contenu de la page Modèle: pour l'afficher. Chaque texte entre {{ }} correspond donc à une page existante commençant par Modèle:.

Comment modifier ou créer un modèle ?

Si vous désirez modifier un modèle ou sa documentation et ne savez pas comment vous y prendre, demandez à un administrateur.

Pour modifier un modèle, il suffit de se rendre sur sa page (préfixée par Modèle:). Vous pouvez y accéder à même l'interface de l'Éditeur Visuel à partir du formulaire d'ajout de modèle, ou du menu « Options de page » , puis « Modèles utilisés ». Malheureusement, l'Éditeur Visuel n'est pas disponible pour les pages de modèles, la raison étant la présence de syntaxe beaucoup trop complexe sur ces dernières. C'est aussi pour cette raison que l'aide de Wikimedica n'abordera pas la création de modèles. Cependant, Wikipédia possède une page à ce sujet, vous trouverez toute l'information necéssaire.