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 需求文档
|
|||
|
|
```
|