一度 sphinx-apidoc
コマンドが実行されました C:pathtodocmake html
最初にエラーが発生します:
「sphinx-build」コマンドが見つかりませんでした[snip]
ただし、コマンドは存在し、関連する環境変数が設定されています。
より詳しく:
1-実行しようとしています sphinx_apidoc
:
「C:pathtojythonbinsphinx-apidoc」は、内部または外部コマンドとして認識されません
2-Jythonの作品を使用して呼び出されます: jython C:pathtojythonbinsphinx-apidoc
賢明なオプションでドキュメントを作成します *.rst
ファイル、 conf.py
などのファイル。
3 - make html
その後、次のエラーが生成されます。
「sphinx-build」コマンドが見つかりませんでした[snip]
次に、 SPHINXBUILD
環境変数、さらに PATH
。私はすでにこれらの2つの環境変数を設定しています。 echo %PATH%
そして echo %SPHINXBUILD%
.
これは私が行き詰まるところです。 Sphinxが使用するファイル(sphinx-apidoc
そして sphinx-build
この場合)、 C:pathtojythonbin
ディレクトリ、ファイルサフィックスはありません。 Jythonから直接呼び出された場合、期待どおりに動作します(上記のポイント2を参照)。ただし、別のプロセスの一部として呼び出された場合(たとえば、 make html
)それらは認識されず、実行は失敗します(上記のポイント1および3を参照)。
誰もがこの問題の何を、なぜ、そして最も重要な「修正方法」を知っていますか?
セットアッププロセスは、ネットワークに接続されていないWindows 7で行われますコンピューター。 Jython(2.5.2)は、Jythonインストーラーを使用してインストールされました。次に、以下の各パッケージ(setuptoolsを除く)をローカルに抽出して実行しました。 jython setup.py install
抽出されたディレクトリ:
- setuptools:呼び出すことにより
jython ez_setup.py
同じディレクトリにsetuptools-1.4.2.tar.gzがある場合(それをダウンロードする試みはありません) - ジンジャ2(2.5)
- docutils(0.11)
- ピグメント(1.6)
- スフィンクス(1.2.1)
- numpydoc(0.4)-マシンにもインストールされていないため、言及されているだけです。
回答:
回答№1は1私はなんとかそれを働かせました。 問題は、手動でのインストールとJythonの使用により、予期されていた特定の環境変数が配置されなかったことです。また、Windows 7の使用(および一般にMS Windowsを使用していると思います)は、拡張機能のないPythonスクリプトは、Jythonを介して明示的に呼び出さないと実行できないことを意味します(Windowsはシバンをチェックしません)。最後に、ファイルの関連付けは設定されていませんでした。 up(CPythonのインストールでは自動的に発生しますが、Jythonでは発生しません)。
同様の問題を抱えている他の人にとっては、次の設定でうまくいきます:
場所:
- Javaランタイム:C:Javajre7
- Jython:C:Jythonjython2.5.2
ユーザー環境変数:
- JRE_HOME:C:Javajre7
- JAVA_HOME:%JRE_HOME%
- クラスパス:。
- JYTHON_HOME:C:Jythonjython2.5.2
- パス:%JRE_HOME%bin;%JYTHON_HOME%bin
ファイルの関連付け:
- コマンドプロンプトで次のように入力します。
assoc .py=Python.File
「Python.File」を「.py」拡張子に関連付けます。 - コマンドプロンプトで次のように入力します。
ftype Python.File=C:Jythonjython2.5.2jython.bat "%1" %*
Jythonコマンドを「Python.File」タイプのファイルに関連付けます。 - 「.py」(
;.PY
)PATHEXTシステム環境変数に。 これにより、「。py」拡張子を付けなくてもPythonファイルを実行できるようになります。 (NBでは、「。py」拡張子のないPythonファイルを実行できません。)
ファイル拡張子:
- 4つのSphinxコマンドの名前を "を含むように変更します。py "拡張子。これは、ファイル拡張子などの「低レベル」の詳細からユーザーを遠ざけるためにできるすべてのことを行うため、バニラWindows 7では非常に困難ですが、コマンドプロンプトでrenameコマンドを実行すると、次のようになります。
ren sphinx* sphinx*.py
Jython binディレクトリーにあるとき。
呼び出すことができるはずです sphinx-apidoc
またはどこからでも同様。これが完了すると、コマンド make html
は、ドキュメントディレクトリから呼び出された場合、期待どおりに動作するはずです。