Linux 系统 Flowable 中文字体配置指南

Linux 系统 Flowable 中文字体配置指南

1. 手动安装字体文件

安装步骤

# 创建自定义字体目录
mkdir -p /usr/share/fonts/custom

# 上传中文字体文件（如 simsun.ttc、msyh.ttf 等）到该目录
# 设置文件权限
chmod 644 /usr/share/fonts/custom/*

# 刷新系统字体缓存
fc-cache -fv

2. 验证字体安装

字体检查命令

# 查看所有已安装字体
fc-list

# 筛选中文字体
fc-list :lang=zh

# 检查特定字体是否存在
fc-match "WenQuanYi Micro Hei"
fc-match "Microsoft YaHei" 
fc-match "Arial"
fc-match "宋体"

3. Flowable 字体配置

application.yml 配置

flowable:
  async-executor-enabled: false
  process-definition-cache-limit: -1
  # 字体配置
  activity-font-name: "宋体"
  label-font-name: "宋体" 
  annotation-font-name: "宋体"

4. 配置说明

字体选择优先级

1. 宋体 - 中文兼容性最佳
2. WenQuanYi Micro Hei - 开源中文字体
3. Microsoft YaHei - Windows 系统中文字体
4. Arial - 通用英文字体回退

注意事项

• 确保字体文件具有可读权限
• 字体配置后需要重启 Flowable 应用
• 如使用 Docker 部署，需在镜像构建时安装字体

5. 验证流程

1. 执行字体安装命令
2. 运行字体验证命令确认安装成功
3. 更新 Flowable 配置文件
4. 重启应用服务
5. 测试流程图生成功能

完成以上步骤后，Flowable 流程图中的中文文本应能正常显示。