Modèle:Documentation modèle en sous-page/Documentation

Stargate Wiki Sémantique — La référence sémantique sur l'univers Stargate
Aller à la navigation Aller à la recherche

Ceci est la page de documentation du modèle {{Documentation modèle en sous-page/Documentation}}.
Cette page n’est pas destinée à être visualisée directement. Les liens utilisant des pseudo-variables peuvent paraître rompus (en rouge) ; ne pas les remplacer par des noms de pages codés en dur ni des URL.

Utilisation :
Affiche un bandeau similaire à celui affiché ci-dessus, qui permet d’accéder à la documentation pour la modifier. La documentation doit alors être incluse dans le modèle à l’aide de {{/Documentation}} ; il est alors préférable de placer le bandeau dans la page de documentation.
À n‘utiliser que dans un modèle simple, et lorsque lorsque (la source de) la documentation d’un modèle se trouve dans sa sous-page Modèle:Param/Documentation.
On lui préférera le modèle {{Doc modèle}} (utilisable aussi pour les modèles compliqués, mais qui utilise aussi ce modèle), qui réalise aussi la transclusion de la sous-page, avec une syntaxe allégée.
Syntaxe (dans le modèle principal) :
Code du modèle principal...<noinclude>{{Documentation modèle en sous-page}}
{{/Documentation}}<!-- transclusion de la sous-page de documentation -->
...autres métadonnées (non recommandé)
</noinclude>
Syntaxe (dans la sous-page « /Documentation ») :
La page de documentation doit afficher {{documentation modèle vue directement}} lorsqu’elle est vue directement.
Consulter la syntaxe recommandée dans la documentation de {{Doc modèle}}.
Note :
Dans les modèles très utilisés, il n’est pas recommandé de placer la documentation (ainsi que les autres métadonnées) directement dans le modèle, d'autant plus que ce modèle peut être l'objet de blocage.
Dans ce cas, on placera toute la documentation du modèle (ainsi que les autres métadonnées) dans une sous-page « .../Documentation », et on utilisera plutôt uniquement le modèle {{Doc modèle}} qui vous assistera dans la création de cette sous-page.
Parmi les autres métadonnées qu'on place dans la sous-page de documentation (et à placer dans la section ‹‹ includeonly » de la sous-page), figureront toutes les catégories applicable au modèle principal, ainsi que la clé de tri par défaut pour ces catégories, et les liens interwikis vers des modèles similaires (plus ou moins compatibles) d’autres éditions de Wikipédia.
Variantes :
Voir aussi :