标签：blog user 分段 res git clone date nbsp htm 情况
操作系统 ： Windows7_x64
Python 版本 : 2.7.10
Sphinx 版本 :
github地址： https://github.com/sphinx-doc/sphinx
使用pip安装：
pip install -U Sphinx pip install sphinx_rtd_theme
从源码安装：
git clone https://github.com/sphinx-doc/sphinx cd sphinx pip install .
在控制台输入以下命令：
sphinx-quickstart
根据实际情况填写。
index.rst示例代码：
.. _tutorial-index: .. highlight:: python :linenothreshold: 0 sphinx示例文档 ============= :Release: |version| :Date: |today| 欢迎阅读sphinx示例文档 ============================================= 内容示例: .. toctree:: :maxdepth: 2 test1.rst
index.rst 为主文件
test1.rst 为具体内容
test1.rst示例内容：
rst语法简介 =========== 空行分段 ---------- 第一段内容。 第二段和第一段间有空行。
生成html文档
sphinx-build -b html source/ build/
本文github地址：
https://github.com/mike-zhang/mikeBlogEssays/blob/master/2018/20181006_使用Sphinx编写文档.rst
欢迎补充
标签：blog user 分段 res git clone date nbsp htm 情况
原文地址：https://www.cnblogs.com/MikeZhang/p/rstDoc20181006.html
