为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

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

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

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

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

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

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