« Aide:Modèle/Comment documenter un modèle ? » : différence entre les versions

Un livre de Wikilivres.
Contenu supprimé Contenu ajouté
simplification par le modèle catégorisant conforme interwikis
mAucun résumé des modifications
Ligne 2 : Ligne 2 :
:La documentation d'un [[Aide:modèle|modèle]] peut-être faite, soit dans la page du modèle (sous ce modèle), soit dans sa sous-page <code>/Documentation</code>. Il faut alors placer, dans la page du modèle et entre les bornes <code><nowiki><noinclude></nowiki>{{m|Documentation}}<nowiki></noinclude></nowiki></code>.
:La documentation d'un [[Aide:modèle|modèle]] peut-être faite, soit dans la page du modèle (sous ce modèle), soit dans sa sous-page <code>/Documentation</code>. Il faut alors placer, dans la page du modèle et entre les bornes <code><nowiki><noinclude></nowiki>{{m|Documentation}}<nowiki></noinclude></nowiki></code>.
:Il faut documenter en sous-page dans les cas suivants :
:Il faut documenter en sous-page dans les cas suivants :
::#le modèle est très employé et utilise des paramètres qui prennent de multiples valeurs <small>(il faut alors reduire au minimum le contenu des balises <code><nowiki><noinclude></nowiki></code>, <code><nowiki></noinclude></nowiki></code> et surtout, ne pas inclure la documentation)</small>.
::#le modèle est très employé et utilise des paramètres qui prennent de multiples valeurs <small>(il faut alors réduire au minimum le contenu des balises <code><nowiki><noinclude></nowiki></code>, <code><nowiki></noinclude></nowiki></code> et surtout, ne pas inclure la documentation)</small>.
::#le modèle et sa documentation sont particulièrement longs.
::#le modèle et sa documentation sont particulièrement longs.
::#on souhaite rependre (ie., inclure) la documentation dans une page d'aide.
::#on souhaite rependre (ie., inclure) la documentation dans une page d'aide.
Ligne 27 : Ligne 27 :
; Syntaxe : &lt;code&gt;&lt;nowiki&gt;{{{{PAGENAME}}|1|2|etc.}}&lt;/nowiki&gt;&lt;/code&gt;
; Syntaxe : &lt;code&gt;&lt;nowiki&gt;{{{{PAGENAME}}|1|2|etc.}}&lt;/nowiki&gt;&lt;/code&gt;
:* <code>1</code> : description1 (obligatoire).
:* <code>1</code> : description1 (obligatoire).
:* <code>2</code> : description2 (falcultatif, ''défaut2'' par défaut).
:* <code>2</code> : description2 (facultatif, ''défaut2'' par défaut).
:* etc.
:* etc.


Ligne 64 : Ligne 64 :
; Paramètres
; Paramètres
:* <code>paramètre1</code> : description1 (obligatoire).
:* <code>paramètre1</code> : description1 (obligatoire).
:* <code>paramètre2</code> : description2 (falcultatif, ''défaut2'' par défaut).
:* <code>paramètre2</code> : description2 (facultatif, ''défaut2'' par défaut).
:* <code>paramètre3</code> : description3 (optionnel, lorsque <code>paramètre2</code> est fourni, ''défaut3'' par défaut).
:* <code>paramètre3</code> : description3 (optionnel, lorsque <code>paramètre2</code> est fourni, ''défaut3'' par défaut).
:* etc.
:* etc.
Ligne 86 : Ligne 86 :
--&gt;
--&gt;
{{Documentation}}
{{Documentation}}
<!--{{{{PAGENAME}}/Documentation}} pour afficher la documentation-->


[[de:Template:Nom du modèle germanophone équivalent]]
[[de:Template:Nom du modèle germanophone équivalent]]
Ligne 94 : Ligne 93 :
&lt;/noinclude&gt;</pre>
&lt;/noinclude&gt;</pre>


