在Windows上安装Python/Sphinx环境?
我们在Linux和OSX的Python环境中使用Sphinx来编写文档,但有一个使用Windows的人希望能有一个环境,方便他编辑和构建Sphinx文档。
在Windows上设置Sphinx是否可行?我猜最难的部分是安装Python环境和所有相关的依赖项,但我对Windows上的Python完全没有经验,所以可能有人能告诉我一个简单的办法来进行。
3 个回答
在Windows上使用Python,最简单的方法就是WinPython。它是一个便携版的Python,使用起来和其他便携应用一样简单。你会得到一个WinPython命令提示符的图标,打开后就可以像在其他系统(比如Linux)上一样使用pip等工具,或者你也可以通过WinPython的控制面板下载和安装软件包。
现在你可以使用 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\"")
要在Windows上安装Python,先去Python官网下载。下载后运行这个安装程序,就可以了。
如果你已经安装了pip,那么可以打开命令提示符,直接输入
pip install -U Sphinx
如果你还没有安装pip,那么需要先通过命令提示符输入以下内容来安装它
python -m pip install -U pip