如何在 Sphinx 的 latexpdf 输出中插入前端内容

Question

我们正在考虑在我工作的地方使用 Sphinx，它似乎可以满足我们的一切需求。但是，我无法让它与所需的公司模板相匹配，这需要在标题页和目录之间插入一些前页。

如果 text is text 放置在 .rst 文件中的主目录之上，那么它会放置在 HTML 输出中的 TOC 之上，但它会移动到 pdf 输出中的 TOC 之下。我也试过添加一个隐藏的目录，但这也不起作用。内容也被放置在非隐藏目录之后。

.. toctree::
   :hidden:

   frontmatter


.. toctree::
   :maxdepth: 2

   contents_of_document

我知道这是可能的，因为人们已经使用这个工具出版了书籍，但我不知道该怎么做。

我已经在 sphinx 1.4.0 和 1.4.1 上试过了。这是我需要添加乳胶 sty 或 cls 文件才能使其工作的东西吗？我不想这样做，因为我们想同时使用 HTML 和 PDF 输出。

谢谢

Answer 1

看来我需要 RTFM。它在 sphinx 手册的第 10 章：

'tableofcontents' “tableofcontents” 调用，默认为 '\tableofcontents'。如果要生成不同的目录或将内容放在标题页和目录之间，请覆盖。

因此，为了做到这一点，您需要学习一些 LaTeX，因为您必须手动（或以编程方式）将 from 与 reST 文档分开编写。