created on Oct. 26, 2012, 1:09 p.m. by Hevok & updated on Nov. 23, 2012, 3:37 p.m. by Hevok
reST features several 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 where one can define column widths. Tables can be decorated with a title and even hyperlinked.
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 ===== ===== ======
Titled table:
The table directive can be used to create a titled table:
========== =========== ======= 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: "Facets", "Professions", "Achievements" :widths: 20, 20, 20
"Research", "Scientist", "Ranks"
"Programming", "Developer", "Grades"
"Design", "Artist", "Titles"
Hyper table:
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