|
|
Ligne 1 : |
Ligne 1 : |
| <includeonly><div {{#if:{{{niveau|}}}|class="toc_niveau_{{{niveau|}}}"|}} | | <includeonly><div {{#if:{{{niveau|}}}|class="toc_niveau_{{{niveau|}}}"|}} |
| style="{{#switch:{{{align| {{#if:{{{flottant|}}}|left}} }}}|left=float:left|right=float:right}}; {{#if:{{{width|}}}|width:{{{width|}}}}}">__TOC__</div>{{#if:{{{flottant|}}}||{{#switch:{{{align|}}}|left=<div style="clear:left"></div>|right=<div style="clear:right"></div>}}}}{{#if:{{{niveau|}}}|{{#if:{{{nocat|}}}||[[Catégorie:Page utilisant un sommaire limité|{{PAGENAME}}]]}}|}}</includeonly><noinclude> | | style="{{#switch:{{{align| {{#if:{{{flottant|}}}|left}} }}}|left=float:left|right=float:right}}; {{#if:{{{width|}}}|width:{{{width|}}}}}">__TOC__</div>{{#if:{{{flottant|}}}||{{#switch:{{{align|}}}|left=<div style="clear:left"></div>|right=<div style="clear:right"></div>}}}}{{#if:{{{niveau|}}}|{{#if:{{{nocat|}}}||[[Catégorie:Page utilisant un sommaire limité|{{PAGENAME}}]]}}|}}</includeonly><noinclude> |
− | Ce modèle permet d'insérer la [[Sommaire|table des matières]] avec une mise en forme paramétrable.
| + | Documentation : http://fr.wikipedia.org/wiki/Mod%C3%A8le:Sommaire |
− | | |
− | Il n'est techniquement possible d'insérer qu'un seul sommaire sur une page de Wikipédia. L'ajout de ce modèle désactivera automatiquement l'affichage du sommaire placé par défaut par [[MediaWiki]]. Si ce modèle {{m|Sommaire}} est appelé plusieurs fois sur une page, seul le premier appel sera affiché correctement.
| |
− | | |
− | == Mise en page ==
| |
− | === Limitation de niveau : paramètre <code>niveau</code> ===
| |
− | Lorsque le sommaire est trop long, ce paramètre permet de masquer les niveaux de titres en-dessous du 2 ou 3. Il est déconseillé de le restreindre au premier niveau de titre, car le résultat est peu utile pour le lecteur (sommaire qui ne reflète pas la richesse du contenu).
| |
− | | |
− | En matière d'accessibilité, ce paramètre niveau permet d'éviter de faire des semblants de titres – non accessibles – avec du gras (« <nowiki>''''''</nowiki> » ou « <nowiki>;</nowiki> »). Ce paramètre niveau permet de continuer à utiliser la syntaxe habituelle « <nowiki>== Mon titre ==</nowiki> », ce qui est accessible.
| |
− | | |
− | : <pre><nowiki>{{Sommaire|niveau=2}}</nowiki></pre>
| |
− | | |
− | === Alignement : paramètre <code>align</code> ===
| |
− | Valeurs acceptées : <code>left</code> (flottant à gauche, valeur par défaut), <code>right</code> (flottant à droite) et <code>center</code> (centré)
| |
− | | |
− | ;Alignement à gauche (par défaut)
| |
− | : <pre><nowiki>{{Sommaire|align=left}}</nowiki></pre>
| |
− | | |
− | ;Alignement à droite
| |
− | : <pre><nowiki>{{Sommaire|align=right}}</nowiki></pre>
| |
− | | |
− | === Texte tout autour du menu : paramètre <code>flottant</code> ===
| |
− | Note : ces paramètres permettent de mettre en forme le sommaire d'une manière qui ne fait pas consensus au sein de la communauté (voir les quelques tentatives de prises de décision à ce sujet). Son usage est donc déconseillé dans les articles.
| |
− | | |
− | : <pre><nowiki>{{Sommaire|align=right|flottant=1}}</nowiki></pre>
| |
− | | |
− | == Données ==
| |
− | <templatedata>
| |
− | {
| |
− | "description": "Ce modèle permet d’insérer la table des matières avec une mise en forme paramétrable",
| |
− | "params": {
| |
− | "niveau": {
| |
− | "required": false,
| |
− | "label": "Niveau",
| |
− | "type": "number",
| |
− | "description": "Ce paramètre permet de limiter les niveaux de titres affichés dans le sommaire"
| |
− | },
| |
− | "align": {
| |
− | "required": false,
| |
− | "label": "Alignement",
| |
− | "type": "string/line",
| |
− | "default": "left",
| |
− | "description": "Permet d’affiche le sommaire à gauche (« left ») ou à droite (« right »)"
| |
− | },
| |
− | "flottant": {
| |
− | "required": false,
| |
− | "label": "Flottant",
| |
− | "type": "string/line",
| |
− | "description": "Si ce paramètre est rempli, le texte suivant le sommaire s’affichera autour (plutôt qu’après)"
| |
− | },
| |
− | "width": {
| |
− | "required": false,
| |
− | "label": "Largeur",
| |
− | "type": "string/line",
| |
− | "description": "Largeur du sommaire (toute valeur valide en CSS, par exemple « 156px » ou « 22em » ; utilisez de préférence les « em »)"
| |
− | },
| |
− | "nocat": {
| |
− | "required": false,
| |
− | "label": "Non catégorisé",
| |
− | "type": "string/line",
| |
− | "description": "Si ce paramètre est rempli, la page n’est pas catégorisée dans « Catégorie:Page utilisant un sommaire limité » ; ce paramètre ne devrait pas être utilisé dans les articles"
| |
− | }
| |
− | }
| |
− | }
| |
− | </templatedata>
| |
− | | |
− | </noinclude>
| |