4

Python で記述されたコマンド ライン プログラムがあります。Sphinx で man ページを生成したいと考えています。

次のようなコマンドで 1 ページを作成したいと思います。

man myprog foo--> コマンドの man ページにリダイレクトしますfoo。

man myprog foo2--> コマンドの man ページにリダイレクトしますfoo2。

等

問題は、Sphinxがすべてのマニュアル ページを集約した1 つのマニュアル ページしか生成しないことです。

どうすれば期待どおりの結果を得ることができますか?

4

1 に答える 1

1

構造を考えると

    docs/
    docs/source
    docs/source/conf.py
    docs/source/manable1/includable.rst
    docs/source/index.rst

次に、ドキュメントタイプの場合

    sphinx-build -b man -c source  source/manable1/ man/other_man

makefile にパッチを当てるか、bash の 1 つのライナーを追加することで自動化できます

    for i in source/man*; do
            sphinx-build -b man -c source  $i man/$( basename $i );
    done

（テストされていませんが、近いはずです）

インクルード パス、親族、相互参照に注意してください。

Rstでできることを制限するかもしれません

于 2012-07-06T12:06:03.437 に答える