Doxygenは、ドキュメントにテーブルを配置する2つの方法をサポートしています。
最も簡単な方法は、Markdown拡張機能セクションテーブルに示されているように、Markdown形式を使用することです。
この形式は使いやすく読みやすいですが、かなり制限もあります。シンプルなセルのグリッドのみをサポートし、各セルは1行のプレーンテキストです。
より複雑なテーブルには、HTML構文を使用できます。Doxygenはこのようなテーブルを処理し、さまざまな出力形式(HTMLや
など、テーブルをサポートする形式の場合)に変換します。
テーブルには少なくとも1行(<tr>)を含める必要があり、<caption>を使用する場合は、<caption>が最初の行の前に来る必要があることに注意してください。
以下に複雑なテーブルの例を示します。
<table>
<caption id="multi_row">Complex table</caption>
<tr><th>Column 1 <th>Column 2 <th>Column 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>
キャプション、テーブルヘッダー、さまざまな行および列スパン、セルとしてネストされたテーブル、別のセル内の項目リストがあります。
上記の例では、終了タグ(</td>など)が省略されていることに注意してください。これは許可されており、HTML出力ではDoxygenが終了タグを再度追加します。
出力は次のようになります。
| 列1 | 列2 | 列3 | ||||
|---|---|---|---|---|---|---|
| セル 行=1+2、列=1 | セル 行=1、列=2 | セル 行=1、列=3 | ||||
| セル 行=2+3、列=2 | セル 行=2、列=3 | |||||
| セル 行=3、列=1 | セル 行=3+4、列=3 | |||||
| セル 行=4、列=1+2 | ||||||
| セル 行=5、列=1 | セル 行=5、列=2+3 | |||||
| セル 行=6+7、列=1+2 | セル 行=6、列=3 | |||||
| セル 行=7、列=3 | ||||||
| セル 行=8、列=1 | セル 行=8、列=2
| セル 行=8、列=3
| ||||
キャプションのIDをラベルとして使用して、\refを使ってテーブルのキャプションを参照できます。