Généralisation

À l'origine, les descriptions de diagrammes devaient commencer avec @startuml et finir avec @enduml. PlantUML accepte maintenant de générer d'autres diagrammes que l'UML, et dans ce cas, @startuml n'a plus aucun sens.

Donc, la convention générale est de laisser les descriptions de diagrammes commencer avec @startXYZ et de finir avec @endXYZ, où XYZ doit changer selon le type de diagrammes.

Remarquez que XYZ peut être n'importe quelle chaîne de caractères (espaces incluses).

Ceci veut dire que les développeurs de plugins sont encouragés à changer leur code afin de reconnaître @start au lieu de @startuml.

Ditaa

Ditaa est un projet open-source qui propose de générer des diagrammes venant de descriptions textuelles. L'idée se rapproche de PlantUML, et il peut être utile pour de la documentation en générant d'autres diagrammes que l'UML.

La dernière version de PlantUML permet ceci :

🎉 Copied!
@startuml
ditaa
+--------+   +-------+    +-------+
|        +---+ ditaa +--> |       |
|  Text  |   +-------+    |diagram|
|Document|   |!magic!|    |       |
|     {d}|   |       |    |       |
+---+----+   +-------+    +-------+
    :                         ^
    |       Lots of work      |
    +-------------------------+
@enduml

Vous pourrez trouver ici la documentation complète à propos de ceci.

Si votre plugin ne supporte pas encore @startditaa, une fonctionnalité temporaire a été mise en place : il est possible d'utiliser Ditaa avec @startuml en utilisant le mot-clé ditaa à la toute première ligne de votre description.

Vous pouvez également utiliser quelques options, après le mot-clé @startditaa ou @ditaa :

  • -E ou --no-separation pour enlever les séparateurs
  • -S ou --no-shadows pour enlever les ombres
  • scale=XYZ pour changer d'échelle le digramme

🎉 Copied!
@startuml
ditaa(--no-shadows, scale=0.8)
/--------\   +-------+
|cAAA    +---+Version|
|  Data  |   |   V3  |
|  Base  |   |cRED{d}|
|     {s}|   +-------+
\---+----/
@enduml

Seule la génération en PNG est supportée. ⚠ On PlantUML, only PNG generation is supported.
WARNING
 This translation need to be updated. 
WARNING

Option supported by PlantUML

You can also use some option, after the @startditaa or ditaa keyword:

  • -E or --no-separation to remove separator
  • -S or --no-shadows to remove shadow
  • scale=<XYZ> to scale up or down the diagram

Without option

🎉 Copied!
@startditaa
+---------+  /--------\   +-------+
| cBLU    +--+cAAA    +---+Version|
|         |  |  Data  |   |   V3  |
|    +----+  |  Base  |   |cRED{d}|
|    |cPNK|  |     {s}|   +-------+
|    |    |  \---+----/
+----+----+    
@endditaa

Remove separator

🎉 Copied!
@startditaa -E
+---------+  /--------\   +-------+
| cBLU    +--+cAAA    +---+Version|
|         |  |  Data  |   |   V3  |
|    +----+  |  Base  |   |cRED{d}|
|    |cPNK|  |     {s}|   +-------+
|    |    |  \---+----/
+----+----+    
@endditaa

Remove shadow or scale diagram

🎉 Copied!
@startuml
ditaa(--no-shadows, scale=0.7)
+---------+  /--------\   +-------+
| cBLU    +--+cAAA    +---+Version|
|         |  |  Data  |   |   V3  |
|    +----+  |  Base  |   |cRED{d}|
|    |cPNK|  |     {s}|   +-------+
|    |    |  \---+----/
+----+----+    
@enduml

Tags

Tag Description
{c} Choice or Decision
{d} Document - Symbol representing a document
{io} Input/Output - Symbol representing input/output
{mo} Manual operation
{o} Ellipse
{s} Storage - Symbol representing a form of storage, like a database or a hard disk.
{tr} Trapezoid

🎉 Copied!
@startditaa
+------+------+------+------+------+------+------+
| c {c}|d {d} |io{io}|mo{mo}|o{o}  |s{s}  |tr{tr}|
+------+------+------+------+------+------+------+
@endditaa

More documentation

You will find the complete documentation about ditaa on: