架构图(Mermaid 围栏)
这是什么
和架构图画的是同一种图,区别只在怎么写:这一页用 ```mermaid 围栏,直接写 Mermaid 自己的图源。
什么时候用
- 源文档要发到 GitHub,并且希望在 GitHub 上也能看到图——自有写法在那边显示成一段普通文字
- 已经会 Mermaid,不想再学一套
- 需要自有写法表达不了的细节(下面「坑」那一节写明是哪些)
其余情况用自有写法:字段名固定,写错了当场报错并指到具体那一行。
怎么写
出来是什么样
编译时就画成 SVG 内联进产物,读者那边不下载任何绘图库、也不联网。颜色跟着主题走,可以滚轮缩放、按住拖动、双击复位。
坑
- ID 必须是英文(
service src(disk)[源文档]里的src),方括号里的标签可以写中文 - 括号里是图标名,内置的有
clouddatabasediskserverinternet src:R -- L:engine里的RLTB是从哪条边连出去