PlantUML 1.2021.1 语言参考指引

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

摘要

文档介绍了PlantUML 1.2021.1版本的功能，包括绘制多种UML图（如时序图、类图、活动图等）以及非UML图（如网络图、JSON数据图、甘特图等）。文档重点介绍了活动图的新语法，支持更好的代码维护和不再依赖Graphviz。此外，还展示了如何通过简洁直观的语言定义这些图表，并提供了多个示例。

AI总结

### 《PlantUML 1.2021.1 语言参考指引》总结

#### 1. 概述
PlantUML 是一个开源工具，支持多种 UML 图表和非 UML 图表的绘制，包括：
- **UML 图表**：时序图、用例图、类图、对象图、活动图、组件图、部署图、状态图、定时图。
- **非 UML 图表**：JSON Data、Network diagram、线框图、架构图、SDL、Ditaa diagram、甘特图、MindMap diagram、Work Breakdown Structure diagram、数学公式、实体关系图。

PlantUML 通过简洁直观的语言定义图表，支持多种语法和扩展功能。

---

#### 2. 活动图新语法
- **背景**：旧语法存在维护困难等问题，因此从 V7947 开始引入新语法，新语法不再依赖 Graphviz，推荐使用。
- **特点**：
- 活动标签以冒号开始，分号结束。
- 支持 creole wiki 文本格式。
- 默认按定义顺序连接活动。
- 支持 `start` 和 `stop` 关键字定义开始和结束。
- **示例**：

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

---

#### 3. 网络图（NWDIAG）
- **功能**：支持定义网络节点及其属性（如颜色、描述）。
- **示例**：

  @startuml
  nwdiag {
    group {
      color = "#CCFFCC";
      description = "Long group description";
      web01;
      web02;
      db01 [shape = database];
    }
    network dmz {
      web01;
      web02;
    }
    network internal {
      web01;
      web02;
      db01 [address = ".101", shape = database];
    }
  }
  @enduml

---

#### 4. JSON 数据图
- **支持类型**：数组、对象、数字、字符串、布尔值。
- **示例**：

  @startjson
  {
    "DecimalNumber": [-1, 0, 1],
    "DecimalNumber.Digits": [-1.1, 0.1, 1.1],
    "DecimalNumber ExponentPart": [1E5]
  }
  @endjson

---

#### 5. 其他功能
- **对象图**：支持属性声明，如：

  object user { name = "Dummy"; id = 123 }

- **定时图**：支持颜色定义，如：

  @startuml
  concise "LR" as LR
  concise "ST" as ST
  LR is AtPlace #palegreen
  ST is AtLoad #gray
  @enduml

---

### 总结
PlantUML 提供了丰富的图表类型和灵活的语法支持，适用于多种场景。新语法的引入提升了活动图的可维护性和功能，网络图和 JSON 数据图进一步扩展了其应用场景。通过简洁的语言和直观的定义方式，PlantUML 成为绘制技术图表的有力工具。