« Modèle:Contenu de sommaire/Documentation » : différence entre les versions

Un livre de Wikilivres.
Contenu supprimé Contenu ajouté
+ {{Documentation de modèle}}
Nouvelle version de {{Contenu de sommaire}}
Ligne 1 : Ligne 1 :
<noinclude>{{Documentation de modèle}}</noinclude>
__NOTOC__<noinclude>{{Documentation de modèle}}</noinclude>
== Utilisation ==
== Utilisation ==
Ce modèle permet de créer un '''sommaire''' pour un livre.
Ce modèle permet de créer un '''sommaire''' pour un livre.
Ligne 5 : Ligne 5 :
(par exemple : <code>''Livre de ceci cela/Sommaire''</code>),
(par exemple : <code>''Livre de ceci cela/Sommaire''</code>),
et ainsi l’afficher automatiquement grâce au modèle {{m|Sommaire}}.
et ainsi l’afficher automatiquement grâce au modèle {{m|Sommaire}}.
Il peut fonctionner en mode simple ou complexe.


Ce modèle est aussi disponible en tant que {{m|Chapitres}}.
Ce modèle est aussi disponible en tant que {{m|Chapitres}}.


===Mode simple===
===Syntaxe===
<nowiki>{{</nowiki>Contenu de sommaire | style = <nowiki>{{{</nowiki>style|''autre''}}} | ''Chapitre 1'' | ''Chapitre 2'' | ... }}
<nowiki>{{</nowiki>Contenu de sommaire | style = <nowiki>{{{</nowiki>style|''autre''}}} | ''Chapitre 1'' | ''Chapitre 2'' | ... }}
Vous ajoutez autant de chapitres que nécessaire. Le titre du chapitre ne doit '''pas''' comporter de fioritures car il est utilisé comme lien (mise en italique, modèle,&nbsp;...).
Vous ajoutez autant de chapitres que nécessaire. Le titre du chapitre ne doit '''pas''' comporter de fioritures car il est utilisé comme lien (pas de mise en italique, de tags html,&nbsp;...).


Le titre du chapitre peut être suivi des champs suivants :
===Mode complexe===
* l’état d’avancement du chapitre (nombre entre 0 et 100),
<nowiki>{{</nowiki>Contenu de sommaire | complexe = 1 | style = <nowiki>{{{</nowiki>style|''autre''}}}
* une image illustrant le chapitre ;
| ''ext''/''Chapitre 2''/''params'' | ''ext''/''Chapitre 2''/''params'' | ... }}
ces informations pourront être utilisés par le style (dépend du style).
La syntaxe du mode complexe est identique au mode simple, sauf qu’on utilise le paramètre <code>complexe</code> (n’importe quelle valeur convient, tant qu’il n’est pas vide) et que les entrées de chapitres sont sous une forme spéciale :
<nowiki>{{</nowiki>Contenu de sommaire | style = <nowiki>{{{</nowiki>style|''autre''}}}
* le nom de l’extension
| ''Chapitre 1'' | ''avancement 1'' | [<nowiki/>[Image:''une_image'']]
* ensuite le titre du chapitre (comme le mode simple)
| ''Chapitre 2'' | ''avancement 2'' | [<nowiki/>[Image:''autre_image'']] | ... }}
* enfin la liste des paramètres de l’extension séparés par des barres obliques (''{{lang|en|slash}}'', « / »)


<u>Note:</u> si le titre d’un chapitre est composé seulement d’un nombre et que le chapitre précédent n’a pas de champ ''avancement'' associé, vous devrez doubler la barre verticale pour marquer la séparation (voir les exemples ci-dessous).
Attention: chaque élément est séparé des autres par une barre oblique et non par une barre verticale.


===Niveaux et titres===
Voyez la [[Spécial:Index/Modèle:Contenu de sommaire/Extension|page de l’extension]] pour en savoir plus sur les paramètres.
Il est possible de faire des sous-chapitres en faisant précéder le nom du chapitre par autant de signes ''plus'' (<code>+</code>) que de niveaux souhaités; par contre on ne pourra descendre que d’un niveau à la fois.


