WordPress 使用 Prism 高亮渲染代码
2018-12-13
杂谈
如果你想在 WordPress 文章里得到更清晰的代码显示效果,Prism.js 是一个比较轻量、上手也快的方案。它的关键不是换编辑器,而是让代码块输出正确的 HTML 结构和语言类名。
我一开始也以为 CSDN 那种代码高亮效果和编辑器有关,甚至还折腾过 Markdown 编辑器。后来查看页面源码才发现,核心其实是 Prism。它是一个轻量级代码高亮库,支持常见语言,适合直接嵌入博客文章。
下面这篇就按实际操作顺序,演示 WordPress 里如何把 Prism 跑起来。
1.安装Prismatic插件
wordpress安装插件很简单,直接在后台插件模块添加新插件搜索Prismatic就可以找到了(我使用的这款,你们也可以看看其他的,适用方法可能不一样),下载激活便是。

其实最容易卡住的是“插件装好了,但代码还是不高亮”。原因通常不是插件没生效,而是代码块写法不对。写文章时需要插入自定义 HTML 块(Custom HTML block),然后使用类似下面的结构:
<pre><code class="language-python">
print("hello world")
</code></pre>
2. 代码部分
其中 python 可以替换成你实际使用的语言名称,例如 bash、javascript、php。只要类名写对,Prism 就会按对应语言高亮。
下面给出一个更完整的例子。比如我要高亮一个 yum update -y 命令,首先:

添加block(块),并且选择custom HTML(自定义html),然后写上如下代码

点击发布之后就可以看到如下的代码高亮效果了:
yum update -y
常见问题
- 插件已经安装但没有高亮:优先检查是不是用了普通段落块,而不是 Custom HTML 块。
- 有代码框但没有语言样式:检查
language-python这一类名是否写对。 - 样式和别的网站不一样:通常是 Prism 主题 CSS 不同,不是 WordPress 编辑器的问题。
这样就已经能在 WordPress 里做出可用的代码高亮效果了。它和 CSDN 看起来不完全一样,主要是 CSS 主题不同,但原理是一样的。如果后续换了更接近 CSDN 的 Prism 样式,再补一篇主题定制文章会更完整。
- 原文作者:春江暮客
- 原文链接:https://www.bobobk.com/115.html
- 版权声明:本作品采用 知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议 进行许可,非商业转载请注明出处(作者,原文链接),商业转载请联系作者获得授权。