操作系统 ： Windows7_x64

Python 版本 : 2.7.10

Sphinx 版本 :

官方网址：http://sphinx-doc.org

github地址： https://github.com/sphinx-doc/sphinx 

安装Sphinx

使用pip安装：

pip install -U Sphinx
pip install sphinx_rtd_theme

从源码安装：

git clone https://github.com/sphinx-doc/sphinxcd sphinx
pip install .

使用Sphinx

创建项目

在控制台输入以下命令：

sphinx-quickstart

根据实际情况填写。

编写项目

index.rst示例代码：

.. _tutorial-index:
 
.. highlight:: python
    :linenothreshold: 0sphinx示例文档=============: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

欢迎补充