typecho 中 mermaid 报错与代码高亮插件冲突
写 Docker 和 WSL 那篇文章时,用 mermaid 画了一个简单的关系图。本地显示正常,放到 typecho 上就报错。
Syntax error in text
mermaid version 10.7.0
我这里同时用了 MarkdownParse 和 GoogleCodePrettify。后面发现是代码高亮插件处理了 mermaid 的代码块,导致图表渲染失败。
原因:
MarkdownParse 生成的 HTML 类似这样,mermaid 的标记在里面的 code 标签上。
<pre><code class="mermaid">flowchart TB
A[Windows] --> B[WSL]
</code></pre>
GoogleCodePrettify 会遍历页面上所有的 pre,给它们加上代码高亮和行号。
var pre = document.getElementsByTagName('pre');
for (i = 0, l = pre.length; i < l; i++) {
pre[i].className += " prettyprint linenums";
}
prettyPrint();
这里没有区分普通代码和图表源码。加行号时,一整块 mermaid 代码被拆开,原来完整的图表源码变成了多段。Mermaid 再去解析就会报语法错误。
所以只修改图表里的文字、换行或者加分号,解决不了这个问题。
修改方法:
让 GoogleCodePrettify 跳过 mermaid 的代码块,其他代码继续高亮。
判断的时候要同时检查 pre 本身和里面的元素,因为这里的 mermaid 类名是在 code 上的。只判断 pre.className 会漏掉。
遍历部分改成:
var pre = document.getElementsByTagName('pre');
var mermaidSelector = '.mermaid, .language-mermaid, .lang-mermaid';
for (var i = 0; i < pre.length; i++) {
var block = pre[i];
if (block.matches(mermaidSelector) || block.querySelector(mermaidSelector)) {
block.classList.remove('prettyprint', 'linenums');
continue;
}
block.classList.add('prettyprint', 'linenums');
}
prettyPrint();
另外把原来的 window.onload = ... 改成了 window.addEventListener('load', ...),这样不会覆盖页面里已有的加载事件。
原插件的代码在 typecho-fans/plugins,作者是公子。我 fork 了一份,把修改版单独放到了 PrettifySkipMermaid 目录。
修改后的仓库:heky12356/plugins
插件目录:PrettifySkipMermaid
使用时只需要把 PrettifySkipMermaid 这个文件夹上传到 typecho 的 usr/plugins/,文件夹名称保持不变。
然后在后台禁用原来的 GoogleCodePrettify,启用 PrettifySkipMermaid,重新选一下代码配色。
两个版本不要同时启用,否则原插件还是会处理 mermaid 的代码块。MarkdownParse 继续保留,图表仍然由它加载和渲染。
本地已经确认插件可以启用、保存设置。跳过 mermaid 后,原来的图表可以正常渲染,普通代码的高亮和行号也还在。