PlantUML 1.2020.22 语言参考指引

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

摘要

PlantUML 是一个开源工具，支持通过简单直观的语法快速绘制多种 UML 图和非 UML 图，包括时序图、用例图、类图、活动图、组件图、状态图、对象图、部署图、甘特图等。文档详细介绍了 PlantUML 的语法、预处理功能、变量定义、皮肤参数（skinparam）的使用，以及如何通过标准库扩展功能，特别是与 AWS 相关的图标和组件库的使用方法。

AI总结

《PlantUML 1.2020.22 语言参考指引》主要介绍了 PlantUML 的功能、语法和使用方法，涵盖以下核心内容：

### 1. **PlantUML 功能概述**
PlantUML 是一个开源工具，支持通过简单直观的文本语言快速绘制多种图表，包括：
- **UML 图**：时序图、用例图、类图、活动图、组件图、状态图、对象图、部署图、定时图。
- **非 UML 图**：JSON Data、线框图、架构图、SDL、Ditaa diagram、甘特图、MindMap diagram、工作分解结构图、数学公式图。

### 2. **语法与功能**
- **时序图**：支持参与者、消息传递、注释、自定义样式（如箭头颜色、形状）、分割图、延迟、文本对齐等。
- **用例图**：支持用例、角色、继承、注释、方向自定义（如从左到右）。
- **类图**：支持类关系、静态与抽象方法、高级类体（如分组）、属性图标大小调整。
- **预处理功能**：类似 C 预处理器，支持变量定义、宏扩展、包含文件（如 `!include`、`!import`）。
- **skinparam 参数**：用于自定义图表样式，如颜色、背景、边框等。

### 3. **高级功能**
- **标准库**：提供丰富的库文件（如 AWS 图标库），支持通过 `!include` 引入。
- **自定义与扩展**：支持通过 `!function` 和 `!procedure` 定义自定义宏，用户可提交 Pull Request 更新或添加新库。
- **图表样式调整**：支持通过 `skinparam` 调整图表外观，如组件背景颜色、节点边框颜色等。

### 4. **使用建议**
- **文档更新**：官方文档可能不总是最新的，可通过命令 `java -jar plantuml.jar -language` 查看所有参数或生成 skinparam 参数图。
- **兼容性**：不建议继续使用历史遗留功能（如 `!define`、`!definelong`），推荐使用 `!function` 和 `!procedure`。
- **性能与扩展**：支持通过 `plantuml.include.path` 设置搜索路径，方便管理自定义库文件。

### 总结
PlantUML 1.2020.22 提供了强大的图表绘制能力，支持多种 UML 和非 UML 图表类型，同时通过预处理功能和自定义样式扩展了灵活性。用户可通过简洁的语法快速生成高质量图表，并结合标准库和自定义库满足多样化需求。