Как создать PDF в reStructuredText? - PullRequest
Новая
       5

Как создать PDF в reStructuredText?

3 голосов
/ 23 декабря 2010

Документация для пакета Python неопределенности написана в reStructuredText, для системы документации Sphinx .HTML выглядит отлично .Я хотел бы создать PDF версию.Цель состоит в том, чтобы иметь «главу» для каждой веб-страницы.

Однако, получается, что PDF, сгенерированный файлами ReST , преобразует (HTML) разделы из index.html в отдельные главы (чего я не хочу: в PDF они тоже должны быть разделами).Другая проблема заключается в том, что все страницы HTML после главной страницы отображаются в PDF как подразделы раздела, в котором появляется директива toctree (т. Е. В разделе подтверждения главной страницы).

Итак, как следуетфайл ReST должен быть структурирован таким образом, чтобы (1) веб-документы выглядели такими же, как они теперь , и (2) каждая веб-страница соответствует главе PDF.Любая помощь будет высоко ценится!

1 Ответ

2 голосов
/ 03 июля 2012

Есть решение . Если я правильно помню, ключевые моменты были:

  • Использовать специальное оглавление в качестве основного документа (я использовал 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 (LaTeX) содержит каждый файл ReST в отдельной главе .

...