sphinx autodoc帮助

Question

尝试使用sphinx的autdoc扩展，但它不起作用。我在djano项目文件夹中保存了"docs“文件夹。它不会为我的模块生成文档。另外，我不确定自动待办事项是如何工作的。

Answer 1

如果没有看到您的index.rst文件，我们只能猜测，我的猜测可能会遗漏如下内容：

.. automodule:: myproject.myapp
    :members:

当然，你可以用你的应用程序取代myproject和myapp。

您也可以尝试使用这个非常新的项目http://pypi.python.org/pypi/django-sphinx-autodoc/0.0，它的版本是0.0！

以下是一些讨论如何使用autodoc的博客文章：

http://yml-blog.blogspot.com/2009/06/sphinx-autodoc-and-django-app.html

http://www.toast38coza.com/incomplete-thoughts/setting-up-sphinx-documenter-with-a-django-project-a-quickstart-tutorial