python - 配置文件中的语法错误 - 未定义 future 功能 unicode_literals (Python、Django、Sphinx)

Question

我正在尝试 Django。我本来打算阅读它的文档。它不在那里，我必须 build 它。阅读Django-1.5/doc文件夹中的Readme，下载Sphinx文档Python模块。使用 easy_install 安装它 - 安装到 Python2.5没关系。只需要生成文档，就可以使用Py2.5。我这样做了，在 /doc 文件夹中 make html ，我得到了这个:

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

我搜索了原因，在某些页面上我看到 future 不再支持 2.5，或者我不知道我真正无法理解什么。所以我easy_install将 Sphinx 转至 Python 2.7，希望这能解决版本问题。

然后我在 Django 的/doc 文件夹中再次 make html ，并得到与上述相同的构建错误。如何让 make 命令从安装了 Python 2.7 的 Sphinx 版本进行制作？

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

Answer 1

Sphinx 生成文档，其中一部分由源代码组成，可以作为内省(introspection)/部分执行的目标。

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

所以我不认为它回答了你的问题，但它是合乎逻辑的，也是一件好事，因为它是支持 python 3k 并阻止使用未维护的旧版本 Python[1] 的一种方式。

你很幸运，一些好人已经为你编译了文档:

这里是最新的主干文档: 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。大多数Windows附加的django开发人员都会使用cygwin或虚拟机来工作。 Django 和 python 提供了很棒的 CLI 工具。如果您生活在 CLI 的 hell 中，那么这些 CLI 工具就不会很棒。

注意:CLI -> 命令行界面。

1. http://www.python.org/getit/releases/2.5.6/ : > 根据当前的发布策略，Python 2.5 中的安全问题将不再得到修复。