Inclure des tableaux

---

Doxygen prend en charge deux façons d'insérer des tableaux dans la documentation.

La plus simple consiste à utiliser le format Markdown comme indiqué dans la section Tableaux des extensions Markdown.

Bien que ce format soit facile à utiliser et à lire, il est également assez limité. Il ne prend en charge qu'une simple grille de cellules, tandis que chaque cellule est une seule ligne de texte brut.

Pour les tableaux plus complexes, la syntaxe HTML peut être utilisée. Doxygen traitera ces tableaux et les traduira dans les différents formats de sortie (au moins pour les formats qui prennent en charge les tableaux tels que HTML et ).

Notez qu'un tableau doit au moins contenir 1 ligne (<tr>) et si un <caption> est utilisé, le <caption> doit précéder la première ligne.

Voici un exemple de tableau complexe :

<table>
<caption id="multi_row">Tableau complexe</caption>
<tr><th>Colonne 1                     <th>Colonne 2       <th>Colonne 3
<tr><td rowspan="2">cell row=1+2,col=1<td>cell row=1,col=2<td>cell row=1,col=3
<tr><td rowspan="2">cell row=2+3,col=2                    <td>cell row=2,col=3
<tr><td>cell row=3,col=1                                  <td rowspan="2">cell row=3+4,col=3
<tr><td colspan="2">cell row=4,col=1+2
<tr><td>cell row=5,col=1              <td colspan="2">cell row=5,col=2+3
<tr><td colspan="2" rowspan="2">cell row=6+7,col=1+2      <td>cell row=6,col=3
<tr>                                                      <td>cell row=7,col=3
<tr><td>cell row=8,col=1              <td>cell row=8,col=2\n
    <table>
        <tr><td>Inner cell row=1,col=1<td>Inner cell row=1,col=2
        <tr><td>Inner cell row=2,col=1<td>Inner cell row=2,col=2
    </table>
    <td>cell row=8,col=3
    <ul>
        <li>Item 1
        <li>Item 2
    </ul>
</table>

Il comporte une légende, un en-tête de tableau, plusieurs étendues de lignes et de colonnes, un tableau imbriqué comme l'une des cellules et une liste d'éléments dans une autre cellule.

Notez que les balises de fin (comme </td>) sont omises dans l'exemple ci-dessus. Ceci est autorisé et dans la sortie HTML, Doxygen ajoutera à nouveau les balises de fin.

Le résultat se présente comme suit :

On peut faire référence à la légende du tableau en utilisant \ref en utilisant l'ID de la légende comme l'étiquette.