:Puis cliquez sur « documentation en sous-page » pour editer la page. La documentation demeure globalement semblable <small>(mais attention à l'usage différent des balises « noinclude » et il faut reporter le nom du modèle)</small>. Pour un modèle simple :
:Puis cliquez sur « documentation en sous-page » pour éditer la page. La documentation demeure globalement semblable <small>(mais attention à l'usage différent des balises « noinclude » et il faut reporter le nom du modèle)</small>. Pour un modèle simple :
<pre>&lt;noinclude&gt;
<pre>&lt;noinclude&gt;{{Documentation}}&lt;/noinclude&gt;
Cette page est la documentation du modèle <nowiki>{{</nowiki>M|<!-- nom du modèle -->}}.
&lt;/noinclude&gt;
; Utilisation : Indiquez quand utiliser ce modèle.
; Utilisation : Indiquez quand utiliser ce modèle.


; Syntaxe : &lt;code&gt;&lt;nowiki&gt;{{<!-- nom du modèle -->|1|2|etc.}}&lt;/nowiki&gt;&lt;/code&gt;
; Syntaxe : &lt;code&gt;&lt;nowiki&gt;{{<!-- nom du modèle -->|1|2|etc.}}&lt;/nowiki&gt;&lt;/code&gt;
:* <code>1</code> : description1 (obligatoire).
:* <code>1</code> : description1 (obligatoire).
:* <code>2</code> : description2 (falcultatif, ''défaut2'' par défaut).
:* <code>2</code> : description2 (facultatif, ''défaut2'' par défaut).
:* etc.
:* etc.


Ligne 116 : Ligne 113 :


:Pour un modèle plus complexe (avec arguments nommés)&nbsp;:
:Pour un modèle plus complexe (avec arguments nommés)&nbsp;:
<pre>&lt;noinclude&gt;
<pre>&lt;noinclude&gt;{{Documentation}}&lt;/noinclude&gt;
Cette page est la documentation du modèle <nowiki>{{</nowiki>M|<!-- nom du modèle -->}}.
&lt;/noinclude&gt;
; Utilisation
; Utilisation
: Indiquez quand utiliser ce modèle.
: Indiquez quand utiliser ce modèle.
Ligne 132 : Ligne 127 :
; Paramètres
; Paramètres
:* <code>paramètre1</code> : description1 (obligatoire).
:* <code>paramètre1</code> : description1 (obligatoire).
:* <code>paramètre2</code> : description2 (falcultatif, ''défaut2'' par défaut).
:* <code>paramètre2</code> : description2 (facultatif, ''défaut2'' par défaut).
:* <code>paramètre3</code> : description3 (optionnel, lorsque <code>paramètre2</code> est fourni, ''défaut3'' par défaut).
:* <code>paramètre3</code> : description3 (optionnel, lorsque <code>paramètre2</code> est fourni, ''défaut3'' par défaut).
:* etc.
:* etc.

Version du 11 mai 2010 à 08:41

Où documenter ?
La documentation d'un modèle peut-être faite, soit dans la page du modèle (sous ce modèle), soit dans sa sous-page /Documentation. Il faut alors placer, dans la page du modèle et entre les bornes <noinclude>{{Documentation}}</noinclude>.
Il faut documenter en sous-page dans les cas suivants :
  1. le modèle est très employé et utilise des paramètres qui prennent de multiples valeurs (il faut alors réduire au minimum le contenu des balises <noinclude>, </noinclude> et surtout, ne pas inclure la documentation).
  2. le modèle et sa documentation sont particulièrement longs.
  3. on souhaite rependre (ie., inclure) la documentation dans une page d'aide.
Comment documenter sous le modèle ?
Pour disposer d'un formulaire de documentation préchargé lors de la création d'un nouveau modèle, mettez le nom de modèle de votre choix dans la boîte suivante et cliquez sur le bouton "Créer le modèle" :

Pour documenter un modèle déjà existant, copiez, collez et adaptez l'un des codes ci-dessous à la fin de la source d’un modèle (c’est-à-dire juste avant son dernier saut de ligne existant, et sans aucun autre saut de ligne inutile ajouté après). Pour un "petits" modèles simples, sans paramètres nommées, "sur une ligne", et avec un exemple :
<noinclude><!--
  NE PAS insérer de blanc ou de saut de ligne dans la ligne précédente, sinon cela fausse les résultats !
-->
{{Documentation}}

; Utilisation : Indiquez quand utiliser ce modèle.

; Syntaxe : <code><nowiki>{{{{PAGENAME}}|1|2|etc.}}</nowiki></code>
:* <code>1</code> : description1 (obligatoire).
:* <code>2</code> : description2 (facultatif, ''défaut2'' par défaut).
:* etc.

; Exemple : « <code><nowiki>{{</nowiki>{{PAGENAME}}|<!-- à compléter -->}}</code> » donne <!--
-->« {{{{PAGENAME}}|<!-- à compléter à l'identique -->}} »<!--pour un modèle simple (sur un ligne) -->

; Variantes
:* {{M|<!--nom de modèle connexe-->}}

; Voir aussi :
:* [[Pages à voir]]

[[de:Template:Nom du modèle germanophone équivalent]]
[[en:Template:Nom du modèle anglophone équivalent]]
[[es:Template:Nom du modèle hispanophone équivalent]]
[[it:Template:Nom du modèle italophone équivalent]]
</noinclude>
Pour un modèle plus complexe (avec arguments nommés) :
<noinclude><!--
  NE PAS insérer de blanc ou de saut de ligne dans la ligne précédente, sinon cela fausse les résultats !
-->
{{Documentation}}

; Utilisation
: Indiquez quand utiliser ce modèle.

; Syntaxe
 <nowiki>{{</nowiki>{{PAGENAME}}
   |paramètre1=valeur1
   |paramètre2=valeur2
   |paramètre3=valeur3
   |etc.
 }}

; Paramètres
:* <code>paramètre1</code> : description1 (obligatoire).
:* <code>paramètre2</code> : description2 (facultatif, ''défaut2'' par défaut).
:* <code>paramètre3</code> : description3 (optionnel, lorsque <code>paramètre2</code> est fourni, ''défaut3'' par défaut).
:* etc.

; Variantes
:* {{M|<!--nom de modèle connexe-->}}

; Voir aussi
:* [[Pages à voir]]

[[de:Template:Nom du modèle germanophone équivalent]]
[[en:Template:Nom du modèle anglophone équivalent]]
[[es:Template:Nom du modèle hispanophone équivalent]]
[[it:Template:Nom du modèle italophone équivalent]]
</noinclude>
Comment documenter dans la sous-page du modèle ?
Copiez, collez et adaptez le code ci-dessous, directement sous la source du modèle
<noinclude><!--
  NE PAS insérer de blanc ou de saut de ligne dans la ligne précédente, sinon cela fausse les résultats !
-->
{{Documentation}}

[[de:Template:Nom du modèle germanophone équivalent]]
[[en:Template:Nom du modèle anglophone équivalent]]
[[es:Template:Nom du modèle hispanophone équivalent]]
[[it:Template:Nom du modèle italophone équivalent]]
</noinclude>
Puis cliquez sur « documentation en sous-page » pour éditer la page. La documentation demeure globalement semblable (mais attention à l'usage différent des balises « noinclude » et il faut reporter le nom du modèle). Pour un modèle simple :
<noinclude>{{Documentation}}</noinclude>
; Utilisation : Indiquez quand utiliser ce modèle.

; Syntaxe : <code><nowiki>{{<!-- nom du modèle -->|1|2|etc.}}</nowiki></code>
:* <code>1</code> : description1 (obligatoire).
:* <code>2</code> : description2 (facultatif, ''défaut2'' par défaut).
:* etc.

; Exemple : « <code><nowiki>{{</nowiki><!-- nom du modèle -->|<!-- à compléter -->}}</code> » donne <!--
-->« {{<!-- nom du modèle -->|<!-- à compléter à l'identique -->}} »<!--pour un modèle simple (sur un ligne) -->

; Variantes :
:* {{M|<!--nom de modèle connexe-->}}

; Voir aussi :
:* [[Pages à voir]]
Pour un modèle plus complexe (avec arguments nommés) :
<noinclude>{{Documentation}}</noinclude>
; Utilisation
: Indiquez quand utiliser ce modèle.

; Syntaxe
 <nowiki>{{</nowiki><!-- nom du modèle -->
   |paramètre1=valeur1
   |paramètre2=valeur2
   |paramètre3=valeur3
   |etc.
 }}

; Paramètres
:* <code>paramètre1</code> : description1 (obligatoire).
:* <code>paramètre2</code> : description2 (facultatif, ''défaut2'' par défaut).
:* <code>paramètre3</code> : description3 (optionnel, lorsque <code>paramètre2</code> est fourni, ''défaut3'' par défaut).
:* etc.

; Variantes
:* {{M|<!--nom de modèle connexe-->}}

; Voir aussi
:* [[Pages à voir]]
Exemples de modèles bien documentés