Il est également possible d’ajouter un titre à la place d’un chapitre en le faisant précéder d’un point d’exclamation (<code>!</code>).
Notez que vous pouvez aussi utiliser des entrées de chapitre simples lorsqu’aucune extension n’est nécessaire
pour cette entrée


== Paramètres supplémentaires ==
== Paramètres ==
''Ces paramètres peuvent être utilisés aussi bien avec le mode simple que le mode complexe.''


; style : Devrait toujours être <code><nowiki>{{{</nowiki>style|''autre''}}}</code> pour <!--
; style : Devrait toujours être <code><nowiki>{{{</nowiki>style|''autre''}}}</code> pour <!--
--> pouvoir définir le style à partir du modèle {{m|Sommaire}} ; <!--
--> pouvoir définir le style à partir du modèle {{m|Sommaire}} ; <!--
--> ''autre'' (peut être vide) permet de décider quel style utiliser lorsqu’il n’est <!--
--> ''autre'' (peut être vide) permet de décider quel style utiliser lorsqu’il n’est pas <!--
--> pas défini par <nowiki>{{</nowiki>Sommaire}} (mettez celui le plus employé).<br> <!--
--> défini par <nowiki>{{</nowiki>Sommaire}} (vous pouvez mettre par exemple celui qui est <!--
--> Si le style n’est pas donné lors de l’appel à <nowiki>{{</nowiki>Contenu de sommaire}}, <!--
--> le plus employé). Attention: vous devez ici utiliser le préfixe ''sommaire'' ou ''navigation''.<br> <!--
--> Si le style n’est pas donné lors de l’appel à <nowiki>{{</nowiki>Contenu de sommaire}}, <!--
--> le style ''[[Modèle:Contenu de sommaire/Style par défaut|par défaut]]'' sera utilisé : <!--
--> le style ''[[Modèle:Contenu de sommaire/Style par défaut|par défaut]]'' sera utilisé : <!--
--> c’est normalement une redirection vers un autre style.<br> <!--
--> c’est normalement une redirection vers un autre style.<br> <!--
--> Note: le style ''[[Modèle:Contenu de sommaire/Style personnalisé|personnalisé]]'' <!--
--> Note: le style ''[[Modèle:Contenu de sommaire/Style sommaire personnalisé| sommaire personnalisé]]'' <!--
--> permet d’utiliser un style propre au livre.
--> permet d’utiliser un style propre au livre.


; à plat : Indique que le livre possède une structure à un seul niveau (pas de sous-sous-pages). Les <!--
; titre : Certains styles permettent de définir le titre du sommaire ; vous pouvez utiliser <!--
--> valeurs reconnues pour ce paramètre sont : ''oui'', ''true'', ''1'', ''non'', ''false'' et ''0''.
--> <code><nowiki>{{</nowiki>BASEPAGENAME}}</code> comme valeur pour avoir le titre du livre.


; liens automatiques : Permet de gérer l’ajout automatique des liens ''Glossaire'', ''Auteurs'', <!--
; image : Certains styles permettent d’afficher une image (écrivez le nom du fichier ''sans le préfixe'').
--> ''Bibliographie'', ''Index'' et ''Licence'' : par défaut, ils seront affichés si les pages <!--
--> correspondantes existent ; si le paramètre a la valeur ''oui'', ''true'' ou ''1'', ils <!--
--> seront affichés même si les pages corresondantes n’existent pas ; avec une valeur ''non'', <!--
--> ''false'' ou ''0'', ces liens ne seront jamais affichés.


; option1, option2, option3, option4 : Certains styles acceptent des options ; voyez <!--
; option ... <br/> option ...<nowiki>:</nowiki> ''style'', ... : Certains styles acceptent des options ; <!--
--> la [[Spécial:Index/Modèle:Contenu de sommaire/Style|page du style]] pour en savoir plus.
--> voyez la {{Lien interne|Spécial:Index/Modèle:Contenu de sommaire/Style|q=stripprefix=1|page du style}} <!--
--> pour en savoir plus. La seconde version permet de n’appliquer l’option qu’à certains styles.

