Cours DocBook accelere

Chapitre 7. Les tableaux

Les balises concernées sont listées ci-dessous.

table - Tableau dans un document
informaltable - Tableau sans titre
thead - En-tête d'une ligne d'un tableau
tfoot - Pied d'une ligne d'un tableau
tgroup - Enveloppe de la partie d'un tableau qui contient une colonne avec ses informations de mise en forme
tbody - Enveloppe des lignes d'un tableau ou informaltable
row - Ligne dans un tbody, thead ou tfoot
entry - Cellule dans un tableau
entrytbl - Sous-tableau apparaissant comme une cellule de tableau

les tableaux sont utilisés pour organiser les données dans un format de colonne avec des titres optionnels, des en-têtes et des pieds. Les tableaux DocBook sont de deux sortes : la table, qui nécessite un titre et la informaltable, qui ne doit pas avoir de titre. Toutes les autres caractéristiques de ces deux types de tableaux sont identiques.

Un tableau est une mise en forme d'informations et de blocs de données. Il y a quelques attributs qui peuvent être ajustés pour améliorer l'apparence de vos données. Ce didacticiel ne présente que les attributs de fomatage de base. Pour plus de détails, voir la Référence DocBook.

Les tableaux débutent avec les balises <table> ou <informaltable>. Ensuite définissez un titre en utilisant la balise <title> si vous vous servez d'un tableau simple. Enfin, vous placez la balise <tgroup> qui contient les en-têtes, pieds et lignes. Vous pouvez avoir plus d'un tgroup si vous voulez changer les options de mise en forme pour une section du tableau. La balise <tgroup> possède plusieurs paramètres de mise en forme optionnels, mais l'attribut COLS, qui spécifie le nombre de colonnes, est nécessaire. Les <thead>, <tfoot> et <tbody> contiennent les données de votre tableau. Les données dans thead apparaissent au début du tableau, tbody apparaît au milieu et tfoot en fin de tableau.

Les données d'un tableau sont contenues dans les lignes et les éléments, désignées par les balises <row> et <entry> respectivement. Utilisez la balise <row> pour débuter une ligne, la balise <entry> pour chaque donnée et une balise de fermeture <row> pour terminer chaque ligne. Si vous voulez insérer un tableau dans un autre tableau, vous devez utiliser la balise <entrytbl>.

Exemple 7-1. Un tableau

 
<table>
<title>Kilométrage de la souris</title>
<tgroup cols="3">
<thead>
<row>
<entry>Mois</entry>
<entry>Semaine</entry>
<entry>Mètres parcourus</entry>
</row>
</thead>
<tfoot>
<row>
<entry>Total</entry>
<entry></entry>
<entry>1753</entry>
</row>
</tfoot>
<tbody>
<row>
<entry>Août</entry>
<entry>1</entry>
<entry>987</entry>
</row>
<row>
<entry>Août</entry>
<entry>2</entry>
<entry>657</entry>
</row>
<row>
<entry>Août</entry>
<entry>3</entry>
<entry>109</entry>
</row>
</tbody>
</tgroup>
</table> 

Une fois converti ça donne cela :

Tableau 7-1. Kilométrage de la souris

MoisSemaineMètres parcourus
Août1987
Août2657
Août3109
Total 1753