PlantUML 1.2021.3 语言参考指引

• 语言: 中文（简体）
• 格式: .pdf
• 来源: pdf.plantuml.net

摘要

文档介绍了PlantUML 1.2021.3版本的语言参考指引，重点介绍了活动图的新语法及其优势，包括不再依赖Graphviz、支持更多图表类型和风格。文档还展示了如何使用新语法绘制简单活动图、条件风格、嵌套元素和全局样式，以及如何包含标准库和使用AWS库。

AI总结

《PlantUML 1.2021.3 语言参考指引》总结：

1. **活动图新语法**
- 旧语法存在代码难以维护的问题，从 V7947 版本开始引入全新语法（Beta 版）。
- 新语法不再依赖 Graphviz，且兼容性良好，鼓励用户使用新语法。

2. **活动图基本用法**
- 活动标签：以冒号开始，以分号结束，支持 Creole Wiki 文本格式。
- 示例：

     @startuml  
     :Hello world;  
     :This is on defined on several lines;  
     @enduml  

- 开始/结束标记：可使用 `start` 和 `stop` 或 `end` 关键字定义活动图的边界。

3. **条件样式**
- 提供两种样式：
- **内部样式（默认）**：条件框内显示文本，例如：

       skinparam conditionStyle inside  
       start  
       :act1;  
       :act2;  
       repeatwhile (end)  
       :act3;  
       stop  

- **全局样式**：在部署图中统一设置样式，例如：

4. **包含 SALT 在活动图中**
- 支持使用 SALT 插件在活动图中插入图标，例如：

     (*) --> " {{ salt {+ an example choose one option ()one ()two [ok] } }} " as choose  
     choose -right-> " {{ salt {+ PlantUML 语言参考指引 (1.2021.2) 232 / 397 1100 LineThickness 1 LineColor black } card { BackGroundColor #ff3311 LineThickness 1 LineColor black } circle { BackGroundColor #ff3311 LineThickness 1 LineColor black } cloud { BackGroundColor #ff4422 LineThickness 1 LineColor black } collections { BackGroundColor #ff4422 LineThickness 1 LineColor black } component { BackGroundColor #ff6644 LineThickness 1 LineColor black } control { BackGroundColor #ff6644 LineThickness 1 LineColor black } database { BackGroundColor #ff9933 LineThickness 1 LineColor black } entity { BackGroundColor #feae2d LineThickness 1 LineColor black } file { BackGroundColor #feae2d LineThickness 1 LineColor black } folder { BackGroundColor #ccbb33 LineThickness 1 LineColor black } frame { BackGroundColor #d0c310 LineThickness 1 LineColor black } hexagon { BackGroundColor #aacc22 LineThickness 1 LineColor black } interface { PlantUML 语言参考指引 (1.2021.2) 152 / 397  

5. **标准库（Stdlib）**
- 标准库包含多种图表类型，如序列图、类图、活动图等。
- 使用 `@startuml stdlib @enduml` 可列出所有标准库内容。

6. **AWS 库**
- 提供 AWS 相关图标和宏，用于绘制 AWS 组件图。
- 示例：

     !include   
     !include   
     skinparam nodeBackgroundColor White  
     AMAZONS3(s3_internal,"Default S3")  
     AMAZONS3(s3_partner,"Vendor's S3")  
     s3_internal <- s3_partner  

总结：PlantUML 提供了丰富且灵活的语法和库，支持多种 UML 和非 UML 图表，适用于软件开发、系统设计和文档编写。新语法的引入提升了代码维护性和可扩展性，建议用户优先使用新语法以获得更好的体验。