Table = ( ( Title, TitleAbbrev? ),
( IndexTerm )*,
( Graphic+ | MediaObject+ | TGroup+ )
)
InformalTable = ( Graphic+ | MediaObject+ | TGroup+ )
TGroup = ( ColSpec*, SpanSpec*, THead?, TFoot?, TBody )
ColSpec = EMPTY
SpanSpec = EMPTY
THead = ( ColSpec*, Row+ )
TFoot = ( ColSpec*, Row+ )
TBody = ( Row+ )
Row = ( Entry | EntryTbl ) +
Entry = ( ( %tabentry.mix; )+ |
( %para.char.mix; )+
)
EntryTbl = ( ColSpec*, SpanSpec*, THead?, TBody )
|
Éléments : Table, InformalTable, Title, TitleAbbrev, IndexTerm, Graphic, MediaObject, TGroup, ColSpec, SpanSpec, THead, TFoot, TBody, Row, Entry, EntryTbl. Attributs : Frame, ColSep, RowSep, TabStyle, ToCentry, ShortEntry, Orient, PgWide, Cols, Align, Char, CharOff, TGroupStyle, ColNum, ColName, ColWidth, NameSt, NameEnd, SpanName, VAlign, MoreRows, Rotate.
Un tableau peut être défini soit avec un titre, soit sans titre. S'il est défini avec un titre, il pourra être pointé par une liste de titres (LoT) ou par des liens hypertexte (XRef ou ULink). Pour un tableau avec titre, on utilisera un élément Table, et pour un tableau sans titre, un élément InformalTable. De plus, un tableau avec titre pourra contenir un nombre quelconque de termes d'index (IndexTerm), alors qu'un tableau sans titre ne peut pas en contenir.
Un élément de tableau (Table) ou InformalTable) est constitué :
d'un titre obligatoire et d'un titre abrégé facultatif (Table seulement),
d'un nombre quelconque de termes d'index IndexTerm (Table seulement),
d'un ou plusieurs d'un des éléments suivants :
un graphique (Graphic)
un object média (MediaObject)
une portion de tableau (TGroup)
Il apparaît qu'un tableau peut être défini en DocBook soit complètement à partir d'éléments TGroup, soit simplement en faisant référence à des graphiques ou d'autres objets média à partir d'éléments Graphic ou MediaObject.
En effet, il est possible que vous utilisiez un système pour générer les tableaux différent de celui pour générer le reste du document, système qui génère des graphiques ou d'autres objets média. Dans ce cas, vous pourrez faire référence à ces graphiques ou objets média créés indépendamment de DocBook à l'aide d'éléments Graphic ou MediaObject.
Dans le cas contraire, si vous laissez au système de traitement du document le traitement des tableaux, vous pourrez utiliser un balisage DocBook à l'aide d'éléments TGroup.
L'attribut TabStyle des éléments Table et InformalTable indique le nom d'un style défini dans une feuille de style. Ce style sera utilisé par le système de traitement pour créer le tableau.
Les systèmes de traitement peuvent générer automatiquement des listes de figures, exemples et tableaux. L'attribut ToCentry de Table indique si le tableau doit être inséré dans une liste de tableaux (valeur 1) ou non (valeur 0). Dans le cas où il est inséré dans une liste, l'attribut ShortEntry permet d'indiquer si c'est le titre (valeur 0) ou le titre abrégé (valeur 1) qui doit apparaître dans l'entrée correspondante de la liste de tableaux.
L'attribut Orient des éléments Table et InformalTable indique si le tableau doit être représenté dans le même sens que le reste du document (valeur Port, pour Portrait), ou s'il doit subir une rotation de 90 degrés (valeur Land, pour Landscape, Paysage). Land, for Landscape).
L'attribut PgWide des éléments Table et InformalTable indique si le tableau doit occuper la largeur du flux courant (valeur 0) ou la largeur totale de la page (valeur 1).
Les éléments Table et InformalTable acceptent aussi les attributs Frame, ColSep et RowSep définissant les bordures des cellules du tableau. Voir Voir la section intitulée Encadrement des cellules, pour l'utilisation de ces attributs.
Une portion de tableau TGroup définit une portion logique de tableau, ou, dans la plupart des cas, un tableau entier. On pourra utiliser plusieurs portions de tableau lorsque les spécifications de colonne varient beaucoup d'une partie de tableau à une autre.
L'élément TGroup est constitué :
d'un nombre quelconque de spécifications de colonnes (ColSpec),
d'un nombre quelconque de spécifications de colonnes étendues (SpanSpec),
d'une entête de tableau (THead), facultative,
d'un pied de tableau (TFoot), facultatif,
d'un corps de tableau (TBody).
L'élément TGroup requiert un attribut Cols indiquant le nombre de colonnes de la portion de tableau.
L'attribut TGroupStyle indique le nom d'un style défini dans une feuille de style. Ce style sera utilisé par le système de traitement pour créer la portion de tableau.
Les attributs Align, Char et CharOff permettent de définir l'alignement du texte à l'intérieur des cellules de la portion de tableau. Voir Voir la section intitulée Alignement du texte, pour l'utilisation de ces attributs.
Les attributs ColSep et RowSep définissent les bordures des cellules de cette portion de tableau. S'ils ne sont pas spécifiés, leurs valeurs sont héritées de l'élément Table englobant.