原来,图表的描述需要以"@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: