highlight.js 代码高亮

highlight.js 代码高亮

15,698
13,607

提供对 highlight.js 的集成,支持在内容页高亮显示代码块

下载

安装到 Halo

方式一

如果安装了应用市场插件,可以直接在应用市场中搜索highlight.js 代码高亮并安装。

方式二

输入你的 Halo 站点地址,点击安装之后会重定向到你 Halo 后台并自动安装,Halo 的版本需要 >= 2.6.0。

方式三

点击手动下载,然后在 Console 上传。

plugin-highlightjs

主题端的代码块高亮插件,集成了 highlight.js

开发环境

git clone git@github.com:halo-sigs/plugin-highlightjs.git

# 或者当你 fork 之后

git clone git@github.com:{your_github_id}/plugin-highlightjs.git
cd path/to/plugin-highlightjs
# macOS / Linux
./gradlew build

# Windows
./gradlew.bat build

修改 Halo 配置文件:

halo:
  plugin:
    runtime-mode: development
    classes-directories:
      - "build/classes"
      - "build/resources"
    lib-directories:
      - "libs"
    fixedPluginPath:
      - "/path/to/plugin-highlightjs"

使用方式

  1. Releases 下载最新的 JAR 文件。
  2. 在 Halo 后台的插件管理上传 JAR 文件进行安装。

需要注意的是,首次安装之后,需要进入插件设置页面保存一次设置,才能正常使用。

主题适配

此插件无需主题主动适配即可使用,其原理就是将 highlight.js 所需的依赖引入和初始化代码都自动插入到了内容页面上。因此,主题开发者无需再针对代码高亮进行适配开发,如果有特殊的需求,建议共同完善此插件。

安装到 Halo

方式一

如果安装了应用市场插件,可以直接在应用市场中搜索highlight.js 代码高亮并安装。

方式二

输入你的 Halo 站点地址,点击安装之后会重定向到你 Halo 后台并自动安装,Halo 的版本需要 >= 2.6.0。

方式三

点击手动下载,然后在 Console 上传。

这是一个开源应用,我们推荐优先在开源仓库中提交 issue,以便开发者更好地接收和跟进问题。

去提交 issue