Темы

Следуя работе Бретта Шварца, мы интегрировали несколько тем в основную библиотеку ядра.

Поскольку эти темы включены в библиотеку, она работает "из коробки": вам не нужно ничего устанавливать на своей стороне. Вам просто нужно использовать директиву !theme:

🎉 Copied!

@startuml
!theme spacelab
class Example {
  Theme spacelab
}
@enduml

🎉 Copied!

@startuml
!theme spacelab
a -> b
b -> c
@enduml

List of available themes

Several websites are listing available themes:

Finally, you can list all available themes from your PlantUML library:

🎉 Copied!

@startuml
help themes
@enduml

Or you can use the %get_all_theme builtin function to retreive a JSON array of all PlantUML theme.

🎉 Copied!

@startjson
%get_all_theme()
@endjson

Available from version 1.2024.4.

Coloring message with some procedures included on some theme

Some theme includes some procedures, to help coloring message, as:
  • $success("<msg>")
  • $failure("<msg>")
  • $warning("<msg>")

Example:

🎉 Copied!

@startuml
!theme spacelab
Bob -> Alice :  hello
Bob <- Alice :  $success("success: hello B.")
Bob -x Alice :  $failure("failure")
Bob ->> Alice : $warning("warning")
@enduml

Local themes

You can create your own theme on your local file system. You can duplicate any existing theme to create your own one.

By default, a theme file is named puml-theme-foo.puml where foo is the name of the theme.

To invoke a local theme, you have to use the following directive:

!theme foo from /path/to/themes/folder

Themes from the Internet

Other repositories can also publish themes for PlantUML.

Theme files must follow the same convention: puml-theme-foo.puml where foo is the name of the theme.

To use a theme from a remote repository, you have to use the following directive:

!theme amiga from https://raw.githubusercontent.com/plantuml/plantuml/master/themes

If you find any interesting theme, you can also propose a pull request so that we integrate this theme into the main core library.


Privacy Policy      Advertise