Enhanced integration between Sphinx documentation, PlantUML, and DrawIO diagrams

sphinx_ref_in_plantuml_hyperlinks is a Sphinx extension that automatically resolves references (links) created using the std:ref: syntax within PlantUML and DrawIO diagrams. This allows you to link elements in your diagrams to corresponding sections or elements in your Sphinx documentation, enhancing navigation and information flow.

Example of Use

.. uml::
    :caption: PlantUML Caption with **bold** and *italic*
    :name: PlantUML Label2

    @startmindmap mindmap2

    *[#Orange] Example of clickable references
    **[#lightgreen] [[ ":ref:`plantuml label1`" Internal Page Reference1 ]]
    **[#lightblue] [[ ":ref:`N_00001`" Internal Page Reference2 on Sphinx-Needs ]]

    @endmindmap

Installation

You can install sphinx-ref-in-plantuml-hyperlinks with pip

pip install sphinx-ref-in-plantuml-hyperlinks

Alternatively (Linux)

git clone https://github.com/mi-parkes/sphinx-ref-in-plantuml-hyperlinks.git
cd sphinx-ref-in-plantuml-hyperlinks

poetry install
poetry build

pip install dist/sphinx_ref_in_plantuml_hyperlinks*.whl

Activation

In your conf.py configuration file, add sphinx_ref_in_plantuml_hyperlinks to your extensions list:

extensions = [
  ...
  'sphinx_ref_in_plantuml_hyperlinks'
  ...
]

List Labels:

poetry run task labels