PlantUML 1.2023.11 Справочное руководство по языку

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

摘要

Документ представляет собой справочное руководство по языку PlantUML версии 1.2023.11. PlantUML — это проект с открытым кодом для быстрого создания UML-диаграмм: последовательности, прецедентов, классов, объектов, активности, компонентов, развёртывания, состояний и синхронизации. Также поддерживаются не-UML-диаграммы: JSON Data, YAML Data, Network diagram, Wireframe, Archimate, SDL, Ditaa, Gantt, MindMap, Work Breakdown Structure, математические нотации и диаграммы сущность-связь. Документ описывает общие команды: глобальные элементы (комментарии, заметки, управление размером, заголовок и подписи), синтаксис Creole для форматирования текста, списков и ссылок, а также команду управления стилями style. Приводятся примеры создания прецедентов, акторов, объектов и их взаимосвязей, компонентов и интерфейсов, а также диаграмм развёртывания. Описаны возможности импорта пользовательских библиотек через zip/jar архивы, настройка пути поиска и конкатенация аргументов макросов.

AI总结

PlantUML (版本 1.2023.11) 是一个开源项目，能够通过简单直观的文本语言快速创建多种UML图表，包括：序列图、用例图、类图、对象图、活动图、组件图、部署图、状态图和定时图。此外，它还支持非UML图表，如：JSON/YAML数据图、网络图、线框图、ArchiMate图、SDL图、Ditaa图、甘特图、思维导图、工作分解结构(WBS)图、数学公式(AsciiMath/JLaTeXMath)图和实体关系(ER)图。

文档涵盖了所有图表类型的语法，并重点介绍了通用命令，这些命令可分为三大类：
* **全局元素**：包括注释、备注、大小控制、标题和说明。
* **Creole语法**：一种类似Wiki的标记语言，用于格式化文本、创建列表和嵌入超链接。
* **样式管理（style/skinparam）**：用于控制元素的显示样式，如颜色和阴影（例如，使用 `skinparam shadowing false` 关闭阴影）。

文档通过大量示例详细说明了各图表的构建方法，例如：
* **用例图**：用例用括号 `( )` 定义，参与者用 `actor` 或双冒号 `::` 定义。
* **对象图**：用 `object` 关键字定义对象；对象间关系通过特定符号表示（如 `<|--` 表示继承，`*--` 表示组合）。
* **组件图**：组件用方括号 `[ ]` 或 `component` 关键字定义；接口用括号 `( )` 或 `interface` 关键字定义。
* **部署图**：支持多种元素声明，如 `actor`、`component`、`node`、`database`、`cloud` 等。

高级功能包括：
* **预处理与扩展**：支持 `!import` 和 `!include` 指令以包含外部文件或打包的库（`.zip`/`.jar`）。可通过 `!unquoted procedure` 和 `##` 语法实现宏定义与参数拼接。
* **断言**：支持 `!assert` 语句用于验证条件，如 `!assert %strpos("abcdef", "cd")==3`，若失败会抛出错误。