Différences entre les versions de « Modèle:Sommaire »

De GCE Electronics
Aller à la navigation Aller à la recherche
(Page créée avec « {{Sous-page de documentation}} Ce modèle permet d'insérer la table des matières avec une mise en forme paramétrable. Il n'est techniquement possible d'ins... »)
 
m (A protégé « Modèle:Sommaire » ([Modifier=Autoriser uniquement les utilisateurs autoconfirmés] (infini) [Renommer=Autoriser uniquement les utilisateurs autoconfirmés] (infini)))
 
(50 versions intermédiaires par 2 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
{{Sous-page de documentation}}
<includeonly><div {{#if:{{{niveau|}}}|class="toc_niveau_{{{niveau|}}}"|}}
 
          style="{{#switch:{{{align| {{#if:{{{flottant|}}}|left}} }}}|left=float:left|right=float:right}}; margin: 0 2em 0 0; padding: 2px 5px; {{#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>
Ce modèle permet d'insérer la [[Sommaire|table des matières]] avec une mise en forme paramétrable.
 
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>
:*[[Modèle:Sommaire/Documentation/Exemple5|voir le rendu]]
 
=== Alignement : paramètre <code>align</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, et les suppressions des modèles précédemment utilisés à cet effet, dont [[Discussion modèle:Sommaire à gauche/Suppression]]). Son usage est donc déconseillé dans les articles.
 
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>
:*[[Modèle:Sommaire/Documentation/Exemple1|voir le rendu]]
 
;Alignement à droite
: <pre><nowiki>{{Sommaire|align=right}}</nowiki></pre>
:*[[Modèle:Sommaire/Documentation/Exemple2|voir le rendu]]
 
=== 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>
:*[[Modèle:Sommaire/Documentation/Exemple4|voir le rendu]]
 
== 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>
 
== Voir aussi ==
* [[Modèle:Sommaire à droite]]
* [[Modèle:Sommaire alphabétique]]
 
{{catégorise|Page utilisant un sommaire limité}}
 
[[Catégorie:Modèle de sommaire]]
 
<includeonly>
[[en:Template:TOClimit]]
</includeonly>

Version actuelle datée du 5 septembre 2017 à 15:32

Récupérée de « https://wiki.gce-electronics.com/index.php?title=Modèle:Sommaire&oldid=1922 »