Python-doc rst文件打开

Python rst文件打开

RST与Python类似Javadoc与Java.

如果下载了别人的Python源码，里面有rst文件夹，我们可以转为html后用浏览器打开

某个开源项目的index.rst

1.安装python的sphinx模块： 

pip install sphinx
pip install -i http://pypi.douban.com/simple/ sphinx_rtd_theme --trusted-host pypi.douban.com

2.build输出html的目录

进入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进入