PlantUML for Sphinx

Installation

.. code-block::

pip install sphinxcontrib-plantuml

Usage

Add sphinxcontrib.plantuml to your extensions list in your conf.py:

.. code-block:: python

extensions = [ 'sphinxcontrib.plantuml', ]

You may also need to specify the plantuml command in your conf.py:

.. code-block:: python

plantuml = 'java -jar /path/to/plantuml.jar'

Instead, you can install a wrapper script in your PATH:

.. code-block:: console

% cat < /usr/local/bin/plantuml #!/bin/sh -e java -jar /path/to/plantuml.jar "$@" EOT % chmod +x /usr/local/bin/plantuml

Then, write PlantUML text under the .. uml:: directive::

.. uml::

   Alice -> Bob: Hi!
   Alice <- Bob: How are you?

or specify path to an external PlantUML file::

.. uml:: external.uml

You can specify height, width, scale and align::

.. uml::
   :scale: 50 %
   :align: center

   Foo <|-- Bar

You can also specify a caption::

.. uml::
   :caption: Caption with **bold** and *italic*
   :width: 50mm

   Foo <|-- Bar

For details, please see PlantUML_ documentation.

.. _PlantUML: http://plantuml.com/

Configuration

plantuml Path to plantuml executable. (default: 'plantuml')

plantuml_output_format Type of output image for HTML renderer. (default: 'png')

:png: generate only .png inside :svg: generate .svg inside