写 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 2.0.2

使用时只需要把 PrettifySkipMermaid 这个文件夹上传到 typecho 的 usr/plugins/,文件夹名称保持不变。

然后在后台禁用原来的 GoogleCodePrettify,启用 PrettifySkipMermaid,重新选一下代码配色。

两个版本不要同时启用,否则原插件还是会处理 mermaid 的代码块。MarkdownParse 继续保留,图表仍然由它加载和渲染。

本地已经确认插件可以启用、保存设置。跳过 mermaid 后,原来的图表可以正常渲染,普通代码的高亮和行号也还在。

标签: typecho, plugin

添加新评论