3

不确定性 Python 包的文档是用 reStructuredText 编写的，用于Sphinx文档系统。HTML看起来不错。我想创建一个 PDF 版本。目标是为每个网页创建一个“章节”。

但是，发生的情况是，由ReST 文件生成的 PDF将 (HTML)部分转换为index.html单独的章节（我不希望这样：PDF 也应该将它们作为部分）。另一个问题是主页之后的所有 HTML 页面在 PDF 中显示为toctree指令出现的部分的子部分（即，在主页的确认部分中）。

那么，应该如何构造 ReST 文件，以便（1）Web 文档看起来和现在一样，以及（2）每个网页对应一个 PDF 章节。任何帮助将非常感激！

4

1 回答 1

2

有一个解决方案。如果我没记错的话，关键点是：

  • 使用特殊的目录作为主文档（我使用index_TOC.rst而不是默认的index.rst）：在conf.py
    • master_doc = 'index_TOC'
    • latex_documents = [('index_TOC', 'uncertaintiesPythonpackage.tex',…]

  • 新的目录文件index_TOC.rst包含一个目录，如

    TOC
===

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

   index
   user_guide
   numpy_guide
   tech_guide

因此，网页版仍然打开index.rst正文，而 PDF (LaTeX) 版将每个 ReST 文件放在单独的章节中。

于 2012-07-03T11:09:11.747 回答