Modèle:Table/documentation

Documentation

Ceci est la page de documentation du modèle dont le code wiki est dans la page Modèle:Table [historique].
Cette page n’est pas destinée à être visualisée directement. Les liens utilisant des pseudo-variables peuvent paraître rompus (en rouge) ; ne pas les remplacer par des noms de pages codés en dur ni des URL.

[ v · m · h ]

Projet Scribunto : Aide · Catégorie:Modules · Index complet des modules et de leur documentation · {{Module|nom du module}} · {{Modèle utilisant les modules Lua}}
Modules de base : Documentation module · String · List · Wikibase · TNT

Ce modèle utilise le module Table, un script écrit dans le langage de programmation Lua. Toute expérimentation devrait être conduite d’abord via sa sous-page de bac à sable. Voir le Projet:Scribunto (de la Wikipédia en français) si vous voulez en savoir plus.

Description

Ce modèle s’utilise pour créer une entrée de type table des matières, ou pour des tableaux simples.
Une entrée de table des matières comprend trois parties, de gauche à droite :

• (optionnellement) le numéro de la section ;
• un libellé ;
• le numéro de page.

Syntaxe

Exemple de syntaxe simple

{{Table
| titre = 
| page = {{pli||}}
| indentation = 0}}

Paramètres

Paramètres généraux :

| espace= : marge avant et après l’entrée (par défaut : 0.125em).

| largeur= : largeur totale (par défaut : 100%).

| align= : alignement de la table (par défaut : center), valeurs possibles : left, right.

| couleur= : couleur du texte et des pointillés (par défaut la couleur courante non modifiée).

| couleur_fond= : couleur de l’arrière-plan (par défaut : #FFFFFF (blanc) si des pointillés sont présents, sinon transparent).

Paramètres concernant l'affichage du numéro de section :

| section= : numéro du chapitre, section (à séparer uniquement si ces numéros s’alignent à droite avant le titre).

| largeurs= : largeur de la cellule contenant la section, en pixels (par défaut : 45).

| aligns= : alignement de la section (par défaut : right), valeurs possibles : left, center.

Paramètres concernant l'affichage du libellé :

| titre= : libellé du chapitre ou de la section (en mettant le lien de la page, on pourra accéder directement à cette partie de texte).

| indentation= : alinéa de la première ligne, positive ou négative (par défaut en em : 0).

| indentation_unit = : unité d’indentation (par défaut : em).

| text_align= : alignement du texte (par défaut : justify), valeurs possibles : left, center, right.

Paramètres concernant l'affichage du numéro de page :

| nodots (ou 1 = nodots) : si présent, supprime les pointillés (utile surtout s’il n’y a pas de numéro de page aligné à droite).

| page= : numéro de la page (en mettant le lien de la page .djvu, on pourra accéder directement au mode page). Le modèle {{pli}} permet de construire un lien à partir du numéro de page et d'un décalage, sans inscrire à chaque fois le nom du fichier.

| largeurp= : largeur de la cellule contenant les pages en pixels (par défaut : 0).

}}

Exemples

Code de l’exemple ci-dessous

{{Table|largeur=50%|align=right|couleur=red|couleur_fond=rgb(255,249,83)
| section=I.
| titre=[[Macbeth]]
| nodots
| page=71
}}
{{Table|largeur=50%|align=right|couleur=red|couleur_fond=rgb(255,249,83)
| section=II.
| titre=[[Le roi Jean/Traduction Hugo|Le roi Jean]]
| nodots
| page=175
}}
{{Table|largeur=50%|align=right|couleur=red|couleur_fond=rgb(255,249,83)
| section=III.
| titre=[[Richard III]]
| nodots
| page=281
}}

Remarque : la balise rgb(255,249,83) assigne la couleur de l’arrière-plan du modèle documentation, voir ici pour les autres formats.

 

I. 

Macbeth

71

II. 

Le roi Jean

175

III. 

Richard III

281

Code de l’exemple ci-dessous

