调整 pdf 输出的表格宽度以完全适合线宽

Question

我的公司使用 Sphinx 来创建我们的用户手册，并且我们正在广泛使用不同种类的表格。在许多情况下，需要手动调整表格的列宽以生成高质量的 pdf 输出。

为此我尝试使用：

.. tabularcolumns:: |p{0.2\linewidth}|p{0.8\linewidth}|

+------+--------+
| A    | B      |
+------+--------+

我的意图是，表格应该完全适合周围的文字， 但有一点重叠。似乎百分比并没有考虑内盒占用的空间。

我怎样才能正确地计算出必要的数量，以使盒子整齐地适合空间？

Answer 1

使用 Sphinx 1.6 或更高版本，您可以使用

.. tabularcolumns:: |\Y{0.2}|\Y{0.8}|

（它是\Y，而不是Y。）见http://www.sphinx-doc.org/en/stable/markup/misc.html?highlight=tabularcolumns#directive-tabularcolumns。

对于 Sphinx 1.5 或更高版本，您可以使用 |\X{2}{10}|\X{8}{10}|。

使用 Sphinx

\newcolumntype{\X}[2]{p{\dimexpr
      (\linewidth-\arrayrulewidth)*#1/#2-2\tabcolsep-\arrayrulewidth\relax}}
\newcolumntype{\Y}[1]{p{\dimexpr
      #1\dimexpr\linewidth-\arrayrulewidth\relax-2\tabcolsep-\arrayrulewidth\relax}}

来自当前的sphinx.sty，它解释了\X 和\Y 的定义方式。