---
title: 代码块高亮
---
# 基于 Prism 的 代码块高亮支持
[Prism]: https://prismjs.com/
ph-Bookshelf 默认基于 [Prism] 支持了代码块高亮,并开放了一些配置可以由你来调整一些代码块的显示样式。
## 使用 Prism 代码高亮
ph-Bookshelf 默认开启了 [Prism] 代码高亮支持,你可以将配置节点 `prism` 设置为 `false` 来关闭高亮支持。
在 Prism 已经开启的情况下,向代码块添加 css 类 `language-xxx` 或是 `lang-xxx` 即可为这个代码块进行高亮着色。
Prism 不会自动为所有代码块着色,所以不指定 `language-xxx` 即不会对代码块高亮。
## 配置高亮/代码块样式
// todo
---
## 你知道吗
ph-Bookshelf 本来是使用的 [highlight.js] 代码高亮库,在写这篇文档的时候,突然就更换为 [Prism] 库了。于是,你文档作者的 *50* 行 *1500* 多字**最终还没暖热乎就一点都没用上了**。
至于那些带着冤魂的文档内容,它就在下面被注释掉的段落里。
[highlight.js]: https://highlightjs.org/
[使用介绍]: https://highlightjs.org/usage/