Sequence diagrams aren’t just A -> B. The control-flow keywords are what make them useful.
alt / else — branchesThe most common pattern. alt is “if”, else is “else”:
1234567891011121314@s...
时序图不只是 A -> B,控制流关键字才是它真正有用的地方。
alt / else —— 分支最常用。alt 表示 if,else 表示 else:
1234567891011121314@startumltitle 登录返回participant FEparticipant APIFE -> API: POST /loginalt 成功 API --> ...
Default class diagrams are too loud for company docs. Here’s how to tune skinparam for a calmer look.
The default theme problemThe out-of-the-box class theme uses saturated fills and heavy border...
默认主题的 class 图在公司文档里偏花,这篇讲怎么用 skinparam 调成更克制的样式。
默认主题的问题类图默认是彩色填充 + 粗边框。在白底 wiki 里还行,在嵌入 PPT 或暗色页面里就太花。
1234567@startumlclass Animalclass Dogclass CatAnimal <|-- DogAnimal <|-- Cat@enduml
...
A summary of five ways PlantUML gets used inside real engineering teams, plus the gotchas that bite along the way.
1. Use case diagrams for requirement reviewsHalf an hour of whiteboarding in a m...
这篇文章总结把 PlantUML 真正用到团队里时,最常见的 5 个用法和踩坑点。
1. 用例图做需求评审需求会上画 30 分钟白板,不如让大家回去花 30 分钟改一段 PlantUML —— 它能进 PR、可 diff、可评审。
1234567891011121314151617181920@startumlleft to right directionskinparam actorS...
Diagrams in docs sites — the best approach depends on the framework. Here are the actual configs for 4 popular tools.
Why does this need a dedicated post?PlantUML source and rendered output are s...
文档站里放图,最好的方案因框架而异——这里有 4 套主流工具的实际配置。
为什么需要专门讨论这件事?PlantUML 源码 + 渲染结果是分开的。这意味着文档站有三种嵌入方式:
预渲染:构建时生成 SVG 静态文件 → <img> 引入(最快、最稳)
客户端渲染:运行时调 plantuml.com / 自有 server(灵活、慢一点)
边渲染边预生成:混用——平...
Use PlantUML + a few lines of script, so your diagrams always follow reality.
Why data-driven?The most common embarrassment with business diagrams:
A column gets added to the DB; the ER diagram ...
用 PlantUML + 几行脚本,让图自动跟着真实数据走。
为什么要数据驱动?业务图最常见的尴尬:
数据库加了字段,ER 图忘了同步,下游同学开始凭记忆写 join
服务依赖变了,部署图却是三个月前的那张
团队同学关系调整了,架构图还显示离职的人
每周手动重画一遍——但凡少画一次就有人引用错误链接
思路:图的“事实”存在于代码 / 数据库 / API 文档 ...