html - 如何在 reStructuredText 中创建 PDF？

Question

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

但是，ReST files 生成的 PDF 会发生什么？将 index.html 的 (HTML) sections 转换为单独的 chapters (我不想要: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 文件放在单独的章节中。 p>