为sphinx设置Django设置（文档）

Question

我有一个Django应用程序，我正在尝试为其设置文档。 目录结构如下：

- doc
- project
| - manage.py

我已经设置了路径以便Sphinx可以看到内容，但是当我尝试使用autodoc时，我在settings.py中设置的一些设置不可用。 这就是我如何建立环境，我做错了什么？

from django.core.management import setup_environ
from project import settings

setup_environ(settings, 'project.settings')

Answer 1

我只能想到为什么Sphinx的conf.py中的setup_environ()调用不起作用的两个原因：

• 它没有尽早发挥它的魔力。 您导入在该行之前已经需要设置的其他内容。

• settings.py本身导入太多了。 如果是这样的话会很奇怪。

请注意，不推荐使用setup_environ() 。 但是，直到Django 1.6才会删除它。

另一种选择是在conf.py脚本的顶部使用os.environ 。 你保证在那里及时:-)

import os
os.environ['DJANGO_SETTINGS_MODULE'] = 'project.settings'