1

我正在尝试 Django。我打算阅读它的文档。它不存在，我必须建造它。阅读ReadmeinDjango-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

我搜索了原因，在某个页面上我看到对 2.5 的支持在未来被放弃了，或者我不知道我真的无法理解什么。所以我easy_install把 Sphinx 编到 Python 2.7，希望能解决版本问题。

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

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

4

2 回答 2

1

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

As__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 中的安全问题将不再修复。
于 2013-03-12T15:06:50.983 回答
0

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

如何使 make 命令从 Python 2.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 提供的链接下载它。

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

于 2013-03-12T16:23:59.557 回答