PlantUML 1.2019.2 语言参考指引

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

摘要

《PlantUML 1.2019.2 语言参考指引》文档介绍了PlantUML语言的功能和语法，支持绘制多种UML图（如时序图、类图、活动图等）以及非UML图（如线框图、架构图、甘特图等）。文档还详细说明了新旧语法的差异、语法的使用方法、图表美化技巧以及与Graphviz的关系。此外，文档提到了对数学公式的支持，介绍了AsciiMath和JLaTeXMath的使用方式。

AI总结

### PlantUML 1.2019.2 语言参考指引总结

#### 1. 概述
PlantUML 是一个开源项目，支持通过简单直观的语言快速绘制多种 UML 图和非 UML 图，包括：
- **UML 图**：时序图、用例图、类图、活动图、组件图、状态图、对象图、部署图、定时图。
- **非 UML 图**：线框图形界面、架构图、SDL 图、Ditaa 图、甘特图、数学公式（支持 AsciiMath 和 JLaTeXMath）。

#### 2. 时序图
- **参与者声明**：使用 `concise` 或 `robust` 关键字声明参与者，通过 `@` 标注和 `is` 动词定义状态。

  @startuml robust
  "Web 浏览器" as WB
  concise "Web 用户" as WU
  @enduml

- **消息增加**：使用语法描述消息交互。

  @startuml robust
  @0 WU is 空闲
  WB is 空闲
  @100 WU -> WB : URL
  @300 WB is 等待中
  @enduml

#### 3. 活动图
- **新语法**：从 V7947 开始支持新语法，不再依赖 Graphviz，代码更易维护。
- **基本语法**：

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

- **开始/结束**：

  @startuml
  start
  :Hello world;
  stop
  @enduml

#### 4. 类图
- **高级类体**：支持自定义分隔符（`--`、`..`、`==`、`__`）和标题来重排方法和属性。

  class Foo1 {
    You can use several lines .. as you want
    group == things together.
  }

- **属性声明**：支持冒号或大括号批量声明属性。

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

#### 5. 组件图
- **UML2 标记符**：使用 `skinparam componentStyle uml2` 切换到 UML2 标记符。

  interface "Data Access" as DA
  DA - [First Component]

- **方向控制**：支持 `left`、`right`、`up`、`down` 等方向关键字。

  [Component] -left-> left

#### 6. 数学公式
- 支持 AsciiMath 和 JLaTeXMath。
- AsciiMath 示例：

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

#### 7. 其他扩展
- **图标和符号**：支持 Material Icons、Office 图标、ArchiMate 等扩展。
- **独立公式**：通过 `@startlatex` 和 `@endlatex` 创建独立的 JLaTeXMath 公式。

#### 8. 总结
PlantUML 提供了丰富且灵活的功能，支持多种图表类型和自定义选项，适用于软件设计、文档编写和教学等多种场景。用户可以根据需求选择合适的语法和工具，快速生成高质量的图形。