Sphinx 文档例子

建立如下图的Sphinx文档

.
├── build
├── make.bat
├── Makefile
└── source
    ├── conf.py
    ├── index.rst
    ├── intro.rst
    ├── _static
    └── _templates

index.rst的内容如下：

.. newproject documentation master file, created by
   sphinx-quickstart on Mon Dec 25 11:23:47 2017.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

Welcome to newproject's documentation!
======================================

.. toctree::
   :maxdepth: 2

   intro


Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`

intro.rst内容如下

这里是一个文章的题目
============================
这里是段落内容

这里是文章的段落标题
--------------------

无序列表

 * 元素1
 * 元素2

有序列表

 #. 元素1
 #. 元素2

行内标记
-------------
*斜体标记*
**加粗标记**

在根目录下输入 make html即可生成静态文档网页