Wikipédia : espace de noms de modèle

Un article de Wikipédia, l'encyclopédie libre
Aller à la navigation Aller à la recherche

L' espace de noms Template sur Wikipedia est utilisé pour stocker des modèles , qui contiennent un balisage Wiki destiné à être inclus sur plusieurs pages, généralement via la transclusion . Bien que l'espace de noms Template soit utilisé pour stocker la plupart des modèles, il est possible de transclure et de remplacer d'autres espaces de noms, [1] et ainsi certaines pages de modèles sont placées dans d'autres espaces de noms, tels que l' espace de noms User .

Les modèles aident à maintenir une mise en forme cohérente et facilitent la navigation entre les articles. Ils comprennent souvent des éléments facultatifs et/ou variables contrôlés par des paramètres pour permettre une utilisation spécialisée. Les modèles sont également utilisés pour aider dans une grande variété de tâches de maintenance de Wikipédia . Chaque modèle a une Template talk:page correspondante où les éditeurs peuvent discuter de la conception et de la mise en œuvre du modèle associé (voir Aide : Utilisation des pages de discussion pour savoir comment participer aux discussions des pages de discussion).

Un modèle est transclus dans une autre page en incluant une balise de modèle dans le contenu de cette page. Une balise de modèle contient le nom de la page du modèle entouré de doubles accolades, par exemple {{Disambiguation}}. Si le nom de la page du modèle ne commence pas par un espace de noms et deux-points, il est supposé se trouver dans l'espace de noms du modèle.

Des liens internes vers des pages modèles peuvent être créés en utilisant le Template:préfixe, par exemple [[Template:Disambiguation]]. Ces liens mènent à une page qui contient directement un modèle de base et souvent de la documentation .

Des lignes directrices

  • Les modèles ne doivent normalement pas être utilisés pour stocker le texte de l'article , car cela rend plus difficile la modification du contenu. Ils ne doivent pas non plus être utilisés pour « réduire » ou « masquer » le contenu du lecteur.
  • Les modèles utilisés dans les articles sont conçus pour fournir des informations destinées à aider les lecteurs, telles que des aides à la navigation, la mise en forme ou des avertissements indiquant que le contenu n'est pas conforme aux normes. Les modèles qui fournissent des informations uniquement utiles aux éditeurs ne doivent pas apparaître sur les pages d'articles - utilisez la page de discussion de l'article ou d'autres espaces de noms non liés à l'article.
  • La fonction de modèle doit être claire à partir du nom du modèle , mais des redirections peuvent être créées pour faciliter l'utilisation quotidienne de modèles très populaires.
  • Les modèles à haut risque doivent être semi-protégés, protégés par modèle ou entièrement protégés, selon le cas (voir Wikipedia:Politique de protection ). Cela s'applique également à toutes les redirections de modèles très utilisées.
  • Les modèles doivent être clairement documentés quant à leur utilisation et leur portée.
  • Les modèles ne doivent pas être utilisés pour créer des listes de liens vers d'autres articles lorsqu'une catégorie , une page de liste ou une liste de section "Voir aussi" peut remplir la même fonction.
  • Les modèles de messages courts et temporaires qui seront supprimés rapidement (comme sur les pages User_talk:) ou qui contiennent du texte qui ne sera probablement jamais modifié doivent être invoqués avec substitution (subst:). Les modèles typiques destinés à une utilisation à long terme et susceptibles de nécessiter des modifications doivent être transclus pour faciliter les mises à jour futures.
  • Les modèles qui enfreignent les directives de cette page, ont une fonction mal définie, sont redondants, deviennent orphelins ou utilisés sur une seule page, ou enfreignent d'autres politiques de Wikipédia peuvent être proposés pour suppression sur Wikipédia : Modèles de discussion .

Pratiques suggérées

Modèles de référencement

Parfois, vous voudrez vous référer à un modèle, plutôt que de l'invoquer réellement. Un moyen simple de le faire est d'appeler Template:Tl (abréviation de "template link"). Par exemple, pour référencer le modèle de nettoyage, saisissez les {{tl|Cleanup}}résultats dans {{ Cleanup }}. Vous pouvez également ajouter des paramètres en utilisant Template:Tlp ; par exemple, {{tlp|Convert|1|m}}s'affiche sous la forme {{ Convert |1|m}} .

Consultez la documentation du modèle sur Template:Tl pour d'autres options, telles que {{ tlb }} (gras), (code), (paramètres en italique) et bien d'autres. {{tlx}}{{tlxi|param1|param2}}

