如何在reStructuredText中创建PDF？

Question

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

但是，什么情况是，由ReST files生成的PDF变换（HTML）部分index.html成单独的章节（我不想：在PDF应该有他们的部分太）。另一个问题是，主页面之后的所有HTML页面都以PDF格式显示为toctree指令出现的部分的子部分（即，在主页面的确认部分中）。 （1）网页文档看起来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 
  

因此，网页版还是通往主index.rst文本，PDF文档（胶乳）版本在一个单独的章节每个其余文件。