配置文件中的语法错误-未来的特性unicode_literals没有定义(Python，Django，Sphinx)

Question

我在试用Django。我本来要看文件的。它不在那里，我必须建造它。阅读Readme文件夹中的Django-1.5/doc，下载Django-1.5/doc文档模块。使用easy_install安装它-安装到Python2.5中并不重要。只需生成文档，即可使用Py2.5。我这样做，make html在/doc文件夹中，我得到以下信息：

Running Sphinx v1.1.3

Configuration error:
There is a syntax error in your configuration file: future feature unicode_literals is not defined (conf.py, line 14)

conf.py是Django-1.5/doc文件夹中的文件。第14行是：

from __future__ import unicode_literals

我搜索了为什么，在某个页面上，我看到对2.5的支持已经被未来的放弃了，或者我不知道我真的不明白什么。因此，我easy_install将狮身人面像修改为Python2.7，希望它能解决版本问题。

然后，在Django的make html文件夹中再次执行/doc，并得到与前面相同的构建错误。如何使make命令从已安装的Python2.7狮身人面像版本中进行制作？

我只想生成那些该死的文档。我喜欢Python和所有的东西，但是所有这些软件包的安装在Windows上都很痛苦。

Answer 1

Sphinx生成文档，其中一部分是从源代码中生成的，可以作为内省/部分执行的目标。

因为__future__不是一个模块(不能“导入”它，除非它是第一条指令)。

因此，我不认为它回答了您的问题，但这是合乎逻辑的，也是一件好事，因为它是一种支持python3k并阻止使用未维护的Python1旧版本的方法。

幸运的是，一些优秀的人已经为您编写了文档：

下面是最新的主干文档：http://media.readthedocs.org/pdf/django/latest/django.pdf

在这里，1.5版的pdf：http://media.readthedocs.org/pdf/django/1.5.x/django.pdf

如果需要html版本，则必须使用脱机读取器：http://django.readthedocs.org/en/1.5.x/

希望它能解决你的问题，即使它没有回答你的问题。

我想您的生产环境不会是windows。大多数附加django开发程序的windows将使用cygwin或虚拟机来工作。Django和python提供了非常棒的CLI工具。如果你住在CLI的地狱里，那些CLI工具就不会很棒了。

注: CLI ->命令行接口。

1. http://www.python.org/getit/releases/2.5.6/：>在当前发布策略下，Python2.5中的安全问题将不再被修复。

Answer 2

Python2.5不接受from __future__ import unicode_literals。在Python提示符下键入help("__future__")，以查看文档。

如何使make命令从Python2.7已安装的Sphinx版本中进行制作？

您可以尝试指定PYTHON选项，例如，在bash中：

$ PYTHON=python2.7 make html

在Windows上，可能是：

T:\> set PYTHON=C:\path\to\Python27\python.exe
T:\> make html

您可以使用setx永久地设置变量。

您不需要构建文档来尝试Django。它是可用的在线或者您可以使用@christophe31 31提供的链接下载它。

Django 1.5放弃了对Python2.5的支持。