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



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

############
How to Build
############
The build blah blah balh 
.. toctree::
:hidden:
file1
file2
file3

在PDF输出中;建造等等;出现时根本没有任何标题!HTML输出是可以的(标题"How to Build"显示正确(,这就是为什么我将其归类为LaTeX问题,而不是Sphinx问题。

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

注意:

这些文档来自其他团队,所以我不能编辑超过某一点的文档。例如,我无法将所有内容从index.rst移动到另一个新文件中(这会非常方便(。

LaTeX构建器生成的文档通常以标题页开头,其中包含文档标题、作者和发布日期,然后是目录,然后是该目录中列出的各个章节。因此,你在这里要做的是添加一些标题不在目录中的前沿内容。这有点不寻常。

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

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

在问题的例子中,第三位置的空字符串将被替换为";如何构建";并显示在标题页上。这与HTML输出一致,HTML输出是起始页的标题。

但是,文件标题不是小节标题,下面的段落没有标题。解决方案是添加一个额外的节标题,但仅在LaTeX文档中,而不是在HTML构建中。

############
How to Build
############
.. raw:: latex
section*{How to Build}

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

相关内容

  • 没有找到相关文章

最新更新