私は Python モジュールのドキュメント化にSphinxを使用しています。メイン ファイルに含める個々のファイル (モジュール コンポーネントごとに) を配置するマスターdocディレクトリがあります。これはうまく機能します ( Python ライブラリ リファレンスのソースを参照して、私のやり方を正確に確認してください)。*.rstindex.rst
私の問題は、(モジュール全体ではなく) 特定のモジュール コンポーネントのスタンドアロン PDF を作成する必要がある場合です。
完全なモジュール (ライブラリ) のPython ライブラリ リファレンスと同じ構造を持っているとします。次に、cryptoコンポーネントなどのドキュメント用のスタンドアロン PDF を作成します。あなたならどうしますか？
- 別のインデックスを作成し (
index_2.rst)、そのファイルのみを含める (crypto.rst) - 元のファイルから他のファイルをコメントする
index.rst cryptoスタンドアロンの Sphinx ドキュメントを使用して、まったく新しい doc ディレクトリを作成します
これらのアプローチはどれも単純ではないようです。
アドバイスをお願いします。