我们在 Linux/OSX python 环境中使用Sphinx 来编写文档，但我们在 Windows 上有人希望能够获得一个可以编辑和构建 Sphinx 文档的环境。
是否可以在 Windows 上设置 Sphinx？我猜最困难的部分是安装 python 环境和所有依赖项，但我在 windows 上使用 python 的经验为 0，所以有人可能会指出我的直接方法。
【问题讨论】：
标签： python windows python-sphinx
在 windows 上安装 python 下载Python。运行可执行文件，一切就绪。
如果您安装了 pip，那么您可以打开命令提示符并输入
pip install -U Sphinx
如果你没有安装 pip 那么你首先需要在命令提示符下使用以下命令安装它
python -m pip install -U pip
【讨论】：
您现在可以使用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
现在 sphinx 已安装在您的 Windows 机器上的虚拟环境中。你可以使用 deactivate 来逃离你的新环境。
如果您希望再次进入您的 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\"")
【讨论】：
到目前为止，在 Windows 上使用 Python 最简单的方法是 WinPython，它是一个可移植的发行版，与任何其他可移植应用程序一样易于使用。它会给你一个 WinPython 命令提示符的图标，你可以从中使用 pip 等，就像在任何其他（例如 linux）系统上一样，或者你可以下载包并使用 WinPython 的控制面板安装它们。
【讨论】：