Sphinx LaTeXPDF 输出：如何更改“样式”

Question

我使用 Sphinx 生成 HTML 和 PDF 文档。到目前为止，默认的 PDF 输出还可以，但我的经理给我发了一个 Word .dotx 模板，并说 PDF 应该是相同的“企业”风格。

那么问题来了，如何更改PDF输出的样式呢？

conf.py 文件提供了一些选项，例如 Latex_logo（但是如果我在标题页上需要 2 个图像怎么办？）和带有一些参数的“preamb”部分。但我找不到可用参数的任何手册或描述。

例如，如何定义图片对齐、文字换行、表格线条颜色等？

Answer 1

在您的情况下，Sphinx 生成 LaTeX 输出，然后调用 LaTeX 编译器生成最终的 PDF。这意味着你的风格很大程度上是由 LaTeX 中给出的选项控制的。具体问题也可以网上搜索

LaTeX

，不一定是Sphinx。例如，您可以搜索“LaTeX 图形对齐”而不是“Sphinx PDF 图形对齐”。

要更改图形对齐方式，请使用

figure_align

中的

latex_elements

选项。例如，如果可能的话，

'figure_align': 'ht'

会将数字放在插入点，否则它会回落到页面顶部。您可以在此处查看 LaTeX 图形对齐。

preamble

是一个非常灵活的选项。

preamble

的内容被插入到生成的 LaTeX 源文件的顶部某处。它允许您插入

LaTeX

提供的原始选项。例如，如果您想将表格线条颜色更改为红色，请将以下代码插入到您的

preamble

:

\usepackage{xcolor,colortbl}
\arrayrulecolor{red}

再次强调，这些资源仅显示为

LaTeX

关键字资源，而不是 Sphinx（此处）。 IMO 在互联网上搜索 LaTeX 相关资源中的问题是最好的方法。

另外，我还写了一篇与Sphinx PDF输出相关的帖子（断开的链接），这可能对你也有帮助。