hexo-highlighter-shiki/README_zh-CN.md
2024-10-19 17:47:59 +08:00

1.5 KiB
Raw Blame History

Hexo-Highlight-Shiki

English丨简体中文

一个使用 Shiki 作为代码块高亮器的 Hexo 插件。

需要 Hexo v7.0.0+。

功能

  • 使用 Shiki 渲染代码块,类似于 Hexo 默认的高亮器。
  • 支持双主题或更多主题。
  • 支持自定义语言。

安装与配置

首先,安装本插件:

npm install hexo-highlight-shiki --save

然后在 config.yml 中切换代码高亮引擎:

syntax_highlighter: shiki

最后配置 shiki

shiki:
  theme: one-dark-pro

配置项

完整配置如下:

shiki:
  theme: "one-dark-pro" # Theme, see https://shiki.style/themes for supported themes.
  line_number: false
  strip_indent: true
  tab_replace: "  "
  additional:
    langs: # List of the TextMate grammar json of languages to be added.
      - path/to/lang_grammar.json
    lang_alias: # List of the alias of languages.
      your_alias1: lang_name1
      your_alias2: lang_name2

额外地,你可以在 theme 选项中指定多个主题:

shiki:
  theme:
    light: one-light
    dark: one-dark-pro
    # ...

Dual Themes 中查看如何切换多个主题。

感谢

本插件基于

进行开发。