Tables
Grid Tables
It is possible to include tables directly using reStructuredText grids (though it can a lot of typing for larger tables):
+------------------------+------------+----------+----------+
| Header row, column 1 | Header 2 | Header 3 | Header 4 |
| (header rows optional) | | | |
+========================+============+==========+==========+
| body row 1, column 1 | column 2 | column 3 | column 4 |
+------------------------+------------+----------+----------+
| body row 2 | Cells may span columns. |
+------------------------+------------+---------------------+
| body row 3 | Cells may | - Table cells |
+------------------------+ span rows. | - contain |
| body row 4 | | - body elements. |
+------------------------+------------+----------+----------+
| body row 5 | Cells may also be | |
| | empty: ``-->`` | |
+------------------------+-----------------------+----------+
Header row, column 1 (header rows optional) |
Header 2 |
Header 3 |
Header 4 |
---|---|---|---|
body row 1, column 1 |
column 2 |
column 3 |
column 4 |
body row 2 |
Cells may span columns. |
||
body row 3 |
Cells may span rows. |
|
|
body row 4 |
|||
body row 5 |
Cells may also be
empty: |
Various generators can be used to make this process less tiresome, e.g. reStructuredText Table Editor and Generator
CSV Tables
Tables can also be loaded from CSV files:
.. csv-table:: CSV Title
:file: table-1.csv
:header-rows: 1
id |
service_id |
valid_from |
valid_to |
freq |
byday |
description |
opens_at |
closes_at |
---|---|---|---|---|---|---|---|---|
1098 |
35 |
2020-04-01 |
2020-12-20 |
WEEKLY |
MO,TU,WE,TH |
Monday to Thursday, 9-12 am |
09:00 |
12:00 |
1099 |
35 |
2020-04-01 |
2020-12-20 |
WEEKLY |
MO,TU,WE,TH |
Monday to Thursday, 3-5 pm |
15:00 |
17:00 |
Or included inline:
.. csv-table:: Optional title
:header: "Animal", "Furry", "Pettability [a.u.]"
"Cat", "Yes", 9
"Dog", "Yes", 9
"Naked mole rat", "No", 5
Animal |
Furry |
Pettability [a.u.] |
---|---|---|
Cat |
Yes |
9 |
Dog |
Yes |
9 |
Naked mole rat |
No |
5 |
List Tables
Tables can also be created from lists:
.. list-table:: Table Title
:widths: 25 25 50
:header-rows: 1
* - Heading row 1, column 1
- Heading row 1, column 2
- Heading row 1, column 3
* - Row 1, column 1
-
- Row 1, column 3
* - Row 2, column 1
- Row 2, column 2
- Row 2, column 3
Heading row 1, column 1 |
Heading row 1, column 2 |
Heading row 1, column 3 |
---|---|---|
Row 1, column 1 |
Row 1, column 3 |
|
Row 2, column 1 |
Row 2, column 2 |
Row 2, column 3 |