1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.12"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>Doxygen: Including tables</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtreedata.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript">
$(document).ready(initResizable);
</script>
<link href="doxygen_manual.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">Doxygen
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.12 -->
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<div id="nav-tree-contents">
<div id="nav-sync" class="sync"></div>
</div>
</div>
<div id="splitbar" style="-moz-user-select:none;"
class="ui-resizable-handle">
</div>
</div>
<script type="text/javascript">
$(document).ready(function(){initNavTree('tables.html','');});
</script>
<div id="doc-content">
<div class="header">
<div class="headertitle">
<div class="title">Including tables </div> </div>
</div><!--header-->
<div class="contents">
<div class="textblock"><p>Doxygen supports two ways to put tables in the documentation.</p>
<p>The easiest is to use the Markdown format as shown in <a class="el" href="markdown.html#markdown_extra">Markdown Extensions</a> section <a class="el" href="markdown.html#md_tables">Tables</a>.</p>
<p>Although this format is easy to use and read, it is also rather limited. It supports only a simple grid of cells, while each cell is a single line of plain text.</p>
<p>For more complex tables the HTML syntax can be used. Doxygen will process such tables and translate them to the various output formats (at least for the formats that do support tables such as HTML and <img class="formulaInl" alt="$\mbox{\LaTeX}$" src="form_0.png"/>).</p>
<p>Here is an example of a complex table:</p>
<pre class="fragment"><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>
</pre><p>It has a caption, table heading, various row and column spans, a nested table as one of the cells, and a item list in another cell.</p>
<p>Note that the end tags (like <code></td></code>) are left out in the example above. This is allowed, and in the HTML output doxygen will add the end tags again.</p>
<p>The output will look as follows:</p>
<a class="anchor" id="multi_row"></a>
<table class="doxtable">
<caption>Complex table</caption>
<tr>
<th>Column 1 </th><th>Column 2 </th><th>Column 3 </th></tr>
<tr>
<td rowspan="2">cell row=1+2,col=1</td><td>cell row=1,col=2</td><td>cell row=1,col=3 </td></tr>
<tr>
<td rowspan="2">cell row=2+3,col=2 </td><td>cell row=2,col=3 </td></tr>
<tr>
<td>cell row=3,col=1 </td><td rowspan="2">cell row=3+4,col=3 </td></tr>
<tr>
<td colspan="2">cell row=4,col=1+2 </td></tr>
<tr>
<td>cell row=5,col=1 </td><td colspan="2">cell row=5,col=2+3 </td></tr>
<tr>
<td colspan="2" rowspan="2">cell row=6+7,col=1+2 </td><td>cell row=6,col=3 </td></tr>
<tr>
<td>cell row=7,col=3 </td></tr>
<tr>
<td>cell row=8,col=1 </td><td>cell row=8,col=2<br />
<table class="doxtable">
<tr>
<td>Inner cell row=1,col=1</td><td>Inner cell row=1,col=2 </td></tr>
<tr>
<td>Inner cell row=2,col=1</td><td>Inner cell row=2,col=2 </td></tr>
</table>
</td><td>cell row=8,col=3 <ul>
<li>
Item 1 </li>
<li>
Item 2 </li>
</ul>
</td></tr>
</table>
<p>One can refer to the caption of the table using <a class="el" href="commands.html#cmdref">\ref</a> using the caption's id as the label.</p>
<p>
Go to the <a href="diagrams.html">next</a> section or return to the
<a href="index.html">index</a>.
</p>
</div></div><!-- contents -->
</div><!-- doc-content -->
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
<ul>
<li class="footer">Generated by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.12 </li>
</ul>
</div>
</body>
</html>
|
