plantuml(1)

NAME

plantuml - generate UML diagrams from a text description

SYNOPSIS

plantuml [options] files/dirs...

DESCRIPTION

PlantUML is used to draw UML diagrams using a simple and human readable text description.

Note that graphviz is required to be installed for generation of all diagrams except sequence diagrams.

When files/directories are given, they are processed in batch mode. Otherwise, a GUI window appears. It allows user to browse directories and view diagrams generated from suitable files (must have one of the following extensions: .txt, .tex, .java, .htm, .html, .c, .h, .cpp).

You can use the following wildcards in files/dirs:

* means any characters but '/'

? one and only one character but '/'

** means any characters (used to recurse through directories)

OPTIONS

-tformat

Generate images in one of the following formats:

png PNG image (default)

svg SVG image

eps EPS image

pdf PDF image

vdx VDX image

xmi XMI file for class diagram

scxml SCXML file for state diagram

html HTML file for class diagram

txt ASCII art

utxt ASCII art using Unicode characters

latex LaTeX/TikZ format

latex:nopreamble LaTeX/TikZ format without preamble

-output dir, -o dir: Generate images in the specified directory.

-config file: Read the provided config file before each diagram.

-charset encoding: Use a specific encoding (default is UTF-8).

-exclude pattern, -x pattern: Exclude files that match the provided pattern.

-metadata: Retrieve PlantUML sources from PNG images.

-version: Display information about PlantUML and Java versions.

-verbose, -v: Be more verbose.

-quiet: Don't print error messages.

-keepfiles: Do NOT delete temporary files after process.

-help, -h Display a help message.

-testdot Test the installation of graphviz.

-graphvizdot path Specify the dot executable path.

-pipe, -p Use stdin for PlantUML source and stdout for PNG/SVG generation.

-computeurl Compute the encoded URL of a PlantUML source file.

-decodeurl Retrieve the PlantUML source from an encoded URL.

This list of options is not exhaustive. For more information, run plantuml -help.

For more documentation, see the PlantUML's website: <https://plantuml.com/command-line>.

ENVIRONMENT

DISPLAY: If not set or empty, uses Java's headless mode to run PlantUML.

GRAPHVIZ_DOT: Similarly to -graphvizdot, can be used to specify the path to the dot executable. If both GRAPHVIZ_DOT and -graphvizdot are used, the command-line setting takes the precedence.

NOTES

The Debian package for PlantUML comes without Easter eggs, XEarth diagram support or inbuilt FTP server, Telnet server or a Sudoku game.

AUTHOR

PlantUML was written by Arnaud Roques <[email protected]>.

This manual page was written by Ilya Paramonov <[email protected]> and updated by Andrej Shadura <[email protected]>, for the Debian project (and may be used by others).