You can use PlantUML using the online web service to generate images on-the-fly. A online demonstration is available at http://www.plantuml.com/plantuml, but you can also install it on your own JEE web application server.
The big input field is used to enter your diagram description. You can type in any
diagram description, then press the submit button and the diagram will be displayed below.
It's a good practice to start your diagram by the
When you validate the diagram, you are redirected to an encoded URL encoding your diagram. The encoded form is a convenient way to share your diagrams with others because it's shorter than the many lines of a diagram and it can be easily displayed in a browser using the online PlantUML Server.
SyfFKj2rKt3CoKnELR1Io4ZDoSa70000 is the encoded form of:
@startuml Bob -> Alice : hello @enduml
By default, the PlantUML Server shows the well-known
Bob -> Alice
sample but it's easy to invoke it with an other diagram using its encoded form.
/uml/ENCODED to the URL.
For example, this link http://www.plantuml.com/plantuml/uml/Aov9B2hXil98pSd9LoZFByf9iUOgBial0000 opens the PlantUML Server with a simple Hello World activity diagram.
Since PlantUML is saving into PNG Metadata diagram's source code, it is possible to retrieve
this source by passing some image URL to the web server, using the
For example, if you want to retrieve the diagram's source of the following image http://i.stack.imgur.com/HJvKF.png, you can use the following URL http://plantuml.com/plantuml/?metadata=http://i.stack.imgur.com/HJvKF.png.
To get a PNG file of a diagram, use the following URL scheme:
To get a SVG XML file of a diagram, use the following URL scheme:
Note that not all diagrams can be produced in SVG. For example, ditaa diagrams are only available in PNG format.
To get an ASCII Art representation of a diagram, encoded in UTF-8, use the
following URL scheme:
Note that only sequence diagrams can be produced in ASCII Art.
To get the
client image map related to a previously generated PNG image, use the
following URL scheme:
The output is a list of <area> tags, each line matching a link present in the diagram description.
For example, the following diagram:
@startuml participant Bob [[http://www.plantuml.com]] Bob -> Alice : [[http://plantuml.sourceforge.net]] hello @enduml
produces the following output:
<area shape="rect" id="id1" href="http://plantuml.sourceforge.net" title="http://plantuml.sourceforge.net" alt="" coords="33,47,80,69"/><area shape="rect" id="id2" href="http://www.plantuml.com" title="http://www.plantuml.com" alt="" coords="5,0,44,111"/>
Note that you need to include theses
<area... tags inside a
<map... html tag to have the complete image map.
With the proxy service, the source description of the diagram can be fetched by the PlantUML Server from a remote document.
The proxy service uses the following URL scheme:
For example, try this link:
Note that the address of the remote document is specified as a parameter, so it is not necessary to "URL encode" the URL.
To install PlantUML Server on your own JEE 5 web server, download the plantuml.war file and copy it on the webapp folder of your server.
PlantUML Server have been successfully tested on Tomcat 6 and 7 and Jetty 8 and 9.
PlantUML Server is open source, the code is available on GitHub.
HOME NEWS MAP