configuration文件中的语法错误 – 将来的特性unicode_literals没有定义(Python,Django,Sphinx)

我正在尝试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

我search了为什么,并在一些页面上看到,对2.5的支持被放弃了,或者我不知道我真的无法理解。 所以我easy_install编辑狮身人面像到Python 2.7然后,希望这将解决版本的东西。

然后,我再次在Django的/ doc文件夹中make html ,并得到与上述相同的构build错误。 我怎样才能使make命令做从Python 2.7安装的狮身人面像版本?

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

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 – >命令行界面。

  1. http://www.python.org/getit/releases/2.5.6/ :> 在目前的版本政策下,Python 2.5中的安全问题将不再被修复。

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

我怎样才能使make命令做从Python 2.7安装的狮身人面像版本?

你可以尝试指定PYTHON选项,例如,在bash中:

 $ PYTHON=python2.7 make html 

在Windows上它可能是:

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

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


您不需要构建文档来尝试Django。 它可以在线获得 ,也可以使用@ christophe31提供的链接下载。

Django 1.5放弃了对Python 2.5的支持 。