Ditaa
(DIagrams Through Ascii Art) est un projet Open Source qui permet de générer des diagrammes généraux à partir de descriptions textuelles. L'idée est proche de
PlantUML, et il peut être utile pour la documentation de générer d'autres diagrammes qu'UML.
Alors
PlantUML permet cela :
🎉 Copied!
|
@startditaa
+--------+ +-------+ +-------+
| +---+ ditaa +--> | |
| Text | +-------+ |diagram|
|Document| |!magic!| | |
| {d}| | | | |
+---+----+ +-------+ +-------+
: ^
| Lots of work |
+-------------------------+
@endditaa
|
Il n'est plus possible d'utiliser Ditaa avec @startuml
en utilisant le mot clé ditaa
sur la toute première ligne de votre description.
Vous devez maintenant utiliser @startditaa
et @endditaa
.
⚠ Sur PlantUML, seule la génération
PNG est supportée.
À 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
.
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!
|
@startditaa < --no-shadows, scale=0.7
+---------+ /--------\ +-------+
| cBLU +--+cAAA +---+Version|
| | | Data | | V3 |
| +----+ | Base | |cRED{d}|
| |cPNK| | {s}| +-------+
| | | \---+----/
+----+----+
@endditaa
|
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
|
You will find the complete documentation about
ditaa on: