PlantUML is an open-source tool allowing users to create diagrams from a plain text language. Besides various UML diagrams, PlantUML has support for various other software development related formats (such as Archimate, Block diagram, BPMN, C4, Computer network diagram, ERD, Gantt chart, Mind map, and WBD), as well as visualisation of JSON and YAML files.

PlantUML
Original author(s)Arnaud Roques
Developer(s)Arnaud Roques[1]
Initial release17 April 2009 (2009-04-17)[2]
Stable release
v1.2024.7[3] Edit this on Wikidata / 9 September 2024; 45 days ago (9 September 2024)
Repository
Written inJava
Operating systemLinux, OS X, Windows
TypeUML tool
LicenseGNU General Public License
Websiteplantuml.com
Plantuml
Filename extension
.pu, .puml, .txt[4]
Type of formatTextual

The language of PlantUML is an example of a domain-specific language.[5] Besides its own DSL, PlantUML also understands AsciiMath, Creole, DOT, and LaTeX. It uses Graphviz software to lay out its diagrams and Tikz for LaTeX support. Images can be output as PNG, SVG, LaTeX and even ASCII art. PlantUML has also been used to allow blind people to design and read UML diagrams.[6][7]

Applications that use PlantUML

edit

There are various extensions or add-ons that incorporate PlantUML.[8]

  • Atom has a community maintained PlantUML syntax highlighter and viewer.
  • Confluence wiki has a PlantUML plug-in for Confluence Server, which renders diagrams on-the-fly during a page reload. There is an additional PlantUML plug-in for Confluence Cloud.
  • Doxygen integrates diagrams for which sources are provided after the startuml command.
  • Eclipse has a PlantUML plug-in.
  • Google Docs has an add-on called PlantUML Gizmo that works with the PlantUML.com server.
  • IntelliJ IDEA can create and display diagrams embedded into Markdown (built-in) or in standalone files (using a plugin).
  • LaTeX using the Tikz package has limited support for PlantUML.
  • LibreOffice has Libo_PlantUML extension to use PlantUML diagrams.
  • MediaWiki has a PlantUML plug-in which renders diagrams in pages as SVG or PNG.[9]
  • Microsoft Word can use PlantUML diagrams via a Word Template Add-in. There is an additional Visual Studio Tools for Office add-in called PlantUML Gizmo that works in a similar fashion.
  • NetBeans has a PlantUML plug-in.
  • Notepad++ has a PlantUML plug-in.[10]
  • Obsidian has a PlantUML plug-in.[11]
  • Org-mode has a PlantUML org-babel support.
  • Rider has a PlantUML plug-in.
  • Sublime Text has a PlantUML package called PlantUmlDiagrams for Sublime Text 2 and 3.
  • Visual Studio Code has various PlantUML extensions on its marketplace, most popular being PlantUML by jebbs.
  • Vnote open source notetaking markdown application has built in PlantUML support.[12]
  • Xcode has a community maintained Source Editor Extension to generate and view PlantUML class diagrams from Swift source code.[13]

Text format to communicate UML at source code level

edit

PlantUML uses well-formed and human-readable code to render the diagrams.

There are other text formats for UML modelling, but PlantUML supports many diagram types, and does not need an explicit layout, though it is possible to tweak the diagrams if necessary.

+--------------------------------------+
|         TEDx Talks Recommendation    |
|                System                |
+--------------------------------------+
| +----------------------------------+ |
| |          Visitor                 | |
| +----------------------------------+ |
| | + View Recommended Talks         | |
| | + Search Talks                   | |
| +----------------------------------+ |
+--------------------------------------+
                   |
                   |
                   V
+--------------------------------------+
|         Authenticated User           |
+--------------------------------------+
| +----------------------------------+ |
| |          User                    | |
| +----------------------------------+ |
| | + View Recommended Talks         | |
| | + Search Talks                   | |
| | + Save Favorite Talks            | |
| +----------------------------------+ |
+--------------------------------------+
                   |
                   |
                   V
+--------------------------------------+
|         Admin                        |
+--------------------------------------+
| +----------------------------------+ |
| |          Admin                   | |
| +----------------------------------+ |
| | + CRUD Talks                     | |
| | + Manage Users                   | |
| +----------------------------------+ |
+--------------------------------------+

See also

edit

References

edit
  1. ^ "PlantUML overview". 13 May 2023.
  2. ^ "Plantuml". 13 May 2023.
  3. ^ "Release v1.2024.7".
  4. ^ "Embedded diagrams into source code". PlantUML.com. Retrieved 2022-05-19.
  5. ^ Campagne, Fabien (June 16, 2014). The MPS Language Workbench, Vol. 1. CreateSpace Independent Publishing Platform. ISBN 9781497378650.
  6. ^ Luque, L.; Veriscimo, E.S.; Pereira, G.C.; Filgueiras, L.V.L. (2014). "Can We Work Together? On the Inclusion of Blind People in UML Model-Based Tasks". In P.M. Langdon; J. Lazar; A. Heylighen; et al. (eds.). Inclusive Designing Joining Usability, Accessibility, and Inclusion (Aufl. 2014 ed.). Cham: Springer International Publishing. ISBN 978-3-319-05095-9.
  7. ^ Müller, Karin (2012). "How to Make Unified Modeling Language Diagrams Accessible for Blind Students". In Miesenberger, Klaus (ed.). Computers Helping People With Special Needs 13th International Conference, ICCHP 2012, Linz, Austria, July 11-13, 2012, Proceedings, Part I. Berlin [u.a.]: Springer-Verlag New York Inc. pp. 186–190. ISBN 978-3-642-31521-3.
  8. ^ "Running". PlantUML. Retrieved 2022-07-16.
  9. ^ "Extension:PlantUML - MediaWiki". www.mediawiki.org. Retrieved 2018-10-21.
  10. ^ Fruchtzwerg94. "PlantUML Viewer". GitHub. Retrieved 2022-05-29.{{cite web}}: CS1 maint: numeric names: authors list (link)
  11. ^ joethei. "PlantUML". GitHub. Retrieved 2023-12-13.
  12. ^ "Vnote". GitHub. 13 December 2021.
  13. ^ "SwiftPlantUML-Xcode-Extension". GitHub. 8 December 2021.
edit