私はSphinxを使用して、私の多くのプロジェクトのドキュメントを生成しています。すべてのgitリポジトリのクローンを作成し、docsディレクトリを見つけて実行する、簡単なビルドスクリプトを作成しました。
sphinx-build -b html -D html_theme=treffynnon -D html_theme_path=/home/user/_themes /home/user/sphinx/src /home/user/output/docs
残念ながら、html_themeは正しく設定されていますが、そうではありhtml_theme_pathません。もちろん、これにより、テーマが見つからない場合にSphinxがエラーを吐き出します。
このコマンドをどのようにフォーマットする必要がありますか？このように指定することも可能html_theme_pathですか？
これは既知のバグのようです: https://bitbucket.org/birkenfeld/sphinx/issue/925/allow-html_theme_path-to-be-provided-to
この問題を回避するために、sed を使用して構成ファイルで置換を行いました。
sed -i "s|#*html_theme = '.*'|html_theme = 'simonholywell'|g" conf.py
sed -i "s|#*html_theme_path = .*$|html_theme_path = ['$BASE_DIR/sphinx/_themes']|g" conf.py
私のSphinxプロジェクトはすべてgitにあるので、次のことを行うことができます：
git checkout -- conf.py
ビルドプロセスの完了後にsedが導入した変更を削除します。