Comment créer un PDF dans reStructuredText?

Question

Le documentation pour uncertainties Python package est écrit en reStructuredText, pour le système de documentation Sphinx. Le code HTML looks fine. Je voudrais créer une version PDF. L'objectif est d'avoir un "chapitre" pour chacune des pages web.

Cependant, ce qui se passe est que le PDF généré par le ReST files transforme le (HTML) sections de index.html dans différents chapitres (que je ne veux pas: le PDF devrait les avoir comme sections trop). Un autre problème est que toutes les pages HTML après la page principale apparaissent dans le PDF en tant que sous-sections de la section où la directive toctree apparaît (c'est-à-dire dans la section Accusé de réception de la page principale). Donc, comment le fichier ReST doit-il être structuré de manière à ce que (1) les documents Web aient l'air the same as they are now, et (2) chaque page Web correspond à un chapitre PDF. Toute aide serait très appréciée!

Answer 1

There is a solution. Si je me souviens bien, les points clés sont les suivants:

• Utilisez une table spéciale des matières comme le document maître (je index_TOC.rst au lieu de la valeur par défaut index.rst): dans conf.py
  • master_doc = 'index_TOC'
  • latex_documents = [('index_TOC', 'uncertaintiesPythonpackage.tex',…]

• Le nouveau fichier de table des matières index_TOC.rst contient un TdC comme

  TOC 
  === 
  
  .. toctree:: 
      :hidden: 
      :maxdepth: 1 
  
      index 
      user_guide 
      numpy_guide 
      tech_guide 
  

Ainsi, la version Web ouvre encore sur le texte principal index.rst, et la version PDF (LaTeX) a chaque fichier dans un ReST chapitre séparé.