RST与Python类似Javadoc与Java.
如果下载了别人的Python源码，里面有rst文件夹，我们可以转为html后用浏览器打开
某个开源项目的index.rst
pip install sphinx pip install -i http://pypi.douban.com/simple/ sphinx_rtd_theme --trusted-host pypi.douban.com
进入doc的父文件夹，比如
python-prompt-toolkit-master>dir
python-prompt-toolkit-master 的目录
.gitignore
.travis.yml
AUTHORS.rst
CHANGELOG
docs
examples
LICENSE
MANIFEST.in
prompt_toolkit
README.rst
setup.py
使用命令
python-prompt-toolkit-master>sphinx-build -b html docs build
docs是含有rst的目录，build是输出html的目录
运行完后就可以在浏览器里查看了，一般从build/index.html进入
原文：https://www.cnblogs.com/xiao-apple36/p/9209338.html