4

モジュールのインポート部分を除外し、それをsphinx-pythonで文書化する方法はありますか？別のパッケージ（他の別のプロジェクト）をインポートするモジュールがあり、スフィンクスはこのエラーを出します：

"""ファイル"/usr/local/lib/python2.7/dist-packages/Sphinx-1.1.3-py2.7.egg/sphinx/ext/autodoc.py"、行321、import_object import（self。 modname）ファイル "/home/x/GitHub/project/mod_example1.py"、33行目、other_pckからインポートKlass、KlassStuff ImportError：other_pckという名前のモジュールはありません "" "

そして、スフィンクスがautodocを実行できるパッケージを呼び出す/インポートするモジュールのインポート部分にコメントすると、すべてのsphinxautodocモジュール（autoclass、automoduleなど）を試してみましたが、他のパッケージをインポートしようとすると、結果は常に同じになります。

ありがとう

4

1 に答える 1

4

問題を間違った方法で修正しています。この問題を修正する正しい方法は、autodoc 機能がソース コードをスキャンするために Python パッケージをインポートする必要があるため、既存の他のパッケージを Sphinx に認識させることです。Python パッケージは、すべての依存関係が解決されていないとインポートできません。また、ソース コードの行をチェリー ピックすることもできません。これが Python の構築方法であるためです(*)。

可能な解決策は

*) 理論上は可能ですが、これは Sphinx とこの質問の範囲外です

于 2013-03-02T15:22:59.953 に答える