Files
argon-theme/.kiro/steering/mermaid-removal-summary.md
nanhaoluo 1d5899ce7e feat: 实现 Mermaid 库加载失败的降级处理机制
- 添加多 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
2026-01-23 23:12:05 +08:00

1.7 KiB
Raw Blame History

inclusion
inclusion
manual

Mermaid 功能移除总结

移除原因

WP-Markdown 编辑器在保存 Markdown 文件时,会将 Mermaid 代码块保存为一整行(没有真正的换行符),导致 Mermaid 解析器无法正确解析,持续报错:Parse error on line 1: Expecting 'NEWLINE', 'SPACE', 'GRAPH'

尝试了多种解决方案JavaScript 解码、PHP 预处理、智能格式化等)均失败。

已移除内容

  1. settings.php - 移除 Mermaid 设置项和选项保存逻辑(约 15 行)
  2. functions.php - 移除两个 Mermaid 处理函数(约 70 行)
  3. footer.php - 移除 Mermaid 加载和渲染代码(约 220 行)
  4. style.css - 移除 Mermaid 图表样式(约 25 行)
  5. 本地镜像 - 删除 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 需求文档