nanhaoluo
1d5899ce7e
- 添加多 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
52 lines
1.7 KiB
Markdown
52 lines
1.7 KiB
Markdown
---
|
||
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 需求文档
|
||
```
|