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

Les modèles sont des pages comme les autres et donc accessibles à l'édition par tous les contributeurs. Il faut toutefois les modifier avec prudence car le résultat apparaît sur de nombreuses pages. Lorsque la page correspondant au modèle est affichée, on peut cliquer sur l'hyperlien '''Pages liées''' du menu de gauche pour consulter les pages utilisant le modèle et vérifier, avant modification, que ces pages ne seront pas perturbées.

 

Pour inclure un modèle il faut utiliser la [[Aide:syntaxe|syntaxe]] suivante (la première lettre du nom du modèle n’est pas sensible à la casse) :

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

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

 

Si le modèle contient un [[Aide:lien inter-langue|lien inter-langue]], 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 inter-langue 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]].

 

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 <nowiki><noinclude></nowiki>, toutes les pages contenant le modèle appartiendront à cette catégorie. On peut utiliser cette astuce, par exemple, pour obtenir la liste de toutes les pages ''ébauche'' d’un domaine donné.

 

 

* Si vous avez besoin de l'aide d’utilisateurs expérimentés pour fabriquer un nouveau modèle, vous pouvez le demander sur la [[Wikiversité:La salle café|salle café]].

 

{{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]].

 

 

Consulter cette [[MW:Help:Magic words|page]].

 

 

 

* Note : cette balise est recommandée dans les modèles

</div>

 

 

* Cette balise est non recommandée dans les modèles

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

 

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

 

 

Afin de créer un modèle non encyclopédique (par ex. destiné à être appelé par une page utilisateur) ou pour faire des tests, nul n'est besoin de « polluer » l'espace des modèles. Cela peut se faire sur une sous-page utilisateur.

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

 

Les développeurs ont été mis au courant de tous ces problèmes sur la page [http://bugzilla.wikipedia.org/show_bug.cgi?id=939 Bugzilla {{numéro}}939].

 

* [[Wikiversité:Modèles]]

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