PlantUML 1.2021.3 Sprachreferenz

• 语言: 德语
• 格式: .pdf
• 来源: pdf.plantuml.net

摘要

文档主要介绍了PlantUML语言的语法参考，包括断言的使用、自定义库的构建、变量定义方法，以及与多种技术栈（如AWS、Azure、Kubernetes）的集成。此外，还提到了对Creole标记语言的支持，用于在图表中格式化文本。

AI总结

### PlantUML 1.2021.3 语法参考总结

#### 1. 断言
- **功能**：可以在图表中添加断言，用于验证条件。
- **示例**：

  Alice -> Bob: Hello
  !assert %strpos("abcdef", "cd") == 3 : "This always fails"

- **作用**：用于调试和验证。

#### 2. 自定义库构建
- **方法**：将多个文件打包为 `.zip` 或 `.jar`，然后使用 `!import` 导入到图表中，再通过 `!include` 包含文件。
- **示例**：

  !import /path/to/customLibrary.zip
  !include myFolder/myFile.iuml

#### 3. 变量定义
- **类型**：整数（`int`）和字符串（`str`，需加引号）。
- **作用域**：全局变量可从任何地方访问，推荐使用 `$` 作为变量名前缀。
- **示例**：

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

#### 4. 标准库
- **功能**：提供多种图标和功能库，如 AWS、Azure、Kubernetes 等。
- **使用方式**：
- 引入标准库：`!include `
- 示例：

    !include 
    !include 

#### 5. 预处理
- **功能**：类似于 C 预处理器，使用 `!` 替代 `#`。
- **迁移注意事项**：
- 替换旧功能：`!define` 替换为 `!function`，`!definelong` 替换为 `!procedure`。
- `!include` 支持 URL 和多次包含。

#### 6. C4 模型
- **功能**：用于创建上下文、容器、组件和交互图。
- **示例**：

  @startuml
  title C4 Model Example
  Person(person1, "User", "Optional Description")
  Container(webserver, "Web Server", "Optional Technology")
  ...
  @enduml

#### 7. 日志
- **功能**：通过 `!dump_memory` 和 `!log` 进行调试。

#### 8. 云洞察
- **功能**：提供 CloudInsight 图标，用于表示流行技术。
- **示例**：

  !include 
  rectangle "<$tomcat>\nwebapp" as webapp

#### 9. Azure 库
- **功能**：提供 Azure 服务图标。
- **使用方式**：

  !include 
  !include 

#### 10. Kubernetes 库
- **功能**：提供 Kubernetes 相关图标。
- **示例**：

  !include 

#### 11. Docker 库
- **功能**：提供 Docker 相关图标。
- **示例**：

  !include 

#### 12. 亚马逊网络
- **功能**：提供 AWS 组件图标，支持 C4 模型结合使用。

#### 13. 工作分解结构
- **功能**：用于创建 WBS 图。

#### 14. 数学表达式
- **支持**：AsciiMath 和 JLaTeXMath 格式。

#### 15. 实体关系图
- **功能**：用于创建 ER 图。

#### 16. Creole 标记语言
- **功能**：支持在图表中使用 Creole 格式的文本样式。
- **示例**：

  note left
  * 这是 **粗体**
  * 这是 //斜体//
  end note

#### 17. 甘特图
- **功能**：支持创建甘特图。

#### 18. 思维导图
- **功能**：支持创建 MindMap 图。

#### 19. SDL
- **功能**：支持 Specification and Description Language。

#### 20. Ditaa 图
- **功能**：支持 Ditaa 格式的 ASCII 艺术图。

#### 21. Archimate 图
- **功能**：支持 Archimate 标准的架构图。

#### 22. 网络图
- **功能**：支持 NWG 格式的网络图。

#### 23. JSON/YAML 数据图
- **功能**：支持 JSON 和 YAML 格式的数据可视化。

#### 24. 指标
- **功能**：支持自定义度量单位和文本对齐。

#### 25. 用例图
- **功能**：支持用例建模。

#### 26. 活动图
- **功能**：支持活动建模。

#### 27. 对象图
- **功能**：支持对象建模。

#### 28. 组件图
- **功能**：支持组件建模。

---

### 总结
PlantUML 是一个功能强大的工具，支持多种类型的图表创建，包括 UML、网络图、甘特图、思维导图等。其语法灵活，支持变量定义、断言、预处理和多种标准库扩展，适用于软件开发、架构设计和文档生成等多种场景。