Modèle:Documentation

Une page de Wikipédia, l'encyclopédie libre.
Aller à : navigation, rechercher
Documentation Documentation[modifier] [purger]
Logo du langage Lua
Ce modèle utilise le module Documentation, un script écrit dans le langage de programmation Lua. Toute expérimentation devrait être conduite d'abord via sa sous-page de bac à sable. Voir le Projet:Scribunto si vous voulez en savoir plus.

{{Documentation}} est un modèle de mise en forme de documentation affichant une boîte verte (comme vous pouvez le voir actuellement). Ce modèle charge automatiquement le contenu d'une sous-page /Documentation. Il est à placer à la fin du modèle et doit être inséré dans une section noinclude. L'utilisation de ce modèle permet à quiconque d'éditer la documentation et les catégories d'un modèle protégé.

Si la page de documentation n'existe pas, le lien [créer] comporte une page de préchargement avec le format de page de documentation de base. Dans la notice disponible en bas de page de documentation, ce préchargement est également utilisé pour les sous-pages /Bac à sable et /Test en cliquant sur le lien (créer). Lorsque le modèle est un bac à sable, il ajoute automatiquement le modèle {{Sous-page de bac à sable}} en haut de page.

Lorsque la page est semi-protégée ou protégée le modèle approprié est automatiquement inséré, sauf s'il est déjà présent dans la sous-page de documentation.

Syntaxe

En général, ce modèle est utilisé sans aucun paramètre, placé en bas du modèle ou de la page documentée, entre « <noinclude> » :

<noinclude>{{Documentation}}</noinclude>

De cette façon, le contenu de la sous-page /Documentation du modèle se chargera automatiquement. {{Documentation}} peut également charger le contenu à partir de n'importe quelle autre page :

<noinclude>{{Documentation|Modèle:Exemple/Documentation}}</noinclude>

De cette façon, le contenu de la sous-page /Documentation du modèle {{Exemple}} se chargera automatiquement. Notez bien que l'espace de nom (« Modèle: » ici) doit être indiqué. Le contenu peut également être rédigé dans le corps du modèle :

<noinclude>{{Documentation|contenu=
== Utilisation ==
Lorem ipsum...
}}</noinclude>

Cependant, cette méthode est restrictive. Lorsque le modèle est protégé, le contenu doit être transféré en sous-page. Il suffit de suivre les instructions de la notice, disponible en bas de page de chaque documentation. À noter que la syntaxe MediaWiki des tableaux ne peut être associée au paramètre contenu.

Paramètres

  • <premier paramètre sans nom> : Paramètre servant à mentionner le nom d'une page de documentation alternative, qui peut être partagée par plusieurs modèles.
  • contenu : Paramètre servant à inclure le contenu de la documentation directement dans le corps du modèle.
  • notice : Paramètre permettant de personnaliser la notice de la documentation. Ce paramètre est opérationnel seulement lorsque le paramètre contenu est renseigné.
  • titre : Paramètre permettant la modification du titre de la documentation.
  • couleur : Paramètre modifiant la couleur par défaut le la documentation.

Exemples

Voir la sous-page de test.

Voir aussi