python-sphinx - バージョン管理用に sphinx のビルド ディレクトリとソース ディレクトリを分離する

Question

私のプロジェクトを含む作業ディレクトリがあり、それはバージョン管理システムにあります。の再構成されたテキスト ファイルのみdocを含むディレクトリをプロジェクト内に作成したいと考えています。sphinx

つまりsphinx、プロジェクト内で html ファイルをビルドするのではなく、外部に配置して、バージョン管理に入れないようにします。

Answer 1

したがって、「ソース ツリーの外部でドキュメントを作成するにはどうすればよいですか」という質問がある場合は、ドキュメントが役に立ちます。

sphinx-build -b html sourcedir builddir

builddir をソース ツリーの外の場所に指定するだけです。

または、バージョン管理システムによっては、ドキュメントを生成するディレクトリを「無視ファイル」に追加します (例: .gitignore、.hgignore...)。