如何让狮身人面像在未联网的Windows 7计算机上使用Jython？

Question

运行sphinx-apidoc后，命令C:\path\to\doc\make html将产生一个错误开始：

“狮身人面像-构建”命令未被找到。

但是，该命令确实存在，并设置了相关的环境变量。

更详细的情况：

1-尝试运行sphinx_apidoc

'C:\path\to\jython\bin\sphinx-apidoc‘不被认为是内部或外部命令。

2-使用Jython调用:带有合理选项的jython C:\path\to\jython\bin\sphinx-apidoc生成文档*.rst文件、conf.py等文件。

3- make html然后产生以下错误：

“狮身人面像-构建”命令未被找到。

然后，它建议设置SPHINXBUILD环境变量，甚至PATH。我已经设置了这两个环境变量，通过调用echo %PATH%和echo %SPHINXBUILD%对自己进行了验证。

这就是我被困的地方。看来，Sphinx使用的文件(本例中是sphinx-apidoc和sphinx-build )在C:\path\to\jython\bin\目录中没有任何文件后缀。当直接从Jython调用时，它们按预期工作(参见上文第2点)，但是，当作为另一个流程(例如make html)的一部分被调用时，它们不被识别并且执行失败(参见上面的第1和第3点)。

有没有人知道这个问题是什么，为什么，最重要的是“如何解决”？

我的安装过程在一台未联网的Windows 7计算机上。Jython (2.5.2)是使用Jython安装程序安装的。然后，通过在本地提取包并在其解压目录中运行jython setup.py install，安装了以下每个包(setuptools除外)：

1. setuptools:通过在同一个目录中使用setuptools-1.4.2.tar.gz调用jython ez_setup.py (因此不会尝试下载它)
2. Jinja2 (2.5)
3. docutils (0.11)
4. 小矮人(1.6)
5. 狮身人面像(1.2.1)
6. numpydoc (0.4) -只提到它是因为它也是在机器上。

Answer 1

我已经设法让它起作用了。问题是手工安装和使用Jython意味着某些预期的环境变量没有到位。而且，Windows 7的使用(我相信通常是means )意味着如果没有通过Jython显式调用Python脚本，就不能运行没有扩展名的Python脚本(Windows不检查shebangs)。最后，文件关联还没有建立(就像在CPython安装中自动发生的那样，但是没有在Jython中发生)。

对于其他有类似问题的人，下面的设置适用于我：

位置：

• Java运行时: C:\Java\jre7 7
• Jython: C:\Jython\jython2.5.2

用户环境变量：

• JRE_HOME: C:\Java\jre7 7
• JAVA_HOME：%JRE_HOME%
• CLASSPATH：
• JYTHON_HOME: C:\Jython\jython2.5.2
• 路径：%JRE_HOME%\bin;%JYTHON_HOME%\bin

档案协会：

• 在命令提示符处，键入assoc .py=Python.File将'Python.File‘与'.py’扩展关联起来。
• 在命令提示符下，键入ftype Python.File=C:\Jython\jython2.5.2\jython.bat "%1" %*将Jython命令与'Python.File‘类型的文件关联起来。
• 将'.py‘(;.PY)附加到PATHEXT系统环境变量。这将使执行Python文件成为可能，而不必提供它们的“.py”扩展名。(注:这不可能运行没有'.py‘扩展名的Python文件。)

文件扩展名：

• 重命名这四个狮身人面像命令，以包含'.py‘扩展。对于普通的Windows 7来说，这是非常困难的，因为它会尽一切努力将用户与诸如文件扩展名这样的“低级”详细信息保持距离，但是命令提示符下的rename命令在Jython目录中完成了以下工作:输入ren sphinx* sphinx*.py。

现在应该可以从任何地方调用sphinx-apidoc或类似的。一旦完成，当从文档目录调用命令make html时，应该会像预期的那样工作。