PlantUML 1.2019.4 Guía de Referencia del Lenguaje

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

摘要

PlantUML es un proyecto Open Source que permite crear diagramas de多种类型, incluyendo diagramas de secuencia, casos de uso, clases, actividades, componentes, estados, objetos, despliegue y otros formatos no-UML como SDL y Gantt. El documento detalla cómo definir estos diagramas mediante un lenguaje simple e intuitivo, incluyendo funcionalidades de preprocesamiento, soporte para Unicode, integración de Creole para estilos de texto, y la capacidad de incluir archivos externos. También se describe la biblioteca estándar de PlantUML, que incluye iconos y macros para AWS, Azure y otros proveedores.

AI总结

### PlantUML 1.2019.4 语言参考指南总结

#### 概述
PlantUML 是一个开源工具，支持通过简单直观的语言快速创建多种图表，包括 UML 图（如类图、用例图、序列图、活动图等）和非 UML 图（如甘特图、思维导图等）。其语法简洁，支持多种自定义功能和扩展库。

---

#### 主要功能
1. **UML 图表类型**：
- **类图**：展示类之间的关系（继承、关联、依赖等），支持方法、属性、可见性等定义。
- **用例图**：描述用户与系统之间的交互，支持参与者和用例的定义。
- **序列图**：展示对象间消息传递的时间顺序，支持参与者、消息、激活和销毁操作。
- **活动图**：描述流程和活动的控制流。
- **组件图**：展示系统中组件及其交互。
- **状态图**：描述对象在其生命周期中的不同状态。
- **部署图**：展示系统中物理节点及其部署的组件。

2. **非 UML 图表类型**：
- **甘特图**：展示任务计划和时间安排。
- **思维导图**：用于组织和展示主题及其子主题。
- **SDL 图**：支持规格与描述语言（Specification and Description Language）。
- **Ditaa 图**：用于创建简单的 ASCII 艺术图。

---

#### 高级功能
1. **文件包含与预处理**：
- 使用 `!include` 和 `!includeurl` 指令包含外部文件，支持按块选择内容。
- 支持常量定义（`!define`），类似于 C 预处理器。

2. **Unicode 支持**：
- 支持多种语言的字符，适用于非英文环境。

3. **Creole 语法**：
- 支持文本样式（如加粗、斜体、下划线）和列表，兼容 HTML。

4. **标题与页脚**：
- 支持在图表中添加标题、页脚，并可指定居中、左对齐或右对齐。

5. **缩放与导出**：
- 支持通过 `scale` 命令调整图表大小，可指定宽度、高度或比例。

---

#### 扩展库
1. **标准库**：
- 提供多种扩展库（如 AWS、Azure、C4、Material Design 等），支持图标和宏的使用。
- 用户可通过 `!include` 指令加载特定库文件。

2. **示例**：
- **AWS 库**：用于创建与 Amazon S3 相关的图表。
- **Azure 库**：用于创建与 Microsoft Azure 相关的图表。
- **C4 库**：支持 C4 模型（Context, Control, Container, Code）。

---

#### 示例与应用
1. **类图示例**：

   @startuml
   class A {
     +int size()
     +void clear()
   }
   class B {
     +int getName()
   }
   A --> B : use
  @enduml

2. **用例图示例**：

   @startuml
   actor 用户
   usecase 登录系统
   用户 --> 登录系统 : 提供凭据
   登录系统 --> 用户 : 返回令牌
  @enduml

3. **序列图示例**：

   @startuml
   participant 使用者
   participant A
   participant B
   使用者 -> A: 请求
   activate A
   A -> B: 处理
   activate B
   B -> 使用者: 响应
   deactivate B
   deactivate A
  @enduml

---

#### 使用技巧
1. **注释**：
- 单行注释：`' 这是注释`
- 多行注释：`/* 这是注释 */`

2. **标题与页脚**：

   @startuml
   Alice -> Bob: 请求
   header 注意： 仅供演示
   endheader
   footer 生成时间：@now
   endfooter
  @enduml

3. **缩放**：

   @startuml
   scale 0.8
  @enduml

---

#### 其他信息
1. **标准库管理**：
- 使用命令行工具 `plantuml.jar` 可以列出标准库、提取源代码或更新库。

2. **版本信息**：
- 当前版本：1.2019.4
- 更新时间：2019 年 4 月

3. **社区贡献**：
- 用户可通过 GitHub 提交 Pull Request 更新或添加标准库。

---

PlantUML 提供了强大的图表创建能力，适用于软件开发、系统设计、项目管理等多种场景，是一个高效且灵活的工具。