Windows下配置 sphinx+reStructuredText

首先安装 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 项目，进行测试。

参考：

Sphinx 1.7.6

Windows下配置sphinx+reStructuredText详解

如何用 ReadtheDocs、Sphinx 快速搭建写书环境

Try pandoc!