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 | ¶
+--------------+------+