-
PlantUML preprocessing deep-dive: Jinja/JSON/YAML injection and dynamic generation
!include is basic preprocessing. But enterprise architecture diagrams often need to pull service lists, port numbers, AWS resource IDs from external data sources. This is the field guide for Jinja... -
PlantUML 预处理进阶:Jinja/JSON/YAML 注入与动态生成
PlantUML 的 !include 是基础预处理。但企业级架构图常常需要从外部数据源读 service 列表、读端口号、读 AWS 资源 ID 生成图。这篇是 Jinja/JSON/YAML 动态生成实战。 为什么需要动态生成硬编码 .puml 的痛: 123456789101112@startumlcomponent "user-service&quo... -
PlantUML CJK / Emoji / special-character rendering foot-guns and font setup
PlantUML’s default font DejaVu Sans only ships Latin glyphs. Chinese / Japanese / Korean / Emoji either render as boxes or vanish entirely. This is the font configuration field guid... -
PlantUML 中文/日文/Emoji 渲染踩坑与字体配置
PlantUML 默认字体 DejaVu Sans 只含拉丁字符。中文 / 日文 / 韩文 / Emoji 渲染要么是方块要么是缺失。这篇是字体配置实战 + CI 环境搭建 + 多语言混排。 三个常见症状症状 1:中文渲染成 □□□1234@startumlskinparam defaultFontName "DejaVu Sans"Al... -
PlantUML in containers: Docker / Podman / multi-version isolation
PlantUML deployment shape depends on usage scale. This is the trade-off between CLI, Docker, Podman, Kubernetes sidecar, plus security hardening, performance monitoring, and multi-version isolatio... -
PlantUML 容器化部署:Docker / Podman / 多版本隔离
PlantUML 部署方式取决于使用规模。这篇是 CLI / Docker / Podman / Kubernetes / sidecar 的取舍,以及安全加固、性能监控、多版本隔离的实战。 三种最常见的部署形态形态 A:CLI 一次性渲染适合 CI、临时任务、个人脚本。 123456docker run --rm \ -v $(pwd)/doc... -
PlantUML export post-processing: SVG to PDF / PPT / Markdown embedding
PlantUML outputs SVG by default, but real projects need to embed diagrams in PDF, PPT, Word, Notion, and enterprise wikis. This is the post-processing script collection, foot-guns, and performance... -
PlantUML 导出后处理:从 SVG 到 PDF/PPT/Markdown 嵌入
PlantUML 默认只输出 SVG/PNG,但实际项目里要嵌进 PDF、PPT、Word、Notion、企业 wiki。这篇是各种导出格式的转换脚本、踩坑、性能取舍。 三种核心输出格式123456789101112131415161718# 默认 SVGplantuml -tsvg diagram.puml# 输出:diagram.svg — 矢量,适合网页# PNG(位图)... -
Keeping PlantUML diagrams from rotting with unit tests
PlantUML lives in .puml files and rots like code does — broken syntax, layout drift, diagrams out of sync with the architecture. This is the three-test approach that makes diagrams a first-class C... -
用单元测试守住 PlantUML 图不腐烂
PlantUML 写在 .puml 文件里,跟代码一样会腐烂——语法过期、布局跑偏、架构改了图没改。这篇是三种测试方法把图变成 CI 流水线的一部分。 为什么图也需要测试传统观念:图是文档,文档不需要测试。错。 三个月前画的时序图,接口签名改了图没改 → 评审者按图对接 → 集成失败 自动布局换了主题,组件重叠看不清 → 文档可用性下降 架构从 monolith 拆成微服务,但代码里那...