3

不確実性 Python パッケージのドキュメントは、 Sphinxドキュメント システム用の reStructuredText で書かれています。HTMLは正常に表示されます。PDF版を作りたいです。目標は、Web ページごとに「チャプター」を持つことです。

ただし、ReST ファイルによって生成された PDF は、(HTML)セクションをindex.html個々の章に変換します(これは望ましくありません。PDF にもセクションとして含める必要があります)。もう 1 つの問題は、メイン ページの後のすべての HTML ページが、ディレクティブが表示されるセクションのサブセクションtoctree(つまり、メイン ページの確認セクション) として PDF に表示されることです。

では、(1) Web ドキュメントが現在と同じように見え、 (2) 各 Web ページが PDF の章に対応するように、ReST ファイルをどのように構成する必要がありますか。どんな助けでも大歓迎です！

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

したがって、Web バージョンはまだindex.rst本文に開き、PDF (LaTeX) バージョンはそれぞれの ReST ファイルを別の章に持っています。

于 2012-07-03T11:09:11.747 に答える