index.rst 中的标题不会出现在 LaTeX 构建中

Question

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

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

The build blah blah balh 

.. toctree::
   :hidden:

   file1
   file2
   file3

在 PDF 输出中，文本“The build blah blah balh”出现时根本没有任何标题！ HTML 输出正常（标题“如何构建”正确显示），这就是为什么我将其归类为 LaTeX 问题，而不是 Sphinx 问题。

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

注：

这些文档来自其他团队，所以我不能在一定程度上编辑它们。例如，我无法将 index.rst 中的所有内容移动到另一个新文件中（这会非常方便）。

Answer 1

LaTeX 生成器生成的文档通常以标题页开头，包含文档标题、作者和发布日期，然后是 table 内容，然后是个人 chapters/sections列在 table 的内容中。因此，您要在此处完成的是添加一些前言，其标题未显示在内容 table 中。这有点不寻常。

我们可以告诉 Sphinx 使用根文档 (index.rst) 中的 top-level 标题作为 conf.py:

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

用问题的例子，第三个位置的空字符串将被替换为“How to Build”并出现在扉页上。这与 HTML 输出一致，它是起始页的标题。

但是，文档标题不是节标题，因此下一段出现时没有节标题。解决方案是添加一个额外的节标题，但只能在 LaTeX 文档中，而不是在 HTML 构建中。

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

.. raw:: latex

    \section*{How to Build}

这仅在 LaTeX 文档中使用 raw directive to insert an unnumbered section heading。

Headings in index.rst do not appear in LaTeX build