This directive displays :epkg:`dot` graph in the documentation. It relies on :epkg:`Graphviz`.

In conf.py:

extensions = [ ...
    'sphinx.ext.graphviz',
    'sphinx_runpython.gdot',
]

One example:

.. gdot::
    :format: png

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

Which gives:

.. gdot::
    :format: png

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

The output format is an image (:epkg:`PNG`). It can be changed to use :epkg:`SVG` but it requires viz.js to be displayed.

.. gdot::
    :format: svg

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

.. gdot::
    :format: svg

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

The graph may also be the output of a script.

.. gdot::
    :format: svg
    :script: AFTER-THIS

    print("before the graph")
    print("AFTER-THIS", """
    digraph foo {
        "bar" -> "baz" -> "script";
    }
    """)

.. gdot::
    :format: svg
    :script: AFTER-THIS

    print("before the graph")
    print("AFTER-THIS", """
    digraph foo {
        "bar" -> "baz" -> "script";
    }
    """)

Finally, the tag :process: can be used to run the script in a separate process.

.. autoclass:: sphinx_runpython.gdot.sphinx_gdot_extension.GDotDirective