PlantUML Redmine plugin

This plugin will allow adding PlantUML diagrams into Redmine.

Requirements

Java
PlantUML binary

Installation

create a shell script in /usr/bin/plantuml

#!/bin/bash
/usr/bin/java -Djava.io.tmpdir=/var/tmp -Djava.awt.headless=true -jar /PATH_TO_YOUR_PLANTUML_BINARY/plantuml.jar ${@}

copy this plugin into the Redmine plugins directory

Usage

go to the plugin settings page and add the PlantUML binary path /usr/bin/plantuml
PlantUML diagrams can be added as follow:

{{plantuml(png)
  Bob -> Alice : hello
}}

{{plantuml(svg)
  Bob -> Alice : hello
}}

you can choose between PNG or SVG images by setting the plantuml macro argument to either png or svg

using !include params

Since all files are written out to the system, there is no safe way to prevent editors from using the !include command inside the code block. Therefore every input will be sanitited before writing out the .pu files for further interpretation. You can overcome this by activating the Setting.plugin_plantuml['allow_includes'] Attention: this is dangerous, since all files will become accessible on the host system.

Known issues

PlantUML diagrams are not rendered inside a PDF export, see dkd#1

TODO

add image caching