私は、readthedocs.org で sphinx-doc の Web サイトをホストしています。これは、プライベート sphinx-doc extension/sphinxcontrib-package [extension_name] に依存しています。私のローカル PC では、この拡張機能はサブディレクトリ [sphinx-doc project root]/exts/sphinxcontrib-[extension name] にあり、conf.py で「参照」されています。
sys.path.append(os.path.abspath('exts/sphinxcontrib-<extension name>/sphinxcontrib'))
extensions = [
'sphinx.ext.graphviz',
'[extension name]'
]
.py ファイルは「ソース」ディレクトリsphinxcontribにあります。ローカルの sphinx-doc ビルド出力は期待どおりです。ただし、readthedocs.org のビルドは失敗します。
ImportError: No module named 'sphinxcontrib'
...
Extension error:
Could not import extension sphinxcontrib.p3 (exception: No module named 'sphinxcontrib')
拡張機能はベータ段階にあるため、オンラインで配布したくありません。(私がそうするなら、私が推測する Web ソースから readthedocs.org プレビルドとしてインストールできるはずです。) この問題をどのように処理できますか?