{{Table|section=I.|aligns=left|titre=[[De la Terre à la Lune/Chapitre 1|Le Gun-Club]]|page=[[Page:Verne - De la Terre à la lune.djvu/5|1]]|indentation=-1}}
{{Table|section=II.|aligns=left|titre=[[De la Terre à la Lune/Chapitre 2|Communication du Président Barbicane]]|page=[[Page:Verne - De la Terre à la lune.djvu/12|8]]|indentation=-1}}
{{Table|section=III.|aligns=left|titre=[[De la Terre à la Lune/Chapitre 3|Effet de la communication Barbicane]]|page=[[Page:Verne - De la Terre à la lune.djvu/19|15]]|indentation=-1}}

 

I. 

Le Gun-Club 

 1

II. 

Communication du Président Barbicane 

 8

III. 

Effet de la communication Barbicane 

 15

Code de l’exemple ci-dessous

{{Table|largeur=36em|largeurp=50|indentation=-1
| titre = [[Mémoires historiques et physiques sur les tremblemens de terre/Mémoire 1|I. {{sc|Mémoire}}]]. Théorie générale des tremblemens de terre
| page = [[Page:Bertrand - Mémoires historiques et physiques sur les tremblemens de terre.djvu/5|''Page'' 1.]]
}}
{{Table|largeur=36em|largeurp=50|indentation=-1
| titre = [[Mémoires historiques et physiques sur les tremblemens de terre/Mémoire 2|II. {{sc|Mémoire}}]]. Relation chronologique des tremblemens de terre de la Suisse, depuis le VIe. Siècle jusqu’à nos jours. On a joint dans cette relation les tremblemens des autres Pays, qui coïncident avec ceux de la Suisse. On y fait en particulier observer ces secousses, qui semblent parcourir tout le globe de la terre.
| page = [[Page:Bertrand - Mémoires historiques et physiques sur les tremblemens de terre.djvu/26|''Page'' 22.]]
}}

 

I. Mémoire. Théorie générale des tremblemens de terre 

 Page 1.

II. Mémoire. Relation chronologique des tremblemens de terre de la Suisse, depuis le VIe. Siècle jusqu’à nos jours. On a joint dans cette relation les tremblemens des autres Pays, qui coïncident avec ceux de la Suisse. On y fait en particulier observer ces secousses, qui semblent parcourir tout le globe de la terre. 

 Page 22.

Code de l’exemple ci-dessous

{{Table|largeur=36em|largeurp=50
| titre = [[Mémoires historiques et physiques sur les tremblemens de terre/Mémoire 1|I. {{sc|Mémoire}}]]. Théorie générale des tremblemens de terre
| page = [[Page:Bertrand - Mémoires historiques et physiques sur les tremblemens de terre.djvu/5|''Page'' 1.]]
}}
{{Table|largeur=36em|largeurp=50
| titre = [[Mémoires historiques et physiques sur les tremblemens de terre/Mémoire 2|II. {{sc|Mémoire}}]]. Relation chronologique des tremblemens de terre de la Suisse, depuis le VIe. Siècle jusqu’à nos jours. On a joint dans cette relation les tremblemens des autres Pays, qui coïncident avec ceux de la Suisse. On y fait en particulier observer ces secousses, qui semblent parcourir tout le globe de la terre.
| page = [[Page:Bertrand - Mémoires historiques et physiques sur les tremblemens de terre.djvu/26|''Page'' 22.]]
}}

 

I. Mémoire. Théorie générale des tremblemens de terre 

 Page 1.

II. Mémoire. Relation chronologique des tremblemens de terre de la Suisse, depuis le VIe. Siècle jusqu’à nos jours. On a joint dans cette relation les tremblemens des autres Pays, qui coïncident avec ceux de la Suisse. On y fait en particulier observer ces secousses, qui semblent parcourir tout le globe de la terre. 

 Page 22.

Code de l’exemple ci-dessous

