pdf - 狮身人面像 PDF 主题

Question

Sphinx 文档工具是否提供不同的 PDF 主题，就像提供不同的 HTML 主题一样？

我用 Google 搜索了这个问题，但找不到答案，这让我相信答案是否定的。不过，我想我应该在这里问。

谢谢。

Answer 1

首先，Sphinx 本身不会生成 PDF 输出，尽管可以通过三种通用方法从 Sphinx 源文件获取 PDF 输出:

1. 使用 Latex 构建器，然后使用 Latex2pdf 等单独的工具来生成 PDF 输出
2. 使用 rst2pdf project 中的 Sphinx 插件
3. 使用rinoh Sphinx 构建器由 rinohtype 提供

话虽如此，使用任一方法自定义 PDF 输出样式都有很大的潜力。

1. 使用 Latex->pdf 方法时，您可以使用 sphinx 配置文件中的多个选项自定义 Latex 输出。请参阅here 。不过，此方法比 Sphinx 用于 HTML 生成的 HTML 主题稍微不太方便(IMO)。
2. 使用 rst2pdf 时，您可以定义自己的样式表，manual 中有更详细的描述。 (查看“样式”标题下)。 rst2pdf 包含许多样式表，可以将它们组合起来以获得各种结果。当然，您也可以修改它们或创建自己的文件(它们只是 JSON 文件)。这些样式表还支持某种继承，因此与之前的方法相比，其行为更像 Sphinx HTML 主题。
3. rinohtype 对文档样式有广泛的规定。请参阅Basic Document Styling以及 rinohtype 手册的后续部分。