reStructuredText 语法

Contents:

• 配置文件说明 conf.py
• 支持中文搜索
• 配置本地生成pdf
• graphviz 画图

参考文档

• Quick reStructuredText
• reStructuredText Directives
• reStructuredText Markup Specification
• A ReStructuredText Primer

INSTALL

$ sudo pip install --upgrade pip==9.0.1  -i https://pypi.mirrors.ustc.edu.cn/simple
$ sudo pip install sphinx==1.5.5  sphinx-autobuild==0.6.0 -i https://pypi.mirrors.ustc.edu.cn/simple
$ sudo pip install sphinx_rtd_theme==0.2.4  -i https://pypi.mirrors.ustc.edu.cn/simple

代码

.. code-block:: sh

        #!/bin/sh
        echo "hello world"

图片

.. image:: ./images/pic1.png
        :scale: 60%

.. image:: ./images/pic2.png
        :width:  380px
        :height: 253px


.. image:: ./x.gif
       :height: 660px
       :width: 580 px
       :scale: 70%
       :alt: alternate text
       :align: center

.. raw:: html

   <hr width=50 size=10>

.. raw:: html
   :url: http://docutils.sourceforge.net/docs/ref/rst/directives.html