Noms des modèles

Les noms de modèle peuvent être composés d'un ou plusieurs mots, tels que {{Train topics}}. Le premier caractère (uniquement) n'est pas sensible à la casse, donc {{cleanup}}et {{Cleanup}}sont le même modèle, mais {{cfd}}et {{cfD}}ne le sont pas. Les noms de modèle sont plus faciles à retenir s'ils suivent l'orthographe, l'espacement et la casse en anglais standard (voir également les conventions de dénomination des articles). Évitez d'avoir des modèles dont les noms ne diffèrent que par la casse, l'espacement ou la ponctuation.

Bac à sable pour les expériences

Si vous souhaitez expérimenter avec des modèles (et ne pas supprimer vos expériences avant d'en avoir fini avec eux), vous pouvez le faire dans la sandbox Modèle . Vous pouvez également utiliser les modèles X1 , X2 , X3 , X4 , X5 , X6 , X7 , X8 , X9 , X10 , X11 et X12 à des fins expérimentales. Pour inclure un modèle de test, utilisez le formulaire {{X1}}pour le modèle X1, {{X2}}pour le modèle X2, etc.

Les modèles existants ont souvent chacun leur propre bac à sable et pages de cas de test (en particulier ceux qui utilisent {{ Documentation }}). Les modifications doivent y être minutieusement testées avant d'être appliquées au modèle principal, afin d'éviter d'endommager involontairement de nombreuses pages.

Lisibilité

Pour les modèles qui utilisent un grand nombre de paramètres, il peut être utile de placer chaque paramètre sur une ligne distincte et d'aligner les signes égal. Cela aide les futurs éditeurs à lire plus facilement le wikicode.

{{Exemple de nom de modèle
| first_parameter = Texte de first_value
| second_parameter = Texte de second_value
| Third_parameter = Texte de third_parameter
| etc = etc
}}

Les sauts de ligne

Certains modèles peuvent accidentellement provoquer des sauts de ligne supplémentaires dans les articles rendus. Cela est particulièrement vrai pour les modèles d'infobox et autres boîtes de modèles qui flottent généralement sur le côté droit d'un article, car les lignes supplémentaires ne seront pas visibles sur la page du modèle. Pour plus d'informations, voir Wikipedia:Line-break handling .

En règle générale, évitez deux sauts de ligne ensemble dans votre modèle. Ceux-ci peuvent "s'additionner" avec d'autres sauts de ligne dans l'article et être affichés comme des espaces blancs indésirables.

Substitution

Invoquer un modèle à l'aide du formulaire

{{subst:name of template (|parameters |...)}}

(c'est-à-dire en insérant subst:immédiatement après la paire d'accolades d'ouverture) fera une copie du texte du modèle et le placera sur la page, où il sera visible dans la source. Le modèle n'est plus transclus et les modifications futures apportées au modèle ne modifieront pas le texte. À titre indicatif , cette méthode doit être utilisée pour tous les messages courts et temporaires qui sont supprimés rapidement, comme sur les pages User_talk:. Le message standard du nouvel utilisateur en est un bon exemple. {{Welcome}}

Utilisez subst : également si vous devez modifier le message après l'avoir inclus sur la page. Si vous n'avez pas besoin de le modifier et que vous préférez que le message soit automatiquement mis à jour avec les modifications apportées au modèle, n'utilisez pas subst :.

Documentation

Étant donné que les modèles représentent une difficulté supplémentaire pour l'éditeur novice, une documentation doit être fournie qui décrit son utilisation (paramètres facultatifs) et sa portée (où il doit être utilisé). Il existe deux manières différentes de procéder :

Une alternative consiste à utiliser <noinclude> pour ajouter une description mineure directement dans le modèle, par exemple :

'''Ceci est un article {{{1}}}.'''<noinclude>
Placez ce modèle sur tout article nécessitant une description. Ce
prend un paramètre, un adjectif utilisé pour décrire l'article. 
Par exemple, {{article-describe|bad}} produit le texte, 
'''C'est un mauvais article.'''
</noinclude>

Une autre alternative consiste à créer une sous-page /doc formelle pour la documentation (de préférence pour les modèles avec plusieurs paramètres, etc.) et à l'ajouter après le modèle réel. La première balise "noinclude" doit être placée sur la même ligne que les accolades de fin du modèle réel de la manière suivante : <noinclude>{{Documentation}}</noinclude>

{{(nom du modèle)
(paramètres canalisés)
}}<pas d'inclusion>...

Si la balise "noinclude" commence sur la ligne sous les accolades fermantes du modèle, alors des espaces blancs indésirables sont introduits au bas du modèle lorsqu'il est utilisé dans des articles et sur d'autres pages.

Modules

Les modules Lua sont parfois utilisés à la place des modèles pour stocker du matériel réutilisable. Les raisons en sont l'utilisation de fonctionnalités spécifiques au module telles que les boucles ou les valeurs stockées, et le code complexe est souvent plus facile à lire et à gérer dans un module. Si un module est facilement implémentable dans un modèle, il devrait généralement l'être, car il y a plus d'utilisateurs expérimentés dans l'édition de modèles.

Si un module est destiné à être utilisé dans des articles ou des pages de discussion, un wrapper de modèle doit généralement être créé pour simplifier l'utilisation sans nécessiter directement la #invokefonction d'analyseur. La documentation est alors principalement située sur la page /doc du modèle, la documentation du module pointant vers le modèle et/ou expliquant d'autres détails techniques qui ne sont pas nécessaires dans la documentation du modèle principal.

Cependant, il y a parfois des raisons de ne pas utiliser un wrapper de modèle, comme causer des problèmes potentiels avec les limites de modèle ; un wrapper de modèle qui passe trop de paramètres à un module est beaucoup moins efficace par rapport à une invocation directe. De plus, il n'est généralement pas souhaitable d'utiliser des wrappers de modèles dans d'autres modèles.

Histoire

Historiquement, un préfixe "msg:" devait être ajouté devant le nom du modèle lorsqu'il était utilisé sur une page. Par exemple, {{msg:stub}} a été tapé au lieu de {{stub}}. Ce n'est plus necessaire.

Au cours des 35 premiers mois de Wikipédia, il n'y avait aucun modèle ou mécanisme de transclusion. La page Wikipedia:Boilerplate text a été créée en septembre 2002 pour collecter le texte fréquemment utilisé dans divers processus Wikipedia. L' espace de noms MediaWiki a été introduit avec MediaWiki 1.2.6 le 6 décembre 2003 et a été utilisé non seulement pour l'interface utilisateur mais aussi pour créer des messages texte passe-partout à insérer dans les articles en utilisant la syntaxe {{msg: ...}}. Cette fonction a été remplacée par l' espace de nom Template lors de la mise à jour du logiciel vers MediaWiki 1.3 le 30 mai 2004. En fonction du " Script d'initialisation de l'espace de nom modèle", tous les messages non système ont été déplacés vers le nouvel espace de noms. Le script d'initialisation a également remplacé MediaWiki : références dans les articles avec Template : pour contourner les redirections créées par les déplacements.

Pendant une courte période, Wikipédia:Articles à supprimer (alors appelés votes pour suppression ou VfD ) a utilisé MediaWiki : des messages nommés au format « MediaWiki:VfD- articlename ». Ceux-ci ont été déplacés vers l'espace Template: en juin 2004 et ont été nommés " Template:VfD- articlename ". Cette utilisation est désormais obsolète au profit des sous-pages.

Vers 2005, la complexité croissante des fonctions des modèles et le désir de consolider des modèles similaires ont conduit à la création de hacks conditionnels extrêmement complexes tels que les modèles imbriqués et les astuces CSS . Ces méthodes indésirables ont conduit au développement de m:Extension:ParserFunctions , ajouté en 2006 avec MediaWiki 1.7. En 2009, de nombreux problèmes de lisibilité et de complexité des modèles subsistaient ( sur les modèles et les langages de programmation ). En 2013, afin de gérer les temps de chargement des pages, principalement en raison de la lenteur du rendu des modèles, Lua a été activé, créant un module : espace de noms que les programmeurs peuvent utiliser (les nouveaux modèles Lua apportent des pages plus rapides et plus flexibles à votre wiki ).

Recherche de modèles

Utilisez ce formulaire pour rechercher dans les espaces de noms Template: ou Template_talk:. Voir Aide:Recherche pour plus d'informations.

Pages contenant des informations sur les modèles couramment utilisés :

Si vous ne parvenez pas à trouver un modèle existant pour votre situation, mais que vous ne vous sentez pas à l'aise d'en créer un vous-même, vous pouvez demander de l'aide à Wikipedia:Modèles demandés .

Voir également

Remarques

  1. ^ Les espaces de noms à partir desquels la transclusion n'est pas autorisée sont spécifiés sur un wiki par la variable $wgNonincludableNamespaces