Grid Table¶
About¶
sd-table – Tables with sphinx{design}.
A beautiful and generic table element based on a sphinx{design} grid layout, with top-down configuration features.
It implements the Sphinx directives sd-table
, sd-row
, and sd-item
,
and a few convenience directive options and flags on them.
Details¶
The idea of this element is to implement a table based on a grid layout, which can be parameterized using directives on the table level, so that styling details will not clutter the leaf nodes (row and item) too much.
This grid table element is an alternative to the vanilla list-table
and csv-table
directive implementations, and as such, explores a few needs of authors not provided
elsewhere.
Synopsis¶
Basic table, two columns, no formatting.
What
Description
Fox
The quick brown fox jumps over the lazy dog.
Franz
Franz jagt im komplett verwahrlosten Taxi quer durch Bayern.
Usage¶
sphinx{design} uses a classic 12-column grid layout, so, in order to use it optimally, make sure that your table item/column widths sum up to 12.
The example table defines two columns, using individual widths of 3
and 9
.
::::{sd-table}
:widths: 3 9
:::{sd-row}
```{sd-item} **What**
```
```{sd-item} **Description**
```
:::
:::{sd-row}
```{sd-item} Fox
```
```{sd-item}
The quick brown fox jumps over the lazy dog.
```
:::
:::{sd-row}
```{sd-item} Franz
```
```{sd-item}
Franz jagt im komplett verwahrlosten Taxi quer durch Bayern.
```
:::
::::
.. sd-table::
:widths: 3 9
.. sd-row::
.. sd-item:: **What**
.. sd-item:: **Description**
.. sd-row::
.. sd-item:: Fox
.. sd-item::
The quick brown fox jumps over the lazy dog.
.. sd-row::
.. sd-item:: Franz
.. sd-item::
Franz jagt im komplett verwahrlosten Taxi quer durch Bayern.
Variants¶
A few more variants how to change the visual appearance.
Visual line separators¶
By using :row-class:
on the table-level directive, row-level styles can be
assigned conveniently.
::::{sd-table}
:row-class: top-border
What
Description
Fox
The quick brown fox jumps over the lazy dog.
Franz
Franz jagt im komplett verwahrlosten Taxi quer durch Bayern.
Outlines¶
This section demonstrates different kinds of outlines, on different component levels.
Table outline¶
Using the :outline:
directive flag will draw a single border around the whole table.
::::{sd-table}
:outline:
What
Description
Fox
The quick brown fox jumps over the lazy dog.
Franz
Franz jagt im komplett verwahrlosten Taxi quer durch Bayern.
Row outline¶
Using the :row-outline:
directive flag will draw borders around each row component.
::::{sd-table}
:row-outline:
What
Description
Fox
The quick brown fox jumps over the lazy dog.
Franz
Franz jagt im komplett verwahrlosten Taxi quer durch Bayern.
Item outline¶
Using the :item-outline:
directive flag will draw borders around each item component.
::::{sd-table}
:item-outline:
What
Description
Fox
The quick brown fox jumps over the lazy dog.
Franz
Franz jagt im komplett verwahrlosten Taxi quer durch Bayern.
This page is written in Markedly Structured Text (MyST Markdown).