Sphinx-apiはDjangoプロジェクトのモジュールをインポートできません

Question

私はすでにvirtualenvに入っています。すべてがpythonのパスにあると確信しています。

(myenv)admin@ubuntu:/var/lib/mydirectory/doc$ sphinx-apidoc -o . ../testproject/ 

Creating file ./testproject.rst. 
Creating file ./testproject.apps.rst. 
# ... and many more .... # 
Creating file ./modules.rst. 

(myenv)admin@ubuntu:/var/lib/mydirectory/doc$ make html 
sphinx-build -b html -d _build/doctrees . _build/html 
Making output directory... 
Running Sphinx v1.1.2 
loading pickled environment... not yet created 
building [html]: targets for 17 source files that are out of date 
updating environment: 17 added, 0 changed, 0 removed 

Traceback (most recent call last):t                     
    File "/var/lib/server/myenv/lib/python2.6/site-packages/sphinx/ext/autodoc.py", line 321, in import_object 
    __import__(self.modname) 
ImportError: No module named webclient.__init__ 
# ... and many more .... # 

/var/lib/mydirectory/doc/testproject.rst:7: WARNING: autodoc can't import/find module 'testproject.__init__', it reported error: "No module named testproject.__init__", please check your spelling and sys.path 
# ... and many more .... # 

私はhtmlファイルを開くと、見出しとセクションタイトルのみが表示されます。いいえオート。

この問題の原因は何ですか？私はすでに私の仮想環境にいます...

何か考えていますか？私はSphinx 1.1.2を使用しています。

ありがとうございました。

Answer 1

私はスフィンクスの専門家ではありません。しかし、答えはかなり明確なIMHOです。

最初に、エラーメッセージは、モジュールがインポート可能でないことを示しています。これは、いくつかの.pyファイルのimport文が間違っていることを意味します。

考えられる原因：

1. レガシーimport文
2. Inproperのimport文
   • レベルの深さのインポート
   • タイプミス
3. モジュールではない作業Pythonパス上の

2bが特に興味深い。あなたがmyappに/ mysubapp/models.pyにあり、あなたがmyappの/をインポートしたい場合は、次のステートメントを提供する必要があるのviews.py：

# myapp/mysubapp/models.py 
import mysite.myapp.view   # correct 
import myapp.view    # incorrect 

は、警告メッセージのそれぞれを確認し、それぞれを見て対応する.pyファイル対応するimportステートメントを探し、利用可能性を再確認します。

今、virtualenvの問題に戻ります。あなたのvirtualenvも同様に大きな原因になるかもしれません。最初のエラーを見てください：

ImportError: No module named webclient.__init__ 

これは問題です。パス変数が正しく設定されていることを再度確認してください。