Question

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

是否可以在Windows上设置Sphinx？我猜测困难的部分是安装python环境和所有依赖项，但我在Windows上有0次python经验，所以有人可能能够指出我一种直接的方式继续。

Answer 1

在Windows上安装python下载Python。运行可执行文件就可以了。

如果您安装了 pip ，则可以打开命令提示符并输入

pip install -U Sphinx

如果您没有安装 pip ，那么首先需要在命令提示符下使用以下命令安装

python -m pip install -U pip

Answer 2

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

首先，下载并安装Python。如果您想使用latexpdf构建器，您还需要为Windows安装TeX Live或MiKTeX。

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

接下来，在Command：行中，您可以通过输入：

来创建一个新的virtualenv

venv -c C:\foo\sphinx-venv

这将在你的virtualenv中打开一个命令提示符。在此之后，您可以使用pip命令安装sphinx：

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

现在，在虚拟环境中，您的Windows机器上安装了sphinx。您可以使用停用来逃避新环境。

如果您希望再次进入virtualenv建立更多狮身人面像项目，您可以打开pip-win并运行：

venv C:\foo\sphinx-venv

或者您可以创建自定义python文件来激活您的sphinx环境并构建您的sphinx文件，例如：

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

Answer 3

到目前为止，在Windows上使用Python的最简单方法是WinPython，这是一种便携式发行版，与任何其他便携式应用一样简单易用。它将为您提供WinPython命令提示符的图标，您可以从中使用pip等，就像在任何其他（例如linux）系统上一样，或者您可以使用WinPython控件下载软件包并安装它们面板。

在Windows上安装python / sphinx环境？

3 个答案: