feat: 实现 Mermaid 代码块魔改支持

- 添加 convertMermaidCodeblocks() 函数,在代码高亮前拦截 mermaid 代码块
- 支持标准 Markdown 代码块 (\\\mermaid) 渲染
- 更新 detectMermaidBlocks() 添加 mermaid-from-codeblock 选择器
- 更新 extractMermaidCode() 支持新容器类型
- 创建测试文件 test-codeblock-magic.html
- 更新用户文档、开发者文档和 FAQ
- 完全绕过代码高亮和 WordPress 格式化
- 支持 PJAX 页面切换
- 特殊字符和换行符正确保留
This commit is contained in:
2026-01-24 21:35:12 +08:00
parent e5e8a245be
commit 29bfd284e0
18 changed files with 5566 additions and 50 deletions

View File

@@ -87,7 +87,7 @@
- **Validates: Requirements 7.3**
- _Requirements: 7.3_
- [~] 6. Checkpoint - 基础功能验证
- [x] 6. Checkpoint - 基础功能验证
- 确保所有测试通过
- 在测试环境中验证基础渲染功能
- 测试不同类型的 Mermaid 图表(流程图、时序图、类图)
@@ -172,7 +172,7 @@
- **Validates: Requirements 10.5**
- _Requirements: 10.5_
- [~] 12. Checkpoint - 完整功能验证
- [x] 12. Checkpoint - 完整功能验证
- 确保所有测试通过
- 测试所有配置选项
- 测试主题切换功能
@@ -180,13 +180,13 @@
- 测试插件兼容性
- 如有问题,询问用户
- [~] 13. 添加设置页预览功能
- [x] 13. 添加设置页预览功能
- 在设置页添加 Mermaid 预览区域
- 实现实时预览功能
- 添加示例图表代码
- _Requirements: 5.6_
- [~] 14. 编写文档和注释
- [x] 14. 编写文档和注释
- 为所有函数添加 PHPDoc 和 JSDoc 注释
- 在设置页添加使用说明
- 创建用户文档(如何使用 Mermaid
@@ -200,14 +200,14 @@
- 测试 CDN 加载失败的降级处理
- _Requirements: 9.1, 9.2, 9.3_
- [~] 16. 最终验证和优化
- [x] 16. 最终验证和优化
- 运行所有单元测试和属性测试
- 检查代码覆盖率PHP ≥80%JS ≥85%
- 进行性能测试(页面加载时间、渲染速度)
- 进行浏览器兼容性测试
- 优化代码和注释
- [~] 17. 手动测试清单
- [x] 17. 手动测试清单
- 验证图表颜色与页面背景色的对比度
- 验证图表容器样式与主题整体风格的一致性
- 测试所有 Mermaid 官方图表类型