Question

documentation的uncertainties Python package是用Sphinx文档系统的reStructuredText编写的。 HTML looks fine。我想创建一个PDF版本。目标是为每个网页设置一个“章节”。

然而，会发生的事情是ReST files生成的PDF会将index.html的（HTML）部分转换为单个章节（其中我不想要：PDF也应该将它们作为部分）。另一个问题是主页面之后的所有HTML页面都显示在PDF中作为toctree指令出现的部分的子部分（即，在主页的确认部分中）。

那么，如何构建ReST文件以便（1）Web文档看起来the same as they are now，以及（2）每个网页对应一个PDF章节。任何帮助将不胜感激！

Answer 1

There is a solution。如果我没记错的话，关键点是：

使用特殊目录作为主文档（我使用index_TOC.rst代替默认index.rst）：conf.py
- master_doc = 'index_TOC'
- latex_documents = [('index_TOC', 'uncertaintiesPythonpackage.tex',…]

新的目录文件index_TOC.rst包含类似ToC的

TOC
===

.. toctree::
   :hidden:
   :maxdepth: 1

   index
   user_guide
   numpy_guide
   tech_guide

因此，Web版本仍会打开主index.rst文本，而PDF（LaTeX）版本将每个ReST文件放在单独的章中。