IntenseWebs/sphinx
3
0
Fork 0
mirror of https://github.com/sphinx-doc/sphinx.git synced 2025-02-25 18:55:22 -06:00
Code Issues Packages Projects Releases Wiki Activity

Even more tweaking of the latex tabular environment selection code.

Browse Source
This commit is contained in:
Georg Brandl
2011-01-03 23:34:57 +01:00
parent 256517b902
commit 63db45dea9
2 changed files with 25 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
doc/markup/misc.rst
View File

@@ -124,10 +124,16 @@ following directive exists:
.. warning::
Tables that contain block-level elements such as object descriptions, literal
blocks, blockquotes or any kind of lists cannot be set with ``tabulary``.
They are therefore set with the standard LaTeX ``tabular`` environment.
Also, the verbatim environment used for literal blocks only works in
``p{width}`` columns, which means that by default, Sphinx generates such
column specs for such tables. Use the :rst:dir:`tabularcolumns` directive to
get finer control over such tables.
Tables that contain list-like elements such as object descriptions,
blockquotes or any kind of lists cannot be set out of the box with
``tabulary``. They are therefore set with the standard LaTeX ``tabular``
environment if you don't give a ``tabularcolumns`` directive. If you do, the
table will be set with ``tabulary``, but you must use the ``p{width}``
construct for the columns that contain these elements.
Literal blocks do not work with ``tabulary`` at all, so tables containing a
literal block are always set with ``tabular``. Also, the verbatim
environment used for literal blocks only works in ``p{width}`` columns, which
means that by default, Sphinx generates such column specs for such tables.
Use the :rst:dir:`tabularcolumns` directive to get finer control over such
tables.