我正在尝试从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移动到另一个新文件中(这会非常方便(。
我们可以告诉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文档中插入未编号的节标题。