我有一个 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')
最佳答案
我只能想到两个原因导致您的 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'
关于python - 为 sphinx 设置 Django 设置(文档),我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/9846242/