Sphinx autodoc 1.4

Question

我在为Django 1.4.1项目构建模块autodocs时遇到了问题。make html似乎无法读取我的文档字符串，因为它在导入我的设置时遇到问题。我看到的所有在线指南都建议使用

import settings
from django.core.management import setup_environ
setup_environ(settings)

但这在1.4中就被弃用了，而且settings.configure()方法似乎并不合适。我还没有找到更多关于如何在1.4中工作的信息。我试着设置DJANGO_SETTINGS，但没有成功。有什么建议吗？

Answer 1

问题似乎是，当我需要设置DJANGO_SETTINGS_MODULE时，我错误地设置了DJANGO_SETTINGS环境变量。

因此，需要明确的是，由于此信息没有特别详细的文档记录，因此有两种等效的方法可以使用Django 1.4+设置autodocs：

1. 在运行make html之前设置环境变量：

export DJANGO_SETTINGS_MODULE=myproject.settings

• Do导出conf.py中的等效项：

sys.path.append('') os.environ‘’DJANGO_SETTINGS_MODULE‘= 'myproject.settings'

我更喜欢后者，因为我可以在配置中设置它，并且文档将在任何部署中构建。