BPMN Diagrams

Theobald Software uses Camunda or Draw.io to create diagrams.

Draw.io files and Camunda files are not compatible.

Note

The best option for the documentationw ould be to find a way to render .xml diagrams as both Camunda and Draw.io have an export option for .xml.

Alternatives: .svg and .png

Exporting diagrams with a large width as an .svg file is not recommended, because there is no build-in option to zoom or scroll for .svg images.
Exporting BPMN diagrams as an .svg file is generally not recommended, because there is no support for dark mode.

To enable a simple zoom option for .png images, use the following markdown syntax:

[![Delta-Process]][Delta-Process]

  [Delta-Process]: ../assets/images/articles/table/table-delta-process.png

Camunda

How to use:

![sample](../sample.bpmn){height="400px"}

Add the following to the extra.css file of each product:

.mk-bpmn-container {
    border: 2px solid grey;
    display: block; /* Ensures the border wraps correctly */
    background-color: white;
}

![this-is-a-sample](./sample.bpmn){height="400px"}

Some Diagrams in dev are created using draw.io. Draw.io diagrams can be exported as .svg files that support dark mode. Alternatively export as .png.

![this-is-a-sample](./XtractCore.drawio.svg){ width="100%" }

this-is-a-sample