包括表
Doxygen支持将表放入文档中的两种方法。
最简单的方法是使用Markdown扩展部分Tables中所示的Markdown格式。
尽管此格式易于使用和阅读,但也相当有限。它仅支持一个简单的单元格网格,而每个单元格都是一行纯文本。
对于更复杂的表,可以使用HTML语法。Doxygen将处理此类表格并将其转换为各种输出格式(至少对于支持表格的格式,例如HTML和)。
请注意,一个表至少应包含1行(),如果使用a,则该表
应位于第一行之前。
这是一个复杂表的示例:
<表格>
<caption id =“ multi_row”>复杂表</ caption>
<tr> <th>第1列<th>第2列<th>第3列
<tr> <td rowspan =“ 2”>单元格行= 1 + 2,col = 1 <td>单元格行= 1,col = 2 <td>单元格行= 1,col = 3
<tr> <td rowspan =“ 2”>单元格行= 2 + 3,col = 2 <td>单元格行= 2,col = 3
<tr> <td>单元格行= 3,col = 1 <td rowspan =“ 2”>单元格行= 3 + 4,col = 3
<tr> <td colspan =“ 2”>单元格行= 4,col = 1 + 2
<tr> <td>单元格行= 5,col = 1 <td colspan =“ 2”>单元格行= 5,col = 2 + 3
<tr> <td colspan =“ 2” rowspan =“ 2”>单元格行= 6 + 7,col = 1 + 2 <td>单元格行= 6,col = 3
<tr> <td>单元格行= 7,col = 3
<tr> <td>单元格行= 8,col = 1 <td>单元格行= 8,col = 2 \ n
<表格>
<tr> <td>内部单元格行= 1,col = 1 <td>内部单元格行= 1,col = 2
<tr> <td>内部单元格行= 2,col = 1 <td>内部单元格行= 2,col = 2
</ table>
<td>单元格行= 8,col = 3
<ul>
<li>项目1
<li>项目2
</ ul>
</ table>
它具有标题,表标题,各种行和列跨度,作为一个单元格的嵌套表以及在另一个单元格中的项目列表。
请注意,在``上面的示例中省略了结束标记(如)。这是允许的,并且在HTML输出中doxygen将再次添加结束标签。
输出将如下所示:
第1栏 | 第2栏 | 第三栏 |
---|---|---|
单元格行= 1 + 2,列= 1 | 单元格行= 1,col = 2 | 单元格行= 1,col = 3 |
单元格行= 2 + 3,col = 2 | 单元格行= 2,col = 3 | |
单元格行= 3,col = 1 | 单元格行= 3 + 4,col = 3 | |
单元格行= 4,col = 1 + 2 | ||
单元格行= 5,col = 1 | 单元格行= 5,col = 2 + 3 | |
单元格行= 6 + 7,col = 1 + 2 | 单元格行= 6,col = 3 | |
单元格行= 7,col = 3 | ||
单元格行= 8,col = 1 | 单元格行= 8,col = 2 内部单元格行= 1,col = 1内部单元格行= 1,col = 2内部单元格行= 2,col = 1内部单元格行= 2,col = 2 | 单元格行= 8,col = 3项目1项目2 |