Version 23 (modified by 9 years ago) (diff) | ,
---|
Contents
Status
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-September-2013: Since r13397 image maps are supported.
- 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, objects, ...) from a simple text description file.
This plugin allows the integration of PlantUML on Trac Wiki pages, dynamically generating and embedding the diagrams.
Bugs/Feature Requests
Existing bugs and feature requests for PlantUmlMacro.
If you have any issues, create a new ticket.
defect |
14 / 16 |
||
---|---|---|---|
enhancement |
8 / 9 |
||
task |
5 / 6 |
Usage
- As a WikiProcessor with markup:
{{{ #!plantuml @startuml Alice -> Bob: Authentication Request Bob --> Alice: Authentication Response Alice -> Bob: Another authentication Request Alice <-- Bob: another authentication Response @enduml }}}
will render the following UML diagram:
- More information on the PlantUML language and different types of UML diagrams can be found on the PlantUML Website.
Installation
- Note:
- Below instructions should be specific to some operating systems. Please help expanding these instructions.
- Broader installation guidelines are made available at TracPlugins.
- Unused sections are for future use and are suggested to be commented out. For example:
{{{ #!comment 1. '''Check''' dependencies: i. none required }}}
[sudo]
is optional in case you already have enough authorisation to modify your server.
- Check dependencies:
- A valid Java runtime environment.
- plantuml.jar: save it to the location that you'll specify in the configuration section
/path/to/plantuml.jar
.-
[sudo] wget http://sourceforge.net/projects/plantuml/files/plantuml.jar/download
- Check version of PlantUML jar:
cd /path/to/plantuml.jar [sudo] java -jar plantuml.jar -version
-
- Graphviz: check if installed and working as required in graphvizdot.
[sudo] java -jar plantuml.jar -testdot
- Install component:
- with easy_install, globally:
[sudo] easy_install https://trac-hacks.org/svn/plantumlmacro/trunk
- with easy_install, globally:
- Enable this component as follows:
- by updating trac.ini file under appropriate configuration section;
[components] plantuml.* = enabled
- or accessing your Admin panel (under selected Trac environment
..admin/general/plugins
).
- by updating trac.ini file under appropriate configuration section;
- Configure the Trac environment as follows:
- by updating trac.ini file under appropriate configuration section;
[plantuml] plantuml_jar = /path/to/plantuml.jar java_bin = /path/to/java_bin (optional, if Java binary is not on the search path)
- example
plantuml_jar = /project-resources/trac/plugins
- example
java_bin = java
assumes that the Java binary is on the search path.
- example
- or accessing your Admin panel (under selected Trac environment
..admin/general/plugins
).
- by updating trac.ini file under appropriate configuration section;
- Restart web server:
- Apache on Ubuntu, example command line:
[sudo] /etc/init.d/apache2 restart
- Apache on Ubuntu, example command line:
- Test if this component is working properly (main environment and secondary ones if you have). If this component is installed correctly, then the example shown in the #Usage section should be also displayed on the WikiMacros#PlantUML-macro page.
Source and Download
You can check out PlantUmlMacro using Subversion, or browse the source with Trac, or [download:plantumlmacro download] the zipped source.
Recent Changes
- 17597 by rjollos on 2019-11-26 05:41:59
-
TracPlantUml 2.3: Tag version 2.3
The release has been published to pypi:TracPlantUml/2.3
Fixes #13679.
- 17596 by rjollos on 2019-11-26 05:39:24
-
TracPlantUml 2.3dev: Add
classifiers
metadata
Refs #13679.
- 17025 by rjollos on 2018-01-28 11:38:22
-
TracPlantUml 2.3dev: Fix
usemap
attribute not prefixed with#
Patch by dries.decock@...
Fixes #13366.
(more)
Author/Contributors
Author: airadier
Maintainers: Ryan J Ollos, rjollos
Contributors: ebencheung, Erwin Rademaker
Attachments (1)
- sequence.PNG (6.2 KB) - added by 12 years ago.
Download all attachments as: .zip