The table Directive

.. table:: wraps an existing grid or simple table (given as the directive's own content) with a title/caption and the presentation options neither ASCII-art syntax has notation of its own for.

Wrapping a Grid Table

Wrapping a Simple Table

Table with a Title

The directive's argument, if given, becomes the table's caption:

:widths:

Sets relative column widths — auto and grid both let the renderer decide, while an explicit list of integers (matching the wrapped table's own column count) is normalized into percentages:

:width:

Sets the overall table width:

:align:

Aligns the table on the page — left, center, or right:

:class:

Adds extra CSS classes to the rendered <table>:

:name: and Cross-Referencing

Gives the table a hyperlink target, referenceable via :ref:. As with any other internal target in rinx today, the link resolves to this document, not precisely to the table itself.

See wrapped-fruit-table for the wrapped table above.

Domain Objects Nested Inside a Cell

A wrapped table's cells are ordinary grid/simple table cells, so they parse as full block-level RST exactly like an unwrapped one — a cell can nest a domain-object definition:

Circle.radius resolves correctly because the definition above was fully parsed rather than swallowed as opaque directive body text.