在Windows上安装python / sphinx环境？

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构建器，还需要安装TeX Live或MiKTeX for Windows。

接下来，运行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

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

如果您希望再次进入virtualenv以构建更多sphinx项目，您可以打开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的控制面板下载软件包并安装它们。