epydocからsphinxに移動してシンプルなpython .pyファイルを自動文書化

Question

パッチを適用した後もEpydocはうまく機能しないので、私はSphinxに移行しようとしています。私は、単純なPythonのファイルからドキュメントを自動生成したい

：test.py

はスフィンクス・クイックスタート・スクリプトをインストールして実行した後、私はソースフォルダにtest.pyをコピーそして、入力された：

スフィンクスビルド-b htmlの\ソース\

012を構築する。。は、

しかし、それだけでminimiun HTMLファイルを生成し、それは私がアイデアを使い果たしていtest.pyファイル

を解析しません。あなたの助けのための

感謝:)

Answer 1

あなたは.. autoclass::と、このモジュールから.. automodule::ディレクティブ（またはオブジェクトを使用して、モジュールを文書化することができるよりも、あなたのconf.py（http://sphinx.pocoo.org/config.html#confval-extensions）での拡張機能としてsphinx.ext.autodocを含める必要があり、.. autofunction::、 ...）。

は、あなたがsphinx-apidocを使用することができ、自動生成に必要な.rstファイルをするために

Answer 2

http://sphinx.pocoo.org/ext/autodoc.htmlを参照してください。

これは、人生をはるかに簡単にします。だからあなたはそれぞれのモジュールを手動で文書化する必要はありません。