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

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

摘要

文档是 PlantUML 语言参考指引，涵盖了使用 PlantUML 绘制多种 UML 图表的方法，包括时序图、用例图、类图、活动图等。新活动图语法支持更好的代码维护，并非依赖于 Graphviz。文档还介绍了如何使用 UML2 标记符、数学公式、Skinparam 命令以及如何在图表中集成云端见解。

AI总结

《使用 PlantUML 绘制 UML - PlantUML 语言参考指引(Version 1.2019.6)》摘要如下：

### 文档概述
PlantUML 是一个开源项目，支持通过简单的语言快速绘制 UML 图和其他示意图，包括：
- UML 图：时序图、用例图、类图、活动图、组件图、状态图、对象图、部署图、定时图。
- 非 UML 图：线框图形界面、架构图、SDL、Ditaa 图、甘特图、MindMap、Work Breakdown Structure、AsciiMath 或 JLaTeXMath 数学公式。

### 活动图（新语法）
1. **活动标签**：以冒号开始，以分号结束，支持 Creole Wiki 语法。
示例：

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

2. **开始/结束**：使用 `start` 和 `stop` 或 `end` 表示图示的开始和结束。
示例：

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

3. **注释**：支持浮动注释，使用 `floating` 关键字，文本可包含 HTML 格式。
示例：

   @startuml  
   start :foo1;  
   floating note left: This is a note  
   :foo2;  
   note right This note is on several //lines// and can contain HTML  
   stop  
   @enduml  

4. **颜色**：可为活动指定颜色。
示例：

   @startuml  
   start :starting progress;  
   #HotPink:reading configuration files  
   @enduml  

### 组件图
1. **方向控制**：使用 `left`、`right`、`up`、`down` 或方向单词的首字母（如 `-d-`、`-do-`、`-down-`）更改箭头方向。
示例：

   @startuml  
   [Component] -left-> left [Component]  
   [Component] -right-> right [Component]  
   [Component] -up-> up [Component]  
   [Component] -down-> down [Component]  
   @enduml  

2. **UML2 标记符**：通过 `skinparam componentStyle uml2` 切换到 UML2 标记符。
示例：

   @startuml  
   skinparam componentStyle uml2  
   interface "Data Access" as DA  
   DA - [First Component]  
   [First Component] ..> HTTP : use  
   @enduml  

### 数学公式
支持通过 `AsciiMath` 和 `JLaTeXMath` 插入数学公式。
- `AsciiMath` 转换符号为 LaTeX 表达式。
- `JLaTeXMath` 显示 LaTeX 公式，需手动下载并配置相关 JAR 文件。

示例：

@startlatex  
\sum_{i=0}^{n-1} (a_i + b_i^2)  
@endlatex  

### 设计示例
1. **云洞见库**：使用 Cloudinsight sprites 可以在 PlantUML 中表示流行技术的视觉化图表。
示例：

   !include   
   !include   
   !include   
   !include   
   ...  

2. **分割大文件**：支持通过 `!include` 和 `!import` 将大文件分割为多个小文件，方便管理复杂项目。

### 皮肤参数（Skinparam）
用于自定义图表样式，如颜色、字体、边框等。
示例：

@startuml  
skinparam roundcorner 20  
skinparam class {  
  BackgroundColor PaleGreen  
  ArrowColor SeaGreen  
  BorderColor SpringGreen  
}  
...  
@enduml  

### 总结
本文档详细介绍了 PlantUML 的功能和语法，包括活动图、组件图、数学公式支持等，提供了丰富的示例和配置方法，帮助用户高效绘制各类 UML 图和示意图。