init

vendor/mermaid/README.md

@@ -0,0 +1,30 @@
+# vendor/mermaid
+
+这里放的是 **mermaid 11.15.0** 的浏览器构建，供 `tools/marp-mermaid-engine.mjs` 在构建时
+把 Markdown 里的 ```` ```mermaid ```` 代码块渲染成内联 SVG 用（详见该文件的说明）。
+
+- 文件：`mermaid.min.js`（UMD 单文件构建，自包含，不依赖同目录其它分片）
+- 来源：本机 npm 包 `mermaid@11.15.0` 的 `dist/mermaid.min.js`
+  （具体是从 `~/.local/src/llama.cpp/tools/ui/node_modules/mermaid/dist/` 复制过来的）
+- 许可：MIT，原许可证见同目录 `LICENSE`
+- 大小：约 3.2 MB
+
+## 为什么单独复制一份
+
+原来插件直接引用了 llama.cpp 那份 node_modules 里的路径。复制到这里之后，这个 deck
+就是自包含的：换机器、删掉 llama.cpp 都不影响构建。
+
+## 想升级 mermaid
+
+从任意来源拿到新版本的 `dist/mermaid.min.js`，覆盖这个文件即可：
+
+```bash
+npm pack mermaid@<version>          # 或 npm i mermaid@<version> 后从 node_modules 取
+cp mermaid/dist/mermaid.min.js vendor/mermaid/mermaid.min.js
+```
+
+如果用别处的文件，也可以不改本目录，改用环境变量指定：
+
+```bash
+MARP_MERMAID_DIR=/path/to/mermaid/dist marp example.marp.md -o pre.html
+```