Recherche:Astuce/Formulaire/Archive 11

Documentation des modèles

modifier

La nouvelle forme des modèles suppose une sous-page ~/Documentation accompagnant la page du modèle : [[Modèle:Titre du modèle]] & [[Modèle:Titre du modèle/Documentation]]

L’ensemble utilise une inclusion de la documentation sur la page du modèle {{Documentation}} ; mais cette documentation ne doit pas être transcluse lors de l’appel du modèle ; donc l’inclusion doit être encadrée par la balise noinclude.

La sous-documentation peut s’afficher, lorsque nous accédons directement au modèle (le principe est le même pour les modules). Attention la sous-documentation doit aussi fournir au modèle, ses catégories et liens interlink ; dans une section includeonly (car les informations concernent la page du modèle, où sera incluse la documentation présente.)

Observez la syntaxe suivante
  1. Édition de la page du modèle :
    <noinclude>Code du modèle</noinclude><includeonly>{{Documentation}}</includeonly>
  2. Édition de la sous-page documentation :
    Texte de la documentation (Usage, Syntaxe, Exemple et aussi catégorie de la page de documentation)<includeonly>[[Interwiki:source du modèle]] [[Catégorie:Catégorie du modèle]]</includeonly>

NB : Si vous oubliez de catégoriser la documentation, la page apparait dans la liste Spécial:Modèles non catégorisés.</ref>

Voir aussi

modifier

13 février 2017 à 17:38 (UTC)