jhipster/jdl-studio

JDL-Studio Docker镜像文档

镜像概述

JDL-Studio是一款在线工具，专为JHipster应用绘制基于JDL（JHipster领域语言）语法的UML图而设计。其语法在视觉上与生成的UML图高度一致，无需依赖ASCII绘图。官方Docker镜像提供离线使用能力，镜像地址：https://hub.docker.com/r/jhipster/jdl-studio/%E3%80%82

核心功能与特性

• 离线可用：通过Docker容器实现本地离线运行，摆脱网络依赖
• 实时预览：集成简单编辑器与实时预览面板，编辑内容即时可视化
• 本地存储：所有更改自动保存至浏览器localStorage，下次访问可恢复（不保证永久保存）
• 画布交互：支持画布平移（拖动）和缩放（滚动），操作区域为画布右侧三分之一区域
• 样式自定义：通过指令配置调整图表样式，包括箭头大小、方向、字体等参数

使用场景

适用于JHipster开发者在离线环境下编辑JDL语法、设计数据模型并生成UML图的场景，尤其适合网络受限或本地开发环境。

使用方法

Docker部署

基本运行命令

bash
docker run --rm -it -p 18080:80 jhipster/jdl-studio

访问方式

容器启动后，通过以下地址访问JDL-Studio：

• 本地环境：http://localhost:***
• Docker主机：http://:***

Web应用使用

交互操作

• 画布控制：在画布右侧三分之一区域拖动实现平移，滚动鼠标实现缩放
• 文件命名：通过#title指令设置下载图片的文件名

JDL语法

JDL语法详细说明请参考官方文档：JHipster JDL语法

配置指令

支持以下指令自定义图表样式：

#arrowSize: 1          // 箭头大小
#bendSize: 0.3         // 弯曲大小
#direction: down | right // 图表方向（向下或向右）
#gutter: 5             // 边距大小
#edgeMargin: 0         // 边缘间距
#edges: hard | rounded // 边缘样式（直角或圆角）
#fill: #eee8d5; #fdf6e3 // 填充颜色
#fillArrows: false     // 是否填充箭头
#font: Calibri         // 字体
#fontSize: 12          // 字体大小
#leading: 1.25         // 行高
#lineWidth: 3          // 线条宽度
#padding: 8            // 内边距
#spacing: 40           // 元素间距
#stroke: #33322E       // 描边颜色
#title: filename       // 标题（下载文件名）
#zoom: 1               // 缩放比例

依赖项目

JDL-Studio的实现依赖以下开源项目：

• https://github.com/skanaar/nomnoml
• https://github.com/cpettitt/dagre
• lodash
• Jquery
• codemirror
• solarized
• Linearicons

贡献指南

如需参与项目贡献，请参考CONTRIBUTING.md文档。