在Windows上安装python/sphinx环境？

Question

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

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

Answer 1

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

首先，下载并安装Python。如果您想使用 Latexpdf 生成器，您还需要安装适用于 Windows 的TeX Live或MiKTeX。

接下来，运行 pip-win.exe。它将自动提取所需的安装工具并在您的系统上安装 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\"")