我使用 Sphinx 生成 HTML 和 PDF 文档。默认的 PDF 输出到现在还可以，但是我的经理给我发了一个 Word .dotx 模板并说 PDF 应该是相同的“企业”样式。
那么问题来了，如何更改 PDF 输出的样式？
conf.py 文件提供了一些选项，例如 latex_logo（但是如果我需要在标题页上放 2 张图像怎么办？）和带有一些参数的“前导”部分。但我找不到任何手册或可用参数的描述。
例如，如何定义图片对齐、文字环绕、表格线条颜色等？
【问题讨论】：
标签： latex python-sphinx
在您的情况下，Sphinx 生成 LaTeX 输出，然后调用 LaTeX 编译器生成最终 PDF。这意味着您的样式在很大程度上由 LaTeX 中给出的选项控制。具体问题也可以网上搜索LaTeX，不一定是Sphinx。例如，您可以搜索“LaTeX 图形对齐”而不是“Sphinx PDF 图形对齐”。
要更改图形对齐方式，请使用latex_elements 中的选项figure_align。例如，'figure_align': 'ht' 会尽可能将数字放在插入点，否则会退回到页面顶部。您可以结帐here 进行 LaTeX 图形对齐。
preamble 是一个非常灵活的选项。 preamble 的内容被插入到生成的 LaTeX 源文件的顶部。它允许您插入LaTeX 提供的原始选项。例如，如果您想将表格线条颜色更改为红色，请将以下代码插入您的preamble：
\usepackage{xcolor,colortbl}
\arrayrulecolor{red}
同样，这些资源仅显示为 LaTeX 关键字资源，而不是 Sphinx (here)。 IMO 在 Internet 上的 LaTeX 相关资源中搜索您的问题是最好的方法。
另外，我还写了一篇关于Sphinx PDF输出的post，或许对你也有帮助。
【讨论】：