原来,图表的描述需要以"@startuml"开头,以@enduml 结束,PlantUML在支持UML同时支持其他图表,既然如此,"@startuml"就没有存在的必要了。
所以,通用规则允许图表描述以@startXYZ 开头,以@endXYZ 结束,"XYZ"根据图表的类型而改变。
注意,XYZ 可以是任何字符串(包括空格)。
这意味着我们鼓励插件开发者,以@start 代替@startuml 作为标识。
Ditaa 是一个支持通过文本描述生成通用图表的开源项目。这个理念和PlantUML非常相近,所以,支持除UML之外其他图表的文档化将会很有很有意义。
所以最新版本的PlantUML支持下面的语法:
🎉 Copied!
|
@startuml
ditaa
+--------+ +-------+ +-------+
| +---+ ditaa +--> | |
| Text | +-------+ |diagram|
|Document| |!magic!| | |
| {d}| | | | |
+---+----+ +-------+ +-------+
: ^
| Lots of work |
+-------------------------+
@enduml
|
你可以在 这里 找到它的完整的文档。
如果你的插件还不支持@startditaa ,可以使用 临时 解决方案:在你的文档描述首行使用@startuml ,通过ditta 关键字来支持 Ditaa 。
你同样可以在@startditaa 或者@ditta 关键字后面使用一些设置:
-E 或者 --no-separation 移除分隔符
-S 或者 --no-shadows 移除阴影
scale=XYZ to 缩放图表
🎉 Copied!
|
@startuml
ditaa(--no-shadows, scale=0.8)
/--------\ +-------+
|cAAA +---+Version|
| Data | | V3 |
| Base | |cRED{d}|
| {s}| +-------+
\---+----/
@enduml
|
只支持PNG格式。
⚠ On PlantUML, only PNG generation is supported.
WARNING This translation need to be updated. WARNING
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:
|
|