帶有 Django 錯誤的 Autodoc Sphinx

Question

當我嘗試使用 autodoc 制作 html 時出現錯誤。

這是我的項目結構：

projet
--- app1
------ models.py
------ views.py
--- app2
--- app3
docs
--- modules
------ models.rst
--- conf.py
--- index.rst
__init__.py
manage.py

我的 conf.py

import os
import sys

sys.path.insert(0, os.path.abspath('..'))
from django.conf import settings
settings.configure()

import django
django.setup()

# -- General configuration 

extensions = ['sphinx.ext.autodoc',
'sphinx.ext.coverage']

還有我的model.rst

Models
======
.. automodule:: projet.app1.models
    :members:
    :undoc-members:

我遇到了這個錯誤：

D:\Agrome\Agrome bitbucket\agrome-backend\docs\modules\models.rst:3: WARNING: autodoc: failed to import module u'agrome.boxes.models'; the following exception was raised:
    Traceback (most recent call last):
        File "c:\python27\lib\site-packages\sphinx\ext\autodoc.py", line 547, in import_object
        __import__(self.modname)
        File "D:\Agrome\Agrome bitbucket\agrome-backend\agrome\boxes\models.py", line 5, in <module>
        from django.contrib.auth.models import User
        File "c:\python27\lib\site-packages\django\contrib\auth\models.py", line 6, in <module>
        from django.contrib.contenttypes.models import ContentType
        File "c:\python27\lib\site-packages\django\contrib\contenttypes\models.py", line 161, in <module>
        class ContentType(models.Model):
        File "c:\python27\lib\site-packages\django\db\models\base.py", line 102, in __new__
        "INSTALLED_APPS." % (module, name)
RuntimeError: Model class django.contrib.contenttypes.models.ContentType doesn't declare an explicit app_label and isn't in an application in INSTALLED_APPS.

如果我輸入 .. automodule:: projet.app1 (whitout .models)，它可以工作，但文檔是空的。

你有什么主意嗎 ？

非常感謝

Answer 1

嘗試刪除/注釋掉 conf.py 中的settings.configure()