首先安装 Python
,并将 pip
升级到最新。最后通过 pip
安装 sphinx
。
安装 Python 3.7
Python 3.7
的默认安装路径如下:
C:\Users\username\AppData\Local\Programs\Python\Python37
将以上路径添加到环境变量:
SET PATH=C:\Users\username\AppData\Local\Programs\Python\Python37;C:\Users\username\AppData\Local\Programs\Python\Python37\Scripts;%PATH%
升级 pip
执行如下命令,升级 pip
:
python -m pip install –upgrade pip
安装 sphinx
通过 pip 安装 sphinx:
pip install -U sphinx
如果安装超时,可以尝试使用 --default-timeout=N
更改超时时间。默认超时时间为 15 秒。
sudo pip --default-timeout=1000 install jupyter
运行 sphinx-quickstart
,新建一个 sphinx 项目,进行测试。
参考:
Windows下配置sphinx+reStructuredText详解