wiki:PlantUmlMacro

Version 7 (modified by rjollos, 3 years ago) (diff)

Fixed incorrect statement about development path, and added note about creating a tag when we reach the 2.0 milestone. Added request for feedback.

The trunk is a development version that works with Trac 0.11 and later. The code is thought to be stable, but please be ready to do some testing and report defects if you intend to install it on a production system. A tag will be created for version 2.0 when the code is known to be stable. Posting a note to #9958 about your experience using the plugin would be very appreciated.

Planned Enhancements

  • Work towards v2.0, improving documentation and fixing minor defects.
  • Render plantuml files from repository #7053.

News

  • 19-March-2012: License changed from GPL to BSD 3-Clause, which is the license used by Trac.

Render PlantUML Diagrams

Description

PlantUML is a java utility that allows generation of different types of UML diagrams (sequence, activity, state, use cases, ...) from a simple text description file.

This plugin allows the integration of PlantUML on Trac Wiki pages, dynamically generating and embedding the diagrams.

Dependencies

The plugin depends on PlantUML compiled jar being installed on the system, a valid Java runtime, and Graphviz installed and correctly configured (these are dependencies for PlantUML itself)

Configuration

The following entry must be added to trac.ini:

[components]
...
plantuml.* = enabled


[plantuml]
plantuml_jar = /path/to/plantuml.jar
java_bin = /path/to/java_bin (optional, if Java binary is not on the search path)

Bugs/Feature Requests

Existing bugs and feature requests for PlantUmlMacro are here.

If you have any issues, create a new ticket.

Download

Download the zipped source from here.

Source

You can check out PlantUmlMacro from here using Subversion, or browse the source with Trac.

Example

Use with:

{{{
#!PlantUML
@startuml
Alice -> Bob: Authentication Request
Bob --> Alice: Authentication Response
Alice -> Bob: Another authentication Request
Alice <-- Bob: another authentication Response
@enduml
}}}

results in something like:

More information on the PlantUML language can be found in PlantUML Website

Recent Changes

[14362] by rjollos on 2015-01-08 15:05:55
2.0dev: Fixed comparison after splitting filename. Fixes #12132.
[14361] by rjollos on 2015-01-08 07:58:54
2.0dev: Check that plantuml_jar is the path of a file ending in .jar. Refs #12132.
[14360] by rjollos on 2015-01-08 07:52:12
2.0dev: PEP-0008 change and removed unused imports.

Author/Contributors

Author: airadier
Maintainers: airadier, rjollos
Contributors: ebencheung
License: BSD 3-Clause

Attachments (1)

Download all attachments as: .zip