python-sphinx - csv 表格式通过序言？

Question

尽我所能，我无法弄清楚如何更改 sphinx 输出的 pdf 中的默认表格格式。

我可以编辑 .tex 文件或 writer.py 源代码...但这两个似乎都是不好的选择。

是否有任何东西可以传递到序言来实现这一点？

Answer 1

取决于您试图通过更改表格格式来完成什么。例如，如果您想要定义行颜色并在整个文档中相应地更改表格，您可以同时使用 xcolor 包并通过更改表格环境来重新定义表格在定义点处理它的方式。

所以在序言中你会做

\usepackage[table]{xcolor}
\definecolor{foo}{RGB}{236,137,29}
\definecolor{bar}{RGB}{232,108,31}

\let\newtabular\tabular
\let\newendtabular\endtabular
\renewenvironment{tabular}{\rowcolors{2}{foo}{bar}\newtabular}{\newendtabular}

这将覆盖默认的表格环境，并在整个文档中应用 foo 和 bar 行颜色，从第二行开始。

有更多与表相关的指令。你应该看看sphinxtr

Jeff Terrace 包含一些很棒的扩展，但要使用的两个主要扩展是 numfig和 figtable .您可以将 csv 表包装到 figtable 中。

.. figtable::
   :label: my-csv-label
   :caption: My CSV Table
   :nofig:

   .. csv-table::
     :file: data/foo.csv
     :header-rows: 1

使用下面而不是上面的标题更改标准表格格式。然后，您还可以获得额外的好处，即能够使用 :num: 直接链接到该表。

:num:`Table #my-csv-label`

它会自动相应编号，而不引用标签名称。您还可以使用

.. figtable::
   :spec: {r l r l}

为了更好地定义您希望表格的显示方式。