我如何在Sphinx的latexpdf输出中插入前端物质

Question

我们正在考虑在我工作的地方使用Sphinx，它似乎满足我们所需的一切。但是，我遇到的问题需要匹配所需的公司模板，这需要在标题页和目录之间插入一些前置事项页面。

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

.. toctree:: 
    :hidden: 

    frontmatter 


.. toctree:: 
    :maxdepth: 2 

    contents_of_document 

我知道这已经是可能的，因为人们在使用这个工具出版的书，但我无法弄清楚如何做到这一点。

我试过这个与狮身人面像1.4.0和1.4.1。这是我需要添加一个乳胶猪圈或cls文件，使其工作？我不想因为我们想使用HTML和PDF输出。

谢谢

Answer 1

它看起来像我需要RTFM。它在狮身人面像手册的第10章至：

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

因此，为了做到这一点，您需要学习一些LaTeX，因为您将不得不手动（或编程）将文档从reST文档中单独写入。