注: 後に追加: numpydoc が機能するようになりました。これはpython 2の問題でもありました。私はそれで2to3を実行しましたが、今はうまくいっているようです。
OK、Sphinx 拡張機能を動作させるために 1 日を費やしましたが、誰かが私が間違っていることを指摘してくれることを期待しています。(申し訳ありませんが、これは少し長くなりますが、より多くの情報が私のやり方の誤りをすばやく見つけるのに役立つかもしれません)。
Sphinx は宣伝どおりに動作しているようですが、NumPy スタイルのドキュメントを使用したいので、numpydoc をインストールすることにしました。問題が発生した場合に備えて、私は Python 3.3 (Windows 7 で winpython 64 ビット) を使用しています。ここの指示から始めましたが、エラーが発生しました:
Extension error:
Could not import extension numpydoc (exception: cannot import name setup)
numpydoc.numpydoc
No Diceを使って回避した人がいることがわかったグーグル。関連する可能性のあるすべてのものがパスにあることを確認しました(さらに、スフィンクスのファイルの sys.path に追加されましたconf.py
)。numpydoc を sphinx の ext フォルダーにコピーして、それに応じて拡張文字列を変更しようとしましたが、まだ運がありません。
この時点で numpdoc をあきらめ、ナポレオンを試すことにしました。インストールの指示に従ってpip install sphinxcontrib-napoleon
ください。しかし、悲しいかな、ナポレオンは 3 ではなく 2.x にあるようです (ただし、卵はSphinx-1.1.3-py3.3.egg-info
、インストール中にsphinxcontrib_napoleon-0.2.1-py3.3-nspkg.pth
.再帰が深すぎるというエラーが発生します。
そこで、sphinx に拡張機能をインストールできるかどうかを確認することにしました。私は本質的に無作為に何かを見つけます。要求どおりにインストールしますが、今度は relpath エラー ( ValueError: path is on mount 'C:', start on mount 'D:'
) が原因で失敗します。これは、python インストールが C にあるのに、文書化しようとしているコード (および sphinx を実行しようとしている場所) が D にある (および Windows を実行している) ことは不幸なことです。
それで、たまたま問題のある拡張機能を 3 つ選んだだけですか? または、そうでない場合、私は何を間違っていますか? (さらに重要なことに) どうすれば正しく動作させることができますか?
PS 私は Python にまったく慣れていないので、信じられないほど愚かで基本的なエラーを犯しているとは思わないでください。