PlantUML 1.2023.11 Sprachreferenz

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

摘要

文档主要介绍了PlantUML 1.2023.11版本的语言参考，包括主题的使用、预处理器指令的更新、多种图表类型的绘制方法以及示例代码。文档详细说明了如何通过文本描述生成UML图和其他类型的图表，并提供了相关的语法和使用示例。

AI总结

### 总结

#### 1. 主题更换指令
- 使用 `!theme` 指令可以更改图表的主题，默认主题为 `spacelab`。

#### 2. 迁移注意事项
- **弃用指令**：不再支持 `!define` 和 `!definelong`，建议使用 `!function`、`!procedure` 或变量定义。
- `!define` 替换为 `return !function`
- `!definelong` 替换为 `!procedure`
- **新功能**：
- `!include` 支持多次包含和 URL，不再需要 `!include_many` 和 `!includeurl`。
- 部分功能（如 `%date%`）已替换为内置函数（如 `%date()`）。
- 调用无参数的旧 `!definelong` 宏时需使用括号，例如 `my_own_definelong()`。

#### 3. 新增功能 - `%splitstr` 函数
- 示例：

  !$list = %splitstr("abc~def~ghi", "~")
  !foreach $item in $list
    **$item**
  !endfor

#### 4. 支持的图类型
- **UML 图**：
- 序列图、用例图、类图、对象图、活动图、组件图、分布图、状态图、时序图。
- **其他图**：
- JSON、YAML 数据图、网络图、界面图、Archimate 图、SDL 图、Ditaa 图、甘特图、心智图、工作分解结构图、数学公式图、实体关系图。

#### 5. 标准库扩展
- **C4 库**：
- 提供容器、系统、外部系统等元素，支持关系定义。
- 示例：

    !include 
    Person(personAlias, "Label", "Optional Description")
    Container(containerAlias, "Label", "Technology", "Optional Description")

- **Cloud Insight 图标库**：
- 提供基于 Cloudinsight 图标的sprites，用于丰富图表视觉效果。
- 示例：

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

- **Logos 库**：
- 提供 Gil Barbara 的图标sprites，用于图表中的视觉辅助。
- 示例：

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

#### 6. 活动图样式
- 默认样式：`inside`。
- 示例：

  skinparam conditionStyle inside
  start
  :act1;
  :act2;
  repeatwhile (end)
  :act3;

#### 7. 附录示例
- **标题、页眉、页脚、注释、图例、主框架**：
- 示例：

    header some header
    footer some footer
    title My title
    caption This is caption
    legend {+ Login | "MyName " Password | "**** " [Cancel] | [ OK ] }

- **工作分解结构（WBS）示例**：

  @startwbs
  mainframe This is a **mainframe**
  header some header
  footer some footer
  title My title
  caption This is caption
  legend {+ Login | "MyName " Password | "**** " [Cancel] | [ OK ] }
  @endwbs

- **主框架示例**：

  @startuml
  mainframe This is a **mainframe**
  header some header
  footer some footer
  title My title
  caption This is caption
  legend The legend
  end legend
  @enduml

#### 8. 其他新增功能
- 时间图和活动图示例已更新，支持更多样式和功能。

### 核心观点
- **新功能**：新增 `%splitstr` 函数，优化 `!include` 和主题功能。
- **迁移**：弃用部分旧指令，推荐使用新指令和功能。
- **扩展**：支持更多图类型和标准库扩展（C4、Cloud Insight、Logos）。
- **样式**：新增活动图样式和时间图功能。