配置文件中出现语法错误-未定义未来功能unicode_literals(Python、Django、Sphinx)



我正在试用Django。我本来打算读它的文档。它不在那里,我必须构建它。阅读Django-1.5/doc文件夹中的Readme,下载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

我搜索了原因,在某个页面上,我看到对2.5的支持因未来而下降,或者我不知道我真的不明白什么。所以我easy_install把Sphinx修改成了Python2.7,希望这能解决版本问题。

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

我只想生成该死的文档。我喜欢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->Command Line Interface。

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

Python 2.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:pathtoPython27python.exe
T:> make html

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


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

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

相关内容

  • 没有找到相关文章

最新更新