建立如下图的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
即可生成静态文档网页