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 部署方式取决于使用规模。这篇是 CLI / Docker / Podman / Kubernetes / sidecar 的取舍,以及安全加固、性能监控、多版本隔离的实战。
三种最常见的部署形态形态 A:CLI 一次性渲染适合 CI、临时任务、个人脚本。
123456docker run --rm \ -v $(pwd)/doc...
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/PNG,但实际项目里要嵌进 PDF、PPT、Word、Notion、企业 wiki。这篇是各种导出格式的转换脚本、踩坑、性能取舍。
三种核心输出格式123456789101112131415161718# 默认 SVGplantuml -tsvg diagram.puml# 输出:diagram.svg — 矢量,适合网页# PNG(位图)...
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 写在 .puml 文件里,跟代码一样会腐烂——语法过期、布局跑偏、架构改了图没改。这篇是三种测试方法把图变成 CI 流水线的一部分。
为什么图也需要测试传统观念:图是文档,文档不需要测试。错。
三个月前画的时序图,接口签名改了图没改 → 评审者按图对接 → 集成失败
自动布局换了主题,组件重叠看不清 → 文档可用性下降
架构从 monolith 拆成微服务,但代码里那...
The team wiki is the biggest consumer of PlantUML diagrams. This is the field guide for getting .puml files rendered into clickable SVG inside Confluence / Jira / Notion, including the s...
团队 wiki 是 PlantUML 图的最大消费场景。这篇是 Confluence / Jira / Notion 三家平台把 .puml 文件变成可点开 SVG 的落地经验,以及自托管 plantuml 服务在企业网络里的坑。
为什么 wiki 集成这么重要PlantUML 的代码可以在 git 里 review,但评审者不会天天开 git。90% 的阅读发生在 ...
PlantUML source + rendered output both live in a git repo. This post distils the end-to-end practice: edit puml → validate → auto-render → commit → CI → PR review → rebase → all smooth.
Two kinds...
PlantUML 图源 + 渲染产物都是 git 仓库的一部分。这一篇整理 end-to-end 实践:改 puml → 校验 → 自动渲 → commit → CI → PR 评审 → rebase → 一切顺。
PlantUML 在 git 仓库的两类「文件」1234567project/├── docs/diagrams/ ← source│ ├── auth.p...