Question

我正在尝试Django。我打算读它的文档。它不存在，我必须建立它。阅读Readme文件夹中的Django-1.5/doc，下载Sphinx文档Python模块。使用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

我搜索了为什么，在某些页面上，我看到对未来的支持已被删除，或者我不知道我真的无法理解。所以我{s}注意了Sphinx到Python 2.7，希望能解决版本问题。

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

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

Answer 1

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

由于__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的地狱，那些CLI工具就不会很棒。

注意：CLI - ＆gt;命令行界面。

http://www.python.org/getit/releases/2.5.6/：＆gt; 在当前版本政策下，Python 2.5中不再存在任何安全问题。

Answer 2

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

如何使用Python 2.7安装的Sphinx版本制作make命令？

你可以尝试指定PYTHON选项，例如bash：

$ PYTHON=python2.7 make html

在Windows上可能是：

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

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

您不需要构建文档来试用Django。它可用online或您可以使用links provided by @christophe31下载。

Django 1.5 dropped support for Python 2.5

配置文件中的语法错误 - 未定义未来功能unicode_literals（Python，Django，Sphinx）

2 个答案: