python - 为 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'