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

 

== Utilisation ==

*<tt><nowiki>{{Nom du modèle}}</nowiki></tt> 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.

*<tt><nowiki>{{subst:Nom du modèle}}</nowiki></tt> 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.

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.

 

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

 

 

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 [[Wikiversité:conventions de nommage|conventions sur les titres]] aussi pour les noms de 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]].

 

{{Aide:Modèle/Comment documenter un modèle ?}}

 

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.

 

 

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.

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 <nowiki><br /></nowiki> est permis. La valeur peut inclure un lien extérieur (par exemple, le paramètre ''dimensions'') ou intérieur (par exemple, ''orbite''). On remarquera que la syntaxe habituelle des liens wiki est possible (c'est-à-dire <nowiki>[[page visée|texte qui apparaîtra]]</nowiki>).

 

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: <nowiki>{{{3}}}</nowiki>.

 

:Voir aussi: [[meta:ParserFunctions/fr|les fonctions conditionnelles]].

 

:Note : ''pour les modèles déclarés par des utilisateurs, voir [[Wikiversité:Modèles#Listes complètes|la liste complète des modèles]].''

 

{|border

|}

 

{|class="wikitable"

|<nowiki>{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}|action=edit}}</nowiki>

|-

|<nowiki>''Voir : [[{{NAMESPACE}}:{{PAGENAME}}_1|{{NAMESPACE}} {{PAGENAME}} 1]].''</nowiki>

|-

|<nowiki>[[{{NAMESPACE}}:{{PAGENAME}}_1]]</nowiki>

|-

|<nowiki>[[{{FULLPAGENAME}}_1]]</nowiki>

|}

 

L’utilisation du balisage <tt>&lt;includeonly&gt;&lt;/includeonly&gt;</tt> doit donc rester exceptionnel et doit être utilisé avec précaution.

 

Lors d’une insertion par substitution (avec la syntaxe spéciale <tt><nowiki>{{</nowiki>subst:''modèle''<nowiki>}}</nowiki></tt> utilisée uniquement lors de l’édition du code Wiki d’un article ou d’un autre modèle) les balises <tt>&lt;noinclude&gt;…&lt;/noinclude&gt;</tt> ainsi que le texte qu'elles encadrent ne sont pas reproduites.

 

reconnait la présence de l’<tt style="margin:1px 1px 1px 1px;background:white;color:black;border:1px dotted blue;padding:1px 1px 1px 1px;">''espace de nommage'':</tt>, qui ne prend la valeur par défaut <tt style="margin:1px 1px 1px 1px;background:white;color:black;border:1px dotted blue;padding:1px 1px 1px 1px;">Modèle:</tt> que quand l'espace de nommage 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.

 

'''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 :

 

# 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 {{Code|touch.py}}. Déposez votre requête sur [[Wikiversité:Bot/Requêtes]].

 

 

== Voir aussi ==

*[[m:ParserFunctions/fr|fonctions parseur]]

*[[Wikiversité:Bac_à_sable#Et_si_vous_voulez_tester_les_modèles|Bac à sable]] (pour s'entraîner à l'utilisation des modèles)

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

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