Sphinx autodoc不导入模块

Question

嗨，我正在为一个使用sphinx的Django项目写一些文档。

我的项目(Django 1.4)如下所示：

/funproject
   /documentation
       # this is where sphinx files live
       /source
           conf.py
           ... 
   /funproject
       __init__.py
       settings.py
       admin.py
       models.py
   /app1
   /app2
   fabfile.py
   manage.py 

我在conf.py中设置了sphinx：

 import sys, os

 sys.path.append(os.path.join(os.path.dirname(__file__), '../..'))

 os.environ['DJANGO_SETTINGS_MODULE'] = 'funproject.settings'

 from funproject import settings
 from django.core.management import setup_environ
 setup_environ(settings)

因此，在我的sphinx源文件中，我可以这样做：

 .. automodule:: app1.models
    :members: 

它工作得很好。但是，这两个示例不起作用：

1.

 .. automodule:: funproject.models
    :members: 

2.

 .. automodule:: fabfile
    :members: 

如果我将文件移到app1中并使用app1.fabfile，则第二种方法可以正常工作

我猜我的conf.py有一些问题，但我已经尝试了很多派生，但我不能导入我的fabfile.py，除非它在应用程序目录下(尽管在/funproject下它也不能工作)。

这方面的任何帮助都将不胜感激。

Answer 1

您可能会尝试使用fabric fabfile目录样式？也许是automodule不看单个文件模块的情况？另一种样式的文档是here