Sphinxはモジュールを見つけることができませんが、Pythonは可能です

Question

PythonドキュメントジェネレータであるSphinxはモジュール/パッケージを理解していないようです。 make clean && make htmlには、のコードを実行するとImportError: No module named 'statstuff'が出力されます。

モジュールは同じパッケージにあるのでfrom . import statistics as statsと参照するようにしましたが、SphinxはSystemError: Parent module '' not loaded, cannot perform relative importを出力します。

また、config.pyは、ドキュメントフォルダがstatstuffフォルダと親フォルダを共有するので、sys.path.insert(0, os.path.abspath('../statstuff/'))と正しく設定されているようです。

とにかく、ここではファイルとリポジトリです：https://github.com/lucasmauro/statstuff

問題がstatstuff/regression.pyで発生し、ライン2および3：https://github.com/lucasmauro/statstuff/blob/master/statstuff/regression.py

コードは、Pythonインタプリタで正常に動作しますが、スフィンクスは見つけることができませんモジュールがコード（または構成）として書かれた。

これを解決する方法について誰かが手掛かりを持っていますか？

本当にありがとうございます。

Answer 1

あなたのモジュールがstatstuffと呼ばれるpackageにあるので、私は次のことをお勧め：

1. はconf.pyにsys.pathにstatstuff上記のディレクトリへのパスを追加します。

   sys.path.insert(0, os.path.abspath('..')) 
   

2. を

   automoduleディレクティブを編集します。

   .. automodule:: probability 
   

   .. automodule:: statstuff.probability 
   

   にというように変更します。