在Windows上安装Python/Sphinx环境?

11 投票
3 回答
10734 浏览
提问于 2025-04-17 07:59

我们在Linux和OSX的Python环境中使用Sphinx来编写文档,但有一个使用Windows的人希望能有一个环境,方便他编辑和构建Sphinx文档。

在Windows上设置Sphinx是否可行?我猜最难的部分是安装Python环境和所有相关的依赖项,但我对Windows上的Python完全没有经验,所以可能有人能告诉我一个简单的办法来进行。

3 个回答

0

在Windows上使用Python,最简单的方法就是WinPython。它是一个便携版的Python,使用起来和其他便携应用一样简单。你会得到一个WinPython命令提示符的图标,打开后就可以像在其他系统(比如Linux)上一样使用pip等工具,或者你也可以通过WinPython的控制面板下载和安装软件包。

0

现在你可以使用 pip-win 来轻松地在 Windows 上的虚拟环境中设置 sphinx。

首先,下载并安装 Python。如果你想使用 latexpdf 这个功能,你还需要安装 TeX Live 或者 MiKTeX

接下来,运行 pip-win.exe。它会自动下载并安装所需的 setuptools、pip 和 virtualenv 到你的系统上。当它启动时,会自动找到你刚安装的 Python。如果你把 Python 安装在了默认目录以外的地方,你可以手动输入绝对路径或者浏览找到它。

然后,在命令行中,你可以通过输入以下命令来创建一个新的虚拟环境:

venv -c C:\foo\sphinx-venv

这会打开一个命令提示符,你已经在你的虚拟环境中了。接下来,你可以使用 pip 命令来安装 sphinx:

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

现在,sphinx 已经在你的 Windows 机器的虚拟环境中安装好了。你可以使用 deactivate 命令退出这个新环境。

每当你想再次进入你的虚拟环境来构建更多的 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\"")
2

要在Windows上安装Python,先去Python官网下载。下载后运行这个安装程序,就可以了。

如果你已经安装了pip,那么可以打开命令提示符,直接输入

pip install -U Sphinx

如果你还没有安装pip,那么需要先通过命令提示符输入以下内容来安装它

python -m pip install -U pip

撰写回答