« Aide:Modèles » : différence entre les versions

363 octets ajoutés ,  il y a 16 ans
m
|}
 
== Les balises d'inclusiond’inclusion sélective ==
Il est parfois utile de placer certains éléments dans le code source du modèle (par exemple les [[Aide:Lien inter-langue|liens interlangues]]) sans que ces éléments n'apparaissent sur la page où le modèle est inséré. Pour ce faire, on place les éléments à exclure de l'insertion entre les balises <nowiki><noinclude> et </noinclude></nowiki>.
 
=== Balisage <tt>noinclude</tt> (recommandé dans les modèles) ===
Inversement, les éléments qu'on veut voir apparaître en insertion, mais qu'on veut voir disparaître lors de la visualisation du modèle seul sont placés entre les balises <nowiki><includeonly> et </includeonly></nowiki>.
Il est parfois utile de placer certains éléments dans le code source du modèle (par exemple les [[Aide:Lien inter-langue|liens interlangues]]) sans que ces éléments n'apparaissentn’apparaissent sur la page où le modèle est inséré. Pour ce faire, on place les éléments à exclure de l'insertionl’insertion entre les balises <nowikitt><&lt;noinclude&gt;</tt> et <tt>&lt;/noinclude>&gt;</nowikitt>.
 
Il est recommandé de laisser au moins uneun saut de ligne ou espace entre le dernier signe "=" d'uned’une ligne de titre et une balise &lt;includeonly&gt;...&lt;/includeonly&gt;.
Placer un titre en balisage "includeonly" peut désorganiser la numérotation du sommaire et des liens "modifier" qui apparaissent à droite des titres.
 
Il est également recommandé, lorsqu'onlorsqu’on place une séquence &lt;noinclude>...&lt;/noinclude>, de ne faire précéder ou suivre la séquence entière d’AUCUN saut de ligne ou espace supplémentaire car ils seraient conservés à l’inclusion du modèle (au contraire du contenu de la séquence qui sera ignoré) et pourraient nuire à la présentation de son contenu. Par contre on peut mettre des blancs et sauts de lignes à volonté à l'intérieur (et c'est recommandé pour y placer des catégories ou des liens interwikis, chacun sur une ligne séparée). Par exemple, un Modèle:Exemple contenant normalement
Il est recommandé de laisser au moins une espace entre le dernier signe "=" d'une ligne de titre et une balise &lt;includeonly&gt;...&lt;/includeonly&gt;.
 
Il est également recommandé, lorsqu'on place une séquence &lt;noinclude>...&lt;/noinclude>, de ne faire précéder ou suivre la séquence entière d’AUCUN saut de ligne ou espace supplémentaire car ils seraient conservés à l’inclusion du modèle (au contraire du contenu de la séquence qui sera ignoré) et pourraient nuire à la présentation de son contenu. Par contre on peut mettre des blancs et sauts de lignes à volonté à l'intérieur (et c'est recommandé pour y placer des catégories ou des liens interwikis, chacun sur une ligne séparée). Par exemple, un Modèle:Exemple contenant normalement
<pre>''(contenu ''{{{1|}}}'' à compléter...)''</pre>
peut être complété d’une catégorie et d'un lien interwiki destinés à sa propre classification, mais non destinés aux articles qui incluent ce modèle:
[[en:Template:Sample]]
</noinclude></pre>
Notez ci-dessus comment le code de documentation du modèle intercale le contenu réel du modèle. Mais il peut être nécessaire de montrerplusieurs exemples du modèle lui-même, en fournissant des paramètres.Dans ce cas, le code du modèle sera préférablement placé en tête mais caché dans la page de description. Par exemple:
 
Inversement, les éléments qu'onqu’on veut voir apparaître en insertion, mais qu'onqu’on veut voir disparaître lors de la visualisation du modèle seul sont placés entre les balises <nowikitt><&lt;includeonly&gt;</tt> et <tt>&lt;/includeonly>&gt;</nowikitt>.
 
PlacerNotez unque le placement d’un titre endans une balisagesection "includeonly" peut désorganiser la numérotation du sommaire et des liens "modifier" qui apparaissent à droite des titres.
 
=== Balisage <tt>includeonly</tt> (non recommandé) ===
Il peut être parfois nécessaire de montrer plusieurs exemples du modèle lui-même, en fournissant des paramètres. Dans ce cas, le code du modèle sera préférablement placé en tête mais caché dans la page de description. Par exemple&nbsp;:
<pre><includeonly>''(contenu ''{{{1|}}'' à compléter...)''</includeonly><noinclude>
=== Description ===
[[en:Template:Sample]]
</noinclude></pre>
Notez ci-dessus la récursion du modèle&nbsp;: il est possible que lors de l'éditionl’édition d’un modèle déjà existant, il faille le sauvegarder deux fois pour que l’auto-inclusion dans sa page de description prenne en compte le nouveau contenu du modèle. Notez également comment sont disposés les balises <tt>&lt;/includeonly&gt;&lt;noinclude&gt;</tt>, sans aucun saut de ligne intermédiaire qui tomberait en surplus et qui risquerait d’interrompre par exemple la liste à numérotation automatique montrée dans l’exemple ci-dessus et dans laquelle le modèle est inséré, ou qui pourrait créer une rupture de paragraphe indésirable dans les articles qui incluent le modèle, ou des sauts blancs verticaux en excédent.
 
L’utilisation du balisage <tt>&lt;includeonly&gt;&lt;/includeonly&gt;</tt> doit donc rester exceptionnel et doit utilisé avec précaution.
 
===Balise d’inclusion sélective et substitution===
0

modification