2011-12-08 94 views
10

我们在我们的Linux/OSX python环境中使用Sphinx作为文档,但是我们有一个Windows上的人希望能够获得他们可以编辑和构建Sphinx文档的环境。在Windows上安装python/sphinx环境?

是否可以在Windows上设置Sphinx?我猜测最难的部分是安装python环境和所有的依赖关系,但是我对windows的python有0经验,所以有人可能会指向我一个直接的方式来继续。

回答

0

您现在可以使用pip-win在windows上的virtualenv中轻松设置sphinx。

首先,下载并安装Python。如果您想使用latexpdf构建器,则还需要为Windows安装TeX LiveMiKTeX

接下来,运行pip-win.exe。它会自动提取所需的setuptools并在您的系统上安装pip和virtualenv。加载时,它会提取刚刚安装的Python,但如果将它安装在默认目录以外的位置,则可以轻松地输入绝对路径或浏览它。

接下来,在命令:行,你可以输入查询通过创建一个新的virtualenv:

venv -c C:\foo\sphinx-venv 

这将打开一个命令提示符携带您的virtualenv内。在此之后,你可以用PIP命令安装斯芬克斯:

<sphinx-venv> C:\foo\> pip install sphinx 

现在狮身人面像安装Windows计算机上的虚拟环境。您可以使用停用来逃避您的新环境。

当曾经想要再次进入你的virtualenv建立更多的狮身人面像的项目,您可以打开画中画共赢,运行:

venv C:\foo\sphinx-venv 

或者你可以创建一个自定义Python文件来激活您的狮身人面像的环境和构建你的狮身人面像文件如:

import os 
os.system("cmd /c \"CALL C:\\foo\\sphinx-venv\\Scripts\\activate.bat && make html\"") 
1

在windows上安装python下载Python。运行可执行文件,你就全部设置好了。

如果你有PIP安装,那么你可以打开命令提示符,然后只需键入

pip install -U Sphinx 

如果你没有PIP安装,那么你首先需要通过在下面进行安装命令提示符

python -m pip install -U pip 
+0

小版本更新:新版本都会自动安装pip,因此您无需担心。 – Saelyth

0

通过使用Windows上的Python这是一个便携式分布很简单,只要任何其他使用远最简单的方法是WinPython,便携式应用。它会为您提供WinPython命令提示符的图标,您可以像使用其他任何(例如linux)系统一样使用pip等,或者您可以使用WinPython的控制面板下载并安装它们。