PlantUML 1.2021.2 Guía de Referencia del Lenguaje

• 语言: 西班牙语
• 格式: .pdf
• 来源: pdf.plantuml.net

摘要

This document provides a comprehensive reference guide for PlantUML version 1.2021.2, detailing how to create various types of diagrams such as UML diagrams, Gantt charts, sequence diagrams, and more. It explains the syntax for defining tasks, setting start and end times, and using preprocessing features like variables and functions. The guide also covers integration with external libraries and icons for enhanced diagram creation.

AI总结

### PlantUML 1.2021.2《语言参考指南》总结

#### 1. **PlantUML 功能概述**
PlantUML 是一个开源工具，支持通过简单的语言快速绘制多种图表，包括：
- **UML 图表**：类图、对象图、活动图、组件图、部署图、状态图、序列图、用例图。
- **非 UML 图表**：Gantt 图、网络图、架构图（如 Archimate、AWS、Azure、Kubernetes 等）、数据流图、思维导图等。

#### 2. **Gantt 图语法**
Gantt 图通过自然语言描述任务，语法简单直观：
- **任务定义**：使用方括号 `[任务名称]`，任务时长由动词短语描述（如 `lasts 15 days`）。
- **任务开始**：使用 `starts` 动词定义任务开始时间（如 `[Prototype design] starts 2020-07-01`）。
- **任务结束**：使用 `ends` 动词定义任务结束时间。

#### 3. **预处理功能**
PlantUML 提供类似 C 预处理器的功能，支持以下操作：
- **变量定义**：全局变量或局部变量，变量类型包括整数和字符串。
- **函数定义**：支持 `!function` 和 `!procedure` 定义函数。
- **包含文件**：支持 `!include` 和 `!import` 导入外部文件或库。

#### 4. **标准库与扩展**
PlantUML 提供丰富的标准库，支持多种技术领域：
- **内置库**：包括 AWS、Azure、Kubernetes、Elastic、Docker 等技术的图标和组件。
- **自定义库**：支持通过 `!import` 和 `!include` 导入自定义库或第三方库。

#### 5. **案例与示例**
- **Gantt 图示例**：

  @startgantt
  [Prototype design] lasts 15 days
  [Test prototype] lasts 10 days
  @endgantt

- **Gantt 图时间设置示例**：

  @startuml
  Project starts 2020-07-01
  [Prototype design] starts 2020-07-01
  [Test prototype] starts 2020-07-16
  @enduml

#### 6. **注意事项**
- **向后兼容性**：旧的预处理器指令（如 `!define` 和 `!definelong`）已逐步弃用，建议使用新的 `!function` 和 `!procedure`。
- **调试与断言**：支持通过 `!assert` 添加断言，验证图表逻辑。

#### 7. **总结**
PlantUML 提供强大且灵活的图表绘制功能，支持多种技术领域和自定义扩展，适合开发人员、架构师和项目管理者快速生成高质量的可视化图表。