/sphinxcontrib-drawio

Sphinx extension for including draw.io files.

Primary LanguagePythonMIT LicenseMIT

sphinxcontrib-drawio

Sphinx Extension to add the drawio directive to include draw.io diagrams.

Important: This extension is in development and not all features will work as advertised or at all.

Installation

  1. python3 -m pip install sphinxcontrib-drawio
  2. In your sphinx config:
extensions = [
    "sphinxcontrib.drawio"
]
  1. Add the binary to $PATH. For Windows add C:\Program Files\draw.io and on Linux add /opt/draw.io/.

Options

Both of these are optional.

drawio_output_format = "png"
drawio_binary_path = "/path/to/draw.io-binary"

Usage

.. drawio:: example.drawio
    :format: png
    :alt: An Example
    :align: center

If any other of the draw.io CLI tool's options are wanted, please file an issue.