; base : Pour indiquer l’emplacement du livre (n’est utile que si le livre n’est pas à la racine ; <!--
--> voir aussi {{m|Multi-sommaire}}).

== Limites ==
* Le nombre de chapitres est actuellement limité à 100 (mais ça peut être augmenté).
* le nombre de paramètres des extensions (mode complexe) est limité à 23, <!--
--> et la taille totale de l’entrée complexe, barres obliques comprises, <!--
--> est limitée à 255 caractères (car utilisation de la <!--
--> [[mw:Help:Extension:ParserFunctions#.23titleparts|fonction #titleparts]]).


== Exemples ==
== Exemples ==
Ligne 67 : Ligne 61 :


<nowiki>{{</nowiki>Contenu de sommaire
<nowiki>{{</nowiki>Contenu de sommaire
| style = <nowiki>{{{</nowiki>style|[[Modèle:Contenu de sommaire/Style large|large]]}}}
| style = <nowiki>{{{</nowiki>style|[[Modèle:Contenu de sommaire/Style sommaire large|sommaire large]]}}}
| Les carrés rouges
| Les carrés rouges
| Les ronds bleus
| Les ronds bleus
Ligne 74 : Ligne 68 :


<nowiki>{{</nowiki>Contenu de sommaire|
<nowiki>{{</nowiki>Contenu de sommaire|
complexe=1|style=<nowiki>{{{</nowiki>style|[[Modèle:Contenu de sommaire/Style large|large]]}}}|
| style=<nowiki>{{{</nowiki>style|[[Modèle:Contenu de sommaire/Style sommaire large|sommaire large]]}}}
[[Modèle:Contenu de sommaire/Extension avancement|avancement]]/Les carrés rouges/5 |
| Les carrés rouges | 5
[[Modèle:Contenu de sommaire/Extension avancement|avancement]]/Les ronds bleus/33 |
| Les ronds bleus | 33
[[Modèle:Contenu de sommaire/Extension avancement|avancement]]/Les triangles verts/100
| Les triangles verts | 100
}}
}}


<nowiki>{{</nowiki>Contenu de sommaire
<nowiki>{{</nowiki>Contenu de sommaire
| complexe=oui | style=<nowiki>{{{</nowiki>style|[[Modèle:Contenu de sommaire/Style bas|bas]]}}}
| style=<nowiki>{{{</nowiki>style|[[Modèle:Contenu de sommaire/Style sommaire bas|sommaire bas]]}}}
| option1=numéros seuls
| option numéros seuls = 1
| titre=<nowiki>{{{</nowiki>BASEPAGENAME}}} | image = Wikibooks-logo-fr.png |
| option titre = ~ | option image = Wikibooks-logo-fr.png |
| Pommes
| Pommes
| Poires | [<nowiki/>[Image:Wikibooks-logo-fr.png]]
| super extension/Poires/x/y/z
| Ananas
| Ananas
|| 133
| autre extension / Pêches / 5326
| Pêches
| extension sans paramètre/Abricots
}}
}}


== Voir aussi ==
== Voir aussi ==
* le modèle {{m|Sommaire}} qui permet d’inclure automatiquement le sommaire créé
* le modèle {{m|Sommaire}} qui permet d’inclure automatiquement le sommaire créé ;
* le modèle {{m|Navigation}} qui utilise également le sommaire créé ;
* la [[Spécial:Index/Modèle:Contenu de sommaire/Style|liste des styles disponibles]]
* la [[Spécial:Index/Modèle:Contenu de sommaire/Extension|liste des extensions disponibles]]
* la {{Lien interne|Spécial:Index/Modèle:Contenu de sommaire/Style|q=stripprefix=1|liste des styles disponibles}}.

<noinclude>[[Catégorie:Documentations des modèles]]</noinclude>

Version du 28 octobre 2013 à 21:34

Ceci est la sous-page de documentation du modèle {{Contenu de sommaire}} ; elle est insérée sur la page de celui-ci à l’aide du modèle {{Documentation}}. C’est également sur cette page que vous placerez les liens interwiki et les catégories du modèle.

Utilisation

Ce modèle permet de créer un sommaire pour un livre. Vous pouvez le placer dans la sous-page Sommaire (par exemple : Livre de ceci cela/Sommaire), et ainsi l’afficher automatiquement grâce au modèle {{Sommaire}}.

Ce modèle est aussi disponible en tant que {{Chapitres}}.

Syntaxe

{{Contenu de sommaire | style = {{{style|autre}}} | Chapitre 1 | Chapitre 2 | ... }}

Vous ajoutez autant de chapitres que nécessaire. Le titre du chapitre ne doit pas comporter de fioritures car il est utilisé comme lien (pas de mise en italique, de tags html, ...).

Le titre du chapitre peut être suivi des champs suivants :

  • l’état d’avancement du chapitre (nombre entre 0 et 100),
  • une image illustrant le chapitre ;

ces informations pourront être utilisés par le style (dépend du style).

{{Contenu de sommaire | style = {{{style|autre}}}
  | Chapitre 1 | avancement 1 | [[Image:une_image]]
  | Chapitre 2 | avancement 2 | [[Image:autre_image]] | ... }}

Note: si le titre d’un chapitre est composé seulement d’un nombre et que le chapitre précédent n’a pas de champ avancement associé, vous devrez doubler la barre verticale pour marquer la séparation (voir les exemples ci-dessous).

Niveaux et titres

Il est possible de faire des sous-chapitres en faisant précéder le nom du chapitre par autant de signes plus (+) que de niveaux souhaités; par contre on ne pourra descendre que d’un niveau à la fois.

Il est également possible d’ajouter un titre à la place d’un chapitre en le faisant précéder d’un point d’exclamation (!).

Paramètres

style
Devrait toujours être {{{style|autre}}} pour pouvoir définir le style à partir du modèle {{Sommaire}} ; autre (peut être vide) permet de décider quel style utiliser lorsqu’il n’est pas défini par {{Sommaire}} (vous pouvez mettre par exemple celui qui est le plus employé). Attention: vous devez ici utiliser le préfixe sommaire ou navigation.
Si le style n’est pas donné lors de l’appel à {{Contenu de sommaire}}, le style par défaut sera utilisé : c’est normalement une redirection vers un autre style.
Note: le style sommaire personnalisé permet d’utiliser un style propre au livre.
à plat
Indique que le livre possède une structure à un seul niveau (pas de sous-sous-pages). Les valeurs reconnues pour ce paramètre sont : oui, true, 1, non, false et 0.
liens automatiques
Permet de gérer l’ajout automatique des liens Glossaire, Auteurs, Bibliographie, Index et Licence : par défaut, ils seront affichés si les pages correspondantes existent ; si le paramètre a la valeur oui, true ou 1, ils seront affichés même si les pages corresondantes n’existent pas ; avec une valeur non, false ou 0, ces liens ne seront jamais affichés.
option ...
option ...: style, ...
Certains styles acceptent des options ; voyez la page du style pour en savoir plus. La seconde version permet de n’appliquer l’option qu’à certains styles.

Exemples

{{Contenu de sommaire|style={{{style|}}}
 |Les carrés rouges|Les ronds bleus|Les triangles verts}}
  
{{Chapitres|style={{{style|}}} |Les carrés rouges|Les ronds bleus|Les triangles verts}}
{{Contenu de sommaire
 | style = {{{style|sommaire large}}}
 | Les carrés rouges
 | Les ronds bleus
 | Les triangles verts
}}
{{Contenu de sommaire|
 | style={{{style|sommaire large}}}
 | Les carrés rouges | 5
 | Les ronds bleus | 33
 | Les triangles verts | 100
}}
{{Contenu de sommaire
 | style={{{style|sommaire bas}}}
 | option numéros seuls = 1
 | option titre = ~ | option image = Wikibooks-logo-fr.png |
 | Pommes
 | Poires | [[Image:Wikibooks-logo-fr.png]]
 | Ananas
 || 133
 | Pêches
}}

Voir aussi