• 如何实现代码的高亮功能
    • highlight插件支持的语法
    • 使用prism插件

    如何实现代码的高亮功能

    在GitBook生成的静态文档中,默认的代码样式没有高亮,不够醒目。这是由于在书写md时,没有指定代码语言。指定特定语言后,即可实现高亮:

    1. <p>test</p>

    上述效果的代码如下:

    1. ```html
    2. <p>test</p>
    3. ```

    highlight插件支持的语法

    gitbook-plugin-highlight 使用 highlight.js 作为后台渲染引擎,highlight.js 支持的语言及简写可在官方手册中查看。

    使用prism插件

    系统自带插件的高亮功能并不完善,可使用prism插件增强,该插件需要先禁用highlight插件。

    在配置文件中增加如下信息:

    1. {
    2. "plugins": ["-highlight", "prism", "prism-themes"]
    3. }
    4. "pluginsConfig": {
    5. "prism": {
    6. "css": [
    7. "prismjs/themes/prism-solarizedlight.css"
    8. ]
    9. }
    10. }

    使用prism高亮插件的优点在于,可以使用不同的配色方案,且语法关键词识别度比highlight插件高。prism支持的语言可在其官方网站查询。