使用 PlantUML 绘制 UML - PlantUML 语言参考指引(Version 1.2020.23)

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

摘要

文档介绍了PlantUML工具，支持绘制多种UML图表（如时序图、类图、用例图等）以及其他类型图表。文档详细说明了PlantUML的语法、预处理功能、变量定义、标准库的使用，特别是与AWS相关的库，并介绍了Salt工具用于绘制图形界面。文档还提供了缩放、页眉页脚设置等基本命令和技巧。

AI总结

《PlantUML 语言参考指引》（Version 1.2020.23）是一份关于使用 PlantUML 绘制 UML 图和其他类型图表的指南。以下是文档的核心内容总结：

### 1. **PlantUML 功能概述**
PlantUML 是一个开源工具，支持通过简单直观的语言快速绘制多种 UML 图，包括：
- 时序图
- 用例图
- 类图
- 活动图
- 组件图
- 状态图
- 对象图
- 部署图
- 定时图

此外，它还支持非 UML 图，如：
- JSON Data
- 线框图形界面
- 架构图
- SDL 图
- Ditaa 图
- 甘特图
- MindMap 图
- Work Breakdown Structure 图
- 数学公式（支持 AsciiMath 或 JLaTeXMath）

---

### 2. **核心功能与使用方法**
#### 2.1 **预处理功能**
- 预处理功能类似于 C 语言的预处理器，使用 `!` 符号。
- **变量定义**：支持全局变量，变量名建议以 `$` 开头，类型包括整型和字符串。

  !$ab = "foo1"
  !$cd = "foo2"
  !$ef = $ab + $cd

#### 2.2 **库的使用与扩展**
- **自定义库**：支持将多个文件打包为 `.zip` 或 `.jar`，通过 `!import` 导入，再使用 `!include` 包含文件。
- **标准库**：
- **AWS 库**：提供 AWS 服务图标和宏，用于绘制包含 AWS 组件的架构图。
- **Amazon Labs 库**：基于 AWS Architecture Icons，支持 C4 模型，用于设计部署和拓扑图。
- **其他库**：包括通用图标和图形界面库。

#### 2.3 **Salt 子项目**
- **用途**：用于设计图形界面。
- **基本元素**：
- 按钮：`[ ]`
- 单选按钮：`( )`
- 复选框：`[√]`
- 文本框：`"Enter text here"`
- **表格**：支持通过 `{ }` 定义表格，使用 `|` 分隔单元格。

#### 2.4 **实用命令**
- **注释**：单行注释使用 `'`，多行注释使用 `/* ... */`。
- **页眉和页脚**：支持在图表中添加标题、注释等，可居中、左对齐或右对齐。
- **缩放**：支持通过 `scale` 命令调整图表大小，可指定比例、宽度或高度。

---

### 3. **示例与实践**
文档提供了多个示例，展示了如何通过 PlantUML 绘制不同类型图表，包括：
- 时序图：定义参与者、消息传递和交互流程。
- 用例图：描述系统功能和用户角色。
- 图形界面设计：使用 Salt 子项目创建按钮、文本框等界面元素。
- 条件和分支：通过 `if` 和 `else` 实现流程控制。

---

### 4. **总结**
PlantUML 是一个功能强大的工具，支持多种图表类型和高级功能（如预处理、自定义库、图形界面设计等），适合用于软件设计、架构图绘制和文档生成。通过简单的语法和丰富的库，用户可以快速创建清晰、专业的图表。