index.rst 中的标题不会出现在 LaTeX 版本中

Question

我正在尝试从 RST 文档构建 PDF。 在这种情况下 index.rst 文档不为空：

############
How to Build
############

The build blah blah balh 

.. toctree::
   :hidden:

   file1
   file2
   file3

In the PDF output, the text "The build blah blah balh" appears without any heading at all, The HTML output is OK (the heading "How to Build" appears correctly), which is why I categorized it as a LaTeX issue. 不是狮身人面像的。

有什么办法可以让这个标题出现在 PDF 中？

笔记：

文档来自其他团队，因此我无法在某个点之外对其进行编辑。 例如，我无法将 index.rst 中的所有内容移动到另一个新文件中（这会非常方便）。

Answer 1

LaTeX 构建器生成的文档通常以标题页开头，其中包含文档标题、作者和出版日期，然后是目录，然后是目录中列出的各个章节/章节。 因此，您在此处尝试完成的是添加一些标题未显示在目录中的标题。 这有点不寻常。

我们可以告诉 Sphinx 使用根文档 ( index.rst ) 中的顶级标题作为 conf.py 中的conf.py 文档标题：

latex_documents = [
    ('index', 'output.tex', '', 'Author Name', 'manual', False)
]

对于问题中的示例，第三个 position 中的空字符串将替换为“如何构建”并出现在标题页上。 这与 HTML output 一致，这里是起始页的标题。

但是，文档标题不是节标题，然后出现以下段落而没有节标题。 解决方案是添加额外的部分标题，但仅在 LaTeX 文档中，而不是在 HTML 版本中。

############
How to Build
############

.. raw:: latex

    \section*{How to Build}

这仅使用raw指令在 LaTeX 文档中插入未编号的节标题。