1

私はDjangoを試しています。私はそのドキュメントを読むつもりでした。そこにはありませんでした、私はそれを構築しなければなりませんでした。Readmeフォルダー内を読み、Django-1.5/docSphinx ドキュメントの 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 フォルダーで再度実行すると、上記と同じビルド エラーが発生します。makePython 2.7 がインストールされた Sphinx バージョンからコマンドを作成するにはどうすればよいですか?

いまいましいドキュメントを生成したいだけです。私は Python とすべてが大好きですが、これらすべてのパッケージのインストールは Windows では面倒です。

4

2 に答える 2

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 -> コマンド ライン インターフェイス。

  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。help("__future__")ドキュメントを表示するには、Python プロンプトで入力します。

Python 2.7 がインストールされた Sphinx バージョンから make コマンドを作成するにはどうすればよいですか?

たとえば、bash で PYTHON オプションを指定してみることができます。

$ 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 に答える