PlantUML 1.2019.9 Guide de référence du langage

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

摘要

Ce document est un guide de référence pour l'utilisation de PlantUML, un outil permettant de dessiner rapidement divers types de diagrammes UML tels que les diagrammes de séquence, de cas d'utilisation, de classes, d'activité, de composant, d'état, d'objet et de déploiement. Il décrit également d'autres diagrammes comme les maquettes d'interface graphique, les diagrammes Archimate, les diagrammes Gantt, les MindMap et les structures de décomposition. Le document aborde les fonctionnalités de préprocesseur, les variables, les macros et les bibliothèques standard incluant AWS, Azure et ArchiMate. Il explique comment inclure des fichiers, utiliser des bibliothèques personnalisées et configurer le chemin d'inclusion. Le support de Unicode et les fonctionnalités de zoom sont également mentionnés.

AI总结

《PlantUML 1.2019.9 语言参考指南》是一份关于 PlantUML 工具的文档，主要介绍了如何使用该工具绘制各种类型的图表以及相关的高级功能。以下是文档的核心内容总结：

---

### 1. **PlantUML 的主要功能**
PlantUML 是一个用于快速绘制多种图表的工具，支持以下类型的 UML 图表：
- **UML 图表**：类图、序列图、用例图、活动图、构件图、状态图、对象图、部署图。
- **其他图表**：界面 mockup、Archimate 图、SDL 图、Ditaa 图、甘特图、思维导图、工作分解结构图、数学公式图（支持 AsciiMath 或 JLaTeXMath）。

---

### 2. **预处理功能**
PlantUML 提供了类似于 C 语言预处理器的功能，主要特点包括：
- 使用 `!` 替代 `#` 作为预处理指令的特殊字符。
- **迁移注意事项**：
- 建议不再使用 `!define` 和 `!definelong`，改用 `!function` 和变量定义。
- `!include` 支持多文件包含和 URL，替代了旧的 `!include_many` 和 `!includeurl`。
- 部分旧功能（如 `%date%`）已替换为内置函数。
- **变量定义**：
- 建议变量名以 `$` 开头。
- 变量可以是整数或字符串（需用单引号或双引号括起来）。
- 全局变量可以在函数外定义，供全局访问。

---

### 3. **标准库**
PlantUML 提供了官方标准库，支持以下功能：
- **AWS 库**：包含 Amazon AWS 的图标，支持两种大小的sprite。
- 示例：`!include ` 和 `!include `。
- **Azure 库**：包含 Microsoft Azure 的图标。
- 示例：`!include `。
- **ArchiMate 库**：支持 Archimate 标准的图表绘制。
- 示例：`!includeurl https://raw.github.com/ebbypeter/Archimate-PlantUML/master/Archimate.puml`。

---

### 4. **Unicode 支持**
PlantUML 支持使用 Unicode 字符（包括中文）定义参与者、用例和其他元素，例如：

actor 使用者
participant "頭等艙" as A
participant "第二類" as B

---

### 5. **其他功能**
- **注释**：使用单引号 `’` 或 `/* */` 定义注释。
- **页眉和页脚**：支持在图表中添加页眉和页脚，可指定居中、左对齐或右对齐。
- **缩放**：支持通过 `scale` 命令调整图表大小，例如 `scale 1.5` 或 `scale 200*100`。
- **Salt 模块**：用于创建简单的图形界面。
- 示例：`salt { Login | "MyName" Password | "*****" [Cancel] | [OK] }`。

---

### 6. **高级功能**
- **自定义库**：支持将多个文件打包为 `.zip` 或 `.jar`，并通过 `!import` 指令导入。
- **搜索路径**：通过 `plantuml.include.path` 属性指定包含文件的搜索路径。
- **参数连接**：支持通过 `##` 向宏参数中追加文本。

---

### 7. **示例**
以下是一个简单的 UML 类图示例：

class Example {
  String name;
}

---

总结来看，PlantUML 是一个功能强大且灵活的工具，支持多种图表类型和高级功能，适用于软件开发、系统设计和文档编写等场景。