This is a Title
===============
That has a paragraph about a main subject and is set when the '='
is at least the same length of the title itself.

Subject Subtitle
----------------
Subtitles are set with '-' and are required to have the same length
of the subtitle itself, just like titles.

Lists can be unnumbered like:

* Item Foo
* Item Bar

Or automatically numbered:

#. Item 1
#. Item 2

Inline Markup
-------------
Words can have *emphasis in italics* or be **bold** and you can define
code samples with back quotes, like when you talk about a command: ``sudo``
gives you super user powers!

pip install sphinx

mkdir mybook
cd mybook
sphinx-quickstart

The quadratic formula is$$-b \pm \sqrt{b^2 - 4ac} \over 2a$$

# 配置graphviz插件
extensions = ['sphinx.ext.graphviz']

# 设置 graphviz_dot 路径
graphviz_dot = 'dot'# 设置 graphviz_dot_args 的参数，这里默认了默认字体
graphviz_dot_args = ['-Gfontname=Georgia',
'-Nfontname=Georgia',
'-Efontname=Georgia']
# 输出格式，默认png，这里我用svg矢量图
graphviz_output_format = 'svg'

.. graphviz::

   digraph foo {
      "bar" -> "baz";
   }

.. graphviz:: external.dot

# Add any Sphinx extension module names here, as strings. They can be
# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
# ones.
extensions = ['sphinx.ext.autodoc']
extensions = ['sphinxcontrib.plantuml']

plantuml = 'java -jar plantuml.2017.08.jar'

.. uml::
   :caption: Caption with **bold** and *italic*
   :scale: 50 %
   :align: center

   Foo <|-- Bar

.. uml:: external.uml

pip install recommonmark

source_parsers = {
  '.md': 'recommonmark.parser.CommonMarkParser',
}

source_suffix = ['.rst', '.md']

html_theme_options = {
    'collapse_navigation': False,
    'display_version': False,
    'navigation_depth': 3,
}