使用VSCode完成图表绘制-PlantUML使用介绍

在与开发同学交流中,发现了一款绘制图表的轻量级工具- PlantUML,通过简单易学的标记语言,可以快速实现多种类型图表的绘制。此外,借助这个工具编辑的各类型图表,还可以轻松融入 Markdown,为产品工作带来非常大的便利。

深感与 PlantUML 相见恨晚,遂产生了在产品团队内部推广的想法,并编写此文档,作为产品同学学习 PlantUML 的入门资料。通过几小时的学习,四位产品小伙伴(无开发基础)已能上手使用。

准备工作

关于 PlantUML

PlantUML 定义了一套快速绘图的语言规则,基于 Java 环境完成最终的图表绘制,支持导出各种格式的位图及 SVG 矢量图。是 UML 图及其他逻辑图表的高效制作工具。 查看 https://plantuml.com/zh/ 获取PlantUML的详细语法及功能介绍。

PlantUML 图表类型及语法大全


安装 VSCode

VSCode 是一款由 MicroSoft 开发的文本编辑工具,推荐作为学习 PlantUML 的编辑工具。

VSCode下载地址 https://code.visualstudio.com/


安装 VSCode 插件

安装并打开 VScode,之后通过软件侧边栏按钮进入“插件商店”,搜索安装 PlantUML 插件。 plug-in


关于 Java

Java 是运行 PlantUML 的必需条件, 请在您的电脑中安装 Java 环境

Mac 版 Java 安装包 https://java.com/zh-CN/download/help/mac_install.html


开始使用

创建文件

打开 VSCode,新建文件,之后立即进行保存操作,文件名需要以 .puml 结尾。 new_file


编写语法

在新建的 “*.puml” 文件中,编写合适的语句内容。 code


预览图表

在编辑过程中,随时可以通过组合键 “Option+D” 进行图表预览。 graph


导出图表

编辑完成后,通过组合键 “command+shift+P”,调出 VSCode 命令行。 在命令行中模糊输入“uml”,并选择“PlantUML: 导出光标位置图表”。 shell 之后立即选择所需要的图表格式,通常我们总会使用 “png” 格式。 export

待程序执行成功后,就可以在此源文件(“.puml”文件)的根目录处,得到对应的图表。


在线编辑器

若对 VSCode 操作不熟悉,也可以通过在线工具进行编辑和预览。

http://www.plantuml.com/plantuml/uml/SyfFKj2rKt3CoKnELR1Io4ZDoSa70000



欢迎与 @大钳子 交流关于 plantuml 的使用方法

2020-10-19

in Rockontrol