Modification de Aide:Documenter un modèle
La modification peut être annulée. Veuillez vérifier les différences ci-dessous pour voir si c’est bien ce que vous voulez faire, puis publier ces changements pour finaliser l’annulation de cette modification.
Version actuelle | Votre texte | ||
Ligne 8 : | Ligne 8 : | ||
La documentation se trouve '''systématiquement''' sur une sous-page dédiée dont le titre suit la forme '''Modèle:Nom_du_modèle/Documentation'''. Ainsi, la source d'une page de modèle ressemble à ceci : | La documentation se trouve '''systématiquement''' sur une sous-page dédiée dont le titre suit la forme '''Modèle:Nom_du_modèle/Documentation'''. Ainsi, la source d'une page de modèle ressemble à ceci : | ||
<pre><nowiki> | <pre><nowiki> | ||
<includeonly>code du modèle</includeonly><noinclude>{{/Documentation}}</noinclude> | <includeonly> | ||
</nowiki></pre> | code du modèle | ||
... | |||
... | |||
</includeonly> | |||
<noinclude>{{/Documentation}}</noinclude></nowiki> | |||
</pre> | |||
Et c'est tout : pas de bandeaux, pas de catégories. Tout est dans la page de documentation. Cette séparation permet de rendre plus lisible le code du modèle, et de laisser la documentation éditable si le modèle devait être protégé. Les modèles imbriqués, comme [[Modèle:Apprentissage|le modèle Apprentissage]], sont des cas particuliers : leur documentation doit être réunie sur une seule et même sous-page, qui est celle de la partie commune principale de l'ensemble, les autres modèles l'incluant plutôt que d'inclure une sous-page qui leur est propre. | Et c'est tout : pas de bandeaux, pas de catégories. Tout est dans la page de documentation. Cette séparation permet de rendre plus lisible le code du modèle, et de laisser la documentation éditable si le modèle devait être protégé. Les modèles imbriqués, comme [[Modèle:Apprentissage|le modèle Apprentissage]], sont des cas particuliers : leur documentation doit être réunie sur une seule et même sous-page, qui est celle de la partie commune principale de l'ensemble, les autres modèles l'incluant plutôt que d'inclure une sous-page qui leur est propre. |