Modèle:Table/documentation

Documentation
Logo du langage Lua.
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.

DescriptionModifier

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.

SyntaxeModifier

  • Exemple de syntaxe simple
{{Table
| titre = 
| page = {{pli||}}
}}
  • Autre Exemple de syntaxe simple
{{Table
| section = 
| titre = 
| page = {{pli||}}
}}

ParamètresModifier

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).
}}

ExemplesModifier

Code wiki Rendu
{{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
}}
71
175
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.
Code wiki Rendu
{{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}}
Code wiki Rendu
{{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 
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. 
Code wiki Rendu
{{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 
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. 
Code wiki Rendu
{{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
Mémoire. Théorie générale des tremblemens de terre 
 1
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=&nbsp; et section=&nbsp; pour les alignements.
Code wiki Rendu
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 XVIQui 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 epubsModifier

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 hypertextes : 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 aussiModifier

  • {{Page link}} (ou {{Pli}}) : pour faciliter l'établissement de liens vers les pages
  • {{t2}} : titre de 2e niveau mais de 1er niveau d’un livre
  • {{t3}} : titre de 3e niveau mais de 2e niveau d’un livre
  • {{t4}} : titre de 4e niveau mais de 3e niveau d’un livre
  • {{Ebook-Tn}} : crée une ligne de sommaire pour un ebook
  • {{CorpsTdM}} : Syntaxe plus courte pour l'utilisation de nombreux modèles « Table » dans une page