- 添加多 CDN 备选方案(jsdelivr、unpkg、本地镜像) - 实现递归加载逻辑,主 CDN 失败时自动尝试备用 CDN - 添加 onerror 事件处理,捕获库加载失败 - 所有 CDN 失败时显示友好的错误提示 - 在错误提示中保留原始代码供用户查看 - 添加详细的控制台日志输出 - 创建 PHP 和 HTML 测试文件验证功能 - 暴露 MermaidRenderer 到全局作用域供降级处理使用 Requirements: 1.4, 2.3, 7.1, 7.2, 7.3, 7.4, 7.5
1.7 KiB
1.7 KiB
inclusion
| inclusion |
|---|
| manual |
Mermaid 功能移除总结
移除原因
WP-Markdown 编辑器在保存 Markdown 文件时,会将 Mermaid 代码块保存为一整行(没有真正的换行符),导致 Mermaid 解析器无法正确解析,持续报错:Parse error on line 1: Expecting 'NEWLINE', 'SPACE', 'GRAPH'。
尝试了多种解决方案(JavaScript 解码、PHP 预处理、智能格式化等)均失败。
已移除内容
- settings.php - 移除 Mermaid 设置项和选项保存逻辑(约 15 行)
- functions.php - 移除两个 Mermaid 处理函数(约 70 行)
- footer.php - 移除 Mermaid 加载和渲染代码(约 220 行)
- style.css - 移除 Mermaid 图表样式(约 25 行)
- 本地镜像 - 删除
assets/vendor/external/mermaid/目录
总计移除约 330 行代码和 2 个本地镜像文件。
需求文档
已创建 mermaid-support-requirements.md 文档,包含:
- 问题详细分析
- 已尝试的解决方案
- 推荐的替代方案(使用支持 Mermaid 的插件)
- 技术实现参考
- 测试用例
推荐方案
使用支持 Mermaid 的 WordPress 插件:
- WP Githuber MD - 功能强大的 Markdown 编辑器
- Markdown Block - Gutenberg 原生 Markdown 块
- Code Syntax Block - 支持 Mermaid 的代码块插件
Git 提交
commit 54cbb40
feat: 移除 Mermaid 支持并创建需求文档
- 从 settings.php 移除 Mermaid 设置项和选项保存逻辑
- 从 functions.php 移除 Mermaid 代码块预处理函数
- 从 footer.php 移除 Mermaid 加载和渲染代码
- 从 style.css 移除 Mermaid 图表样式
- 删除本地镜像文件 assets/vendor/external/mermaid/
- 创建 mermaid-support-requirements.md 需求文档