{{Table|largeur=36em|largeurs=80|largeurp=50
| nodots
| page = <small>''Page''</small>
}}
{{Table|largeur=36em|largeurs=80|largeurp=50
| section = [[Mémoires historiques et physiques sur les tremblemens de terre/Mémoire 1|Chapitre I. —]]
| titre = {{sc|Mémoire}}. Théorie générale des tremblemens de terre
| page = [[Page:Bertrand - Mémoires historiques et physiques sur les tremblemens de terre.djvu/5|1]]
}}
{{Table|largeur=36em|largeurs=80|largeurp=50
| section = [[Mémoires historiques et physiques sur les tremblemens de terre/Mémoire 1|II. —]]
| titre = {{sc|Mémoire}}. Relation chronologique des tremblemens de terre de la Suisse, depuis le VIe. Siècle jusqu’à nos jours. On a joint dans cette relation les tremblemens des autres Pays, qui coïncident avec ceux de la Suisse. On y fait en particulier observer ces secousses, qui semblent parcourir tout le globe de la terre.
| page = [[Page:Bertrand - Mémoires historiques et physiques sur les tremblemens de terre.djvu/26|22]]
}}

 

Page

Chapitre I. — 

Mémoire. Théorie générale des tremblemens de terre 

 1

II. — 

Mémoire. Relation chronologique des tremblemens de terre de la Suisse, depuis le VIe. Siècle jusqu’à nos jours. On a joint dans cette relation les tremblemens des autres Pays, qui coïncident avec ceux de la Suisse. On y fait en particulier observer ces secousses, qui semblent parcourir tout le globe de la terre. 

 22

Entrée de table éclatée sur deux pages

Lorsqu'une entrée de table commence au bas d'une page et se poursuit en haut de la page suivante, il est possible de concilier la mise en page originale tout en assurant une transclusion correcte. On utilise pour ce faire une habile combinaison de balises <noinclude> et <includeonly> d'une part, et des valeurs particulières de page=  et section=  pour les alignements.

Code de l’exemple ci-dessous

Au bas de la première page :

{{table|largeurp=35|indentation=-2
|titre=[[La Révolte des anges/16|Chapitre XVI]] — ''Qui met tour à tour en scène Mira la Voyante, Zéphyrine et le fatal Amédée, et qui illustre, par l’exemple terrible de {{M.|Sariette}}, cette''
<includeonly>''pensée d’Euripide, que Jupiter prive de sagesse ceux qu’il veut perdre''|page= [[Page:Anatole France - La Révolte des anges.djvu/173|161]] }}
</includeonly>
<noinclude>|page= |nodots}}
</noinclude>

Et au haut de la seconde page :

<noinclude>
{{table|largeurp=35|largeurs=30|section= 
|titre=''pensée d’Euripide, que Jupiter prive de sagesse ceux qu’il veut perdre.''|page= [[Page:Anatole France - La Révolte des anges.djvu/173|161]]
}}
</noinclude>

 

Chapitre XVI — Qui met tour à tour en scène Mira la Voyante, Zéphyrine et le fatal Amédée, et qui illustre, par l’exemple terrible de M. Sariette, cette

 

...

  

pensée d’Euripide, que Jupiter prive de sagesse ceux qu’il veut perdre. 

 161

Cas des epubs

Dans le cas de constitution d’une table des matières lisible en exportation ePub, il faudra :

1. Constituer chaque entrée de la table par le modèle table en veillant à bien utiliser les Titrex ({{t2}}, {{t3}}, ({{t4}}).
2. Constituer les chapitres/sections sur une page d’appel (comme ici).
3. Exporter sur Export tool of Wikisource books (expérimental mais fonctionnel).

Remarque : le fichier ePub ou la page web constituée aura deux liens hypertexts : le libellé de l’entrée permettra d’accéder au texte, quant au folio (numéro de page), il donne l’accès de la page source en mode page.

Voir aussi

• {{Page link}} (ou {{Pli}}) : pour faciliter l'établissement de liens vers les pages
• {{t2}} : titre de 2^e niveau mais de 1^er niveau d’un livre
• {{t3}} : titre de 3^e niveau mais de 2^e niveau d’un livre
• {{t4}} : titre de 4^e niveau mais de 3^e niveau d’un livre
• {{Ebook-Tn}} : crée une ligne de sommaire pour un ebook