Created on Oct. 26, 2012, 1:09 p.m. by Hevok & updated on Nov. 23, 2012, 3:32 p.m. by Hevok
reST features twohree synthaxes for tables. Grid tables are complete but a lot of work, while simple tables are easy to create but limited (now raw spans, etc.). Additionally, CSV-tables are a convenient alternative.
¶
¶
----
¶
¶
**Grid table:**
¶
¶
+------------+------------+------------+
¶
| Header 1 | Header 2 | Header 3 |
¶
+============+============+============+
¶
| body row 1 | column 2 | column 3 |
¶
+------------+------------+------------+
¶
| body row 2 | Cells may span columns. |
¶
+------------+------------+------------+
¶
| body row 3 | Cells may | - Cells |
¶
+------------+ span rowns | - contain |
¶
| body row 4 | | - blocks. |
¶
+------------+------------+------------+
¶
¶
----
¶
¶
**Simple table:**
¶
¶
===== ===== ======
¶
Inputs Output
¶
------------ ------
¶
A B A or B
¶
===== ===== ======
¶
False False False
¶
True False True
¶
False True True
¶
True True True
¶
===== ===== ======
¶
¶
----
¶
¶
The table directive can be used to create a titled table:
¶
¶
.. table:: Denigma's Aspects
¶
¶
========== =========== =======
¶
Research Programming Design
¶
========== =========== =======
¶
Scientists Developers Artists
¶
Ranks Grades Titles
¶
========== =========== =======
¶
¶
----
¶
¶
**CSV table:**
¶
¶
CSV tables enable to specify explicitly the width of each column:
¶
¶
.. csv-table:: Aspects
¶
:header: "Facet", "Profession", "Achievements"
¶
:widths: 20, 20, 20
¶
¶
"Research", "Scientist", "Ranks"
¶
"Programming", "Developer", "Grades"
¶
"Design", "Artist", "Titles"
¶
¶
----
¶
¶
To refer to a table a simple hyperlink can be declared, i.e. creating a hyper-table_.
¶
¶
.. _hyper-table:
¶
¶
+--------------+------+
¶
|Attribute |value |
¶
+==============+======+
¶
|implementation|simple|
¶
+--------------+------+
¶
|usability |high |
¶
+--------------+------+
¶
|acceptance |yes |
¶
+--------------+------+
Comment on This Data Unit