计软杂谈hexo

hexo-theme-reimu 的开发日志，记录了每一次更新的内容

如果你有任何问题或建议，欢迎提交 Issues

1.10.3

2025-10-26

修复

  • 修复 pjax 模式下 valine 评论系统多次加载的问题

特性

  • 优化样式
    • 优化多语言下拉，分享卡片和赞助的动画效果
    • 移除侧边栏的 hover 放大效果
    • 优化移动端下归档页的样式
    • 优化移动端下的置顶按钮样式，现在移动端下将始终展示向上箭头图标
  • firework 和 player 新增 disable_on_mobile 配置用于控制是否在移动端禁用，默认关闭
    1
    2
    3
    4
    firework:
      disable_on_mobile: false # true | false
    player:
      disable_on_mobile: false # true | false

1.10.2

2025-10-19

特性

  • 渐进支持了 text-autospace，现在 Chrome 140+ 的浏览器会自动在 CJK 和 EN 之间添加间距，无需手动配置
  • 优化分享微信弹出卡片，现在点击分享图标以外的区域会自动关闭卡片
  • 优化顶部 nav 菜单点击热区，现在点击 icon 也能触发菜单跳转
  • Front-matter 中新增 author 字段用于标记文章作者 (用于分享卡片和文章版权)，其优先级最高
    1
    2
    3
    ---
    author: D-Sketon # 文章作者
    ---
  • 新增 triangle_badge 配置用于在右上角展示三角徽章，支持自定义链接和图标
    1
    2
    3
    4
    triangle_badge:
      enable: false # true | false
      icon: github # 与 social 配置里的 icon 相同
      link:

杂项

  • 更新 mermaid 至 v11.12.0
  • 更新 quicklink 至 v3.0.1
  • 更新 katex 至 v0.16.24
  • 更新 snapdom 至 v1.9.14
  • 更新 fontawesome 至 v7.1.0

v1.10.1

2025-10-05

修复

  • 修复多语言文章无法生成的严重回归问题
  • 修复当博客页面高度加载发生抖动时，底部 nav 无法正确展示的问题

特性

  • 字数统计现在排除了 script、style 和 svg 标签内的内容，同时将日语、韩语等 CJK 文字也纳入了中文统计
  • 移除 markdown.container 配置，现在默认开启
  • 优化过期提示的样式，现在其样式和 WARNING 容器一致
  • Front-matter 中新增 outdated 字段用于标记文章过期，其优先级最高，且无视全局配置
    1
    2
    3
    ---
    outdated: true # true | false
    ---
    当该字段为 true 时，文章顶部会显示过期提示

性能

  • 优化博客生成速度

v1.10.0

2025-09-25

修复

  • 修复折叠代码块的复制按钮无法复制的问题
  • 修复开启多语言且语言数大于 2 时内部跳转链接生成错误的问题
  • 修复开启多语言且语言数大于 2 时部分语言文章无法生成的问题
  • 修复自动主题切换时 mermaid 首次展示主题不正确的问题

特性

  • 新增 mermaid 的 zoom 配置，用于控制是否启用缩放，默认关闭
    1
    2
    mermaid:
      zoom: false # true | false

重构

  • 重构样式以提升一致性与美观度
    • 调整卡片、评论与容器的内外边距，优化留白
    • 改进小部件与侧边栏样式，优化对齐与间距
    • 统一圆角值，增强视觉一致性
    • 优化友链、页脚与页眉的响应式布局
    • 更新热力图样式，提升可读性与清晰度
    • 规范按钮与通知样式，统一交互与状态
    • 调整字体大小与行高，提升阅读体验
    • 优化移动端与桌面端滚动条样式
    • 优化代码块样式，提升可读性与一致性
    • 为标题添加淡入模糊动画
    • 优化移动端文章内边距，提升阅读体验
  • 增强可访问性（a11y）
    • 为布局、导航与交互控件补充 aria-label
    • 为可能截断的内容补充 title 提示
    • 优化搜索弹窗的可访问性与交互，完善键盘导航与关闭逻辑

性能

  • 精简 HTML，本人博客总体积大约减少了 8%
    • 移除链接不必要的 external 属性
    • 外置 pjax 相关 js 逻辑
    • 精简 after-footer 与 loader 逻辑
    • 按需动态生成评论系统配置，减少无效代码输出

v1.9.2

2025-09-06

修复

  • 修复 v1.9.1 改变结构后 “开启播放器后移动端将强制展示 fixed 类型的播放器” 特性失效的问题
  • 修复 player.meting.meting_api 错误转义的问题

特性

  • 新增 summary 配置用于控制是否展示文章摘要，默认关闭。可选择 subtitle 或 blockquote 样式
    1
    2
    3
    summary:
      enable: false # true | false
      style: 'subtitle' # 'subtitle' or 'blockquote'

性能

  • CSS 持续性优化

v1.9.1

2025-08-24

修复

  • 修复热力图未来日期的处理逻辑，确保只统计过去的文章数据
  • 修复热力图日期标签重叠的问题

特性

  • 新增 player.position 配置用于控制播放器的位置，可选择在 sidebar 之前、之后或 widget 之后，默认在 sidebar 之后
    1
    2
    player:
      position: before_sidebar # before_sidebar / after_sidebar / after_widget
  • 新增 show_update_time 配置用于控制是否展示文章更新时间，默认关闭
    1
    show_update_time: true # true | false
  • 新增 moe_icp 配置用于控制是否展示萌 ICP 备案信息，默认关闭
    1
    2
    moe_icp:
      icpnumber: # 萌国ICP备案号
  • 自定义容器新增 important 类型，用于标记重要信息 (@reimujs/hexo-renderer-markdown-it-plus 1.2.2+ 支持)
    1
    2
    3
    ::: important
    This is an important box.
    :::
  • 多语言增加对葡萄牙语（巴西）的支持
  • 使用 snapdom 替代 html2image 生成截图

杂项

  • 更新 mermaid 至 v11.10.1
  • 更新 qrcode 至 v1.5.1
  • 更新 dompurify 至 v3.2.6
  • 更新 fontawesome 至 v7.0.0

v1.9.0

2025-07-06

修复

  • 修复 giscus 多语言兜底逻辑

特性

  • 统一 css 阴影样式，新增以下 token:
    • --shadow-meta
    • --shadow-meta-hover
    • --shadow-card
    • --shadow-card-hover
    • --shadow-red-6-shadow
  • heatMapCard 热力图新增自定义 tooltip 内容，支持点击显示文章列表
  • 新增 tagRoulette shortcode 用于展示标签轮盘，提供随机标签展示功能，点击按钮后会从预定义的标签池中随机抽取并展示一个标签。
    1
    {{< tagRoulette tags="?" icon="?" >}}
    • tags：可选参数，指定标签池，多个标签用英文逗号(,)分隔；未提供时默认使用几个示例标签，例如：tags=“记忆衰退,表达欲丧失,更加怠惰,无感,好想睡觉”
    • icon：可选参数，自定义触发按钮的图标，默认使用 🕹️（游戏手柄emoji），可替换为任何emoji或文字，如 🎲、🎯、🔄 等

性能

  • CSS 持续性 tree-shaking，现在评论相关样式会按需打包
  • instantsearch.js 替换为 @reimujs/instantsearch.js，以减少包体积

v1.8.5

2025-05-31

修复

  • 修复 twikoo 评论系统无法正常使用的问题

特性

  • anchor_icon 支持传递 false 以隐藏锚点图标

杂项

  • 更新 mermaid 至 v11.6.0
  • 更新 katex 至 v0.16.22
  • 更新 twikoo 至 v1.6.44

v1.8.4

2025-05-11

特性

  • menu.icon 支持图片路径，如 /avatar/avatar.webp
    1
    2
    3
    4
    menu:
      - name: home
        url: /
        icon: /avatar/avatar.webp
  • vendor 中的 css 支持 SRI

v1.8.3

2025-05-02

修复

  • 修复了当开启 expand 配置时，AOS 运行异常导致部分元素无法正常显示的问题
  • 优化 Aplayer 样式

v1.8.1/1.8.2

2025-04-28

修复

  • 修复移动端导航栏溢出时无法滚动的问题
  • 修复 gitalk id 错误的问题
  • 修复 only_show_capsule_in_index 展示逻辑

特性

  • toc 新增配置用于控制是否展示标号/最小深度/最大深度
    1
    2
    3
    4
    toc_options:
      list_number: true
      min_depth: 1
      max_depth: 6
  • 适配和优化 valine / waline / gitalk 样式
  • valine 新增 serverURLs 配置用于指定服务器地址
    1
    2
    valine:
      serverURLs: # valine server url
  • valine / waline / twikoo / gitalk /giscus 支持多语言，且 valine.lang、waline.lang、giscus.lang 配置废弃
  • comment.title、preloader.text、clipboard.success、clipboard.fail、outdate.message 支持多语言，且同时兼容旧有字符串写法
    1
    2
    3
    4
    5
    6
    7
    8
    # Example
    comment:
      # comment system title
      title:
        en: Leave a comment
        zh-CN: 说些什么吧！
        zh-TW: 說些什麼吧！
        ja: コメントを残す
  • algolia_search.label 和 clipboard.copyright.license 配置废弃，转而使用 i18n 支持多语言
  • clipboard.copyright 和 article_copyright.content 新增 license_type 配置用于配置版权类型，详情见 creativecommons，默认为 by-nc-sa
    1
    2
    3
    4
    5
    6
    article_copyright:
      content: 
        license_type: by-nc-sa
    clipboard:
      copyright:
        license_type: by-nc-sa

v1.8.0

2025-04-13

修复

  • 统一光标
  • 修复 material_theme 开启时渐变色不生效的问题
  • 修复了 MathJax 溢出屏幕的问题
  • 修复了 preloader 的加载动画字体无法自定义的问题
  • 优化了移动端 aplayer 的展示逻辑：现在若开启了播放器，移动端将强制展示 fixed 类型的播放器，且不会被 live2d 遮挡

特性

  • 增强了 markdown 中链接的样式
  • 主题 token 现在可以直接通过 internal_theme 配置进行修改
    1
    2
    3
    4
    5
    6
    7
    internal_theme:
      light:
        --red-0: '#ff0000'
        # ...
      dark:
        --red-4: 'rgba(255, 208, 208, 0.5)'
        # ...
  • 新增 custom_font 配置用于自定义字体，其优先级最高，默认为空，使用方式如下：
    1
    2
    3
    4
    5
    6
    7
    8
    custom_font:
      enable: true # true | false
      article:
        - css: https://fontsapi.zeoseven.com/292/main/result.css # 字体css，支持本地和远程
          name: LXGW WenKai # 字体名称
      code:
        # - css: # 字体css，支持本地和远程
        # - name: # 字体名称
  • preloader 新增 rotate 配置，用于控制加载动画是否旋转，默认开启
    1
    2
    preloader:
      rotate: true # whether to rotate the icon

v1.7.0

2025-04-04

修复

  • 优化 footer 的年份显示
  • 修复了 i18n undefined 的 bug

特性

  • 新增了 heatMapCard shortcode 用于展示文章热力图

    1
    {% heatMapCard levelStandard %}

    其中第一个参数为热力图的等级标准（按照文章字数分级），默认为 "1000,5000,10000"

  • 新增了 material_theme 配置，打开后会基于 Google’s Material You 的设计规范根据文章头图的主色调动态生成主题色

    1
    2
    material_theme:
      enable: false # true | false

    注意：当开启该功能时，会在 banner 的 img 元素上添加 crossorigin="anonymous" 属性，以获取图片的主色调，所以请确保你的图片服务器支持跨域访问，或使用第三方图片代理。

  • 支持了多评论系统同时使用
    全局评论系统配置：

    1
    2
    3
    comment:
      title: 说些什么吧！ # 评论框标题
      default: waline # 多评论下，默认使用的评论系统

v1.6.0

2025.03.16

特性

  • 新增了 pangu 配置用于开启/关闭中英文间的空格，默认关闭
    1
    2
    pangu:
      enable: false # true | false
  • 新增了 cover 配置用于全局控制 post 的封面，其优先级比 front-matter 低，支持 false、url 和 rgb 三种类型
    1
    cover: # https://example.com / false / rgb(255,117,117)
  • Front-matter 中新增 toc 字段用于控制 post 的 TOC，其优先级比全局配置高。
    1
    2
    3
    ---
    toc: true # true | false
    ---
  • 新增了 toc 配置用于全局控制 post 的 TOC，其优先级比 front-matter 低。
    1
    toc: true # true | false
  • 新增了 only_show_capsule_in_index 配置用于控制是否只在归档的首页展示所有分类和标签的胶囊列表，默认关闭。当文章含有大量分类和标签时，开启此选项可以大大提升编译速度。
    1
    only_show_capsule_in_index: false # true | false

性能

  • 提升编译速度

27 分类 + 100 标签

500 篇文章 1.6.0 1.5.2 1.5.1
默认 6.3s 9.85s 4.33min
开启 i18n 9.92s 16.97s 9.4min
开启 relative_link 9.12s 11.54s 5.1min
1000 篇文章 1.6.0 1.5.2 1.5.1
默认 11.01s 18.9s 15min
开启 i18n 16.69s 33.95s >15min
开启 relative_link 14.58s 20.89s >15min
2000 篇文章 1.6.0 1.5.2 1.5.1
默认 19.95s 36.66s >30min
开启 i18n 31s 40.76s >30min
开启 relative_link 27.76s 65.99s >30min

500 分类 + 2500 标签

500 篇文章 1.6.0 only_show_capsule_in_index=true 1.6.0 1.5.2 1.5.1
默认 25.57s 55.53s 2.7min >10min
  • @reimujs/hexo-renderer-markdown-it-plus 1.2.1 提升了预处理速度
@reimujs/hexo-renderer-markdown-it-plus 1.2.1 1.2.0
500 篇文章 预处理 2.98s 5.98s
1000 篇文章 预处理 4.96s 11s
2000 篇文章 预处理 7.85s 20s

v1.5.2

2025.03.08

修复

  • 修复了由于引入多语言而造成的性能回归问题
1.5.1 1.5.2
500 篇文章 关闭多语言 7.15min 9.63s
500 篇文章 开启多语言 10min 16.74s

特性

  • 新增 tag_limits 和 tagcloud_limits 配置用于限制 widget 标签和标签云的数量
    1
    2
    tag_limits: # 标签数量限制
    tagcloud_limits: # 标签云数量限制

v1.5.1

2025.03.01

修复

  • 修正 ja 多语言翻译错误
  • 修复多语言模式下 footer 错误缓存的 bug
  • 修复和优化样式，提升文字对比度，优化阴影效果

特性

  • 新增 injector 配置用于注入自定义代码，其效果和 Hexo#Injector 类似，支持 head、 body 和 sidebar 注入
    1
    2
    3
    4
    5
    6
    7
    injector:
      head_begin: # Inject code snippet right after <head>
      head_end: # Inject code snippet right before </head>
      body_begin: # Inject code snippet right after <body>
      body_end: # Inject code snippet right before </body>
      sidebar_begin: # Inject code snippet right after <aside>
      sidebar_end: # Inject code snippet right before </aside>

v1.5.0

2025.02.23

修复

  • 修复了 language 为 en 时菜单跳转链接异常的 bug
  • 修复了首页/归档/分类/标签/最近文章等页面不能正确显示多语言文章的标题和摘要的 bug
  • 修复了文章版权声明在多语言模式下文章链接显示错误的 bug
  • 修复了 pjax 下多语言切换时页面语言不更新的 bug

特性

  • 文章版权现在支持多语言了

重构

  • 发布了 @reimujs/hexo-algoliasearch 插件，用于支持多语言文章的搜索，其使用方式和 hexo-algoliasearch 完全一致
  • 内置了 hexo-generator-search 插件用于支持多语言文章的搜索，所以无需再安装 hexo-generator-search，其配置方式和 hexo-generator-search 基本一致：
    1
    2
    3
    4
    generator_search:
      enable: true # true | false
      field: post
      content: true

v1.4.0

2025.02.16

修复

  • 修复了 <video></video> 标签不可见的 bug

特性

  • Aplayer 新增了 lrcType 配置用于控制歌词类型

  • dark_mode 新增了 auto 模式，根据用户系统设置自动切换，且现在默认为 auto 模式

    1
    2
    dark_mode:
      enable: auto # true | false | auto

  • 实验性地引入了 hexo-generator-i18n 并提供了多语言切换功能，可以在内层 _config.yml 中配置 i18n 来添加自定义语言，其配置方式可参考 hexo-generator-i18n：

    1
    2
    3
    4
    5
    i18n:
      enable: false # false | true
      type: [page, post]
      generator: [archive, category, tag, index]
      languages: [zh-CN, en] # 语言列表，第一个为默认语言

    对于 post 的多语言支持，可以在 Front-matter 中添加 lang 来指定除默认语言外的其他语言（默认语言不需要添加）

    1
    lang: en

    以上会生成 /en/:permalink 的页面

    对于 page 的多语言支持，可直接在 source 文件夹下新建对应语言的文件夹，并将 index.md 放入其中，如 source/en/about/index.md。这会生成 /en/about 的页面

  • 新增了类似 vitepress 的自定义容器功能，使用前需要安装最新的(v1.2.0+) @reimujs/hexo-renderer-markdown-it-plus，并在内层 _config.yml 中将 markdown.container 改为 true

    1
    2
    markdown:
      container: true

    使用方法如下：

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    ::: info
    This is an info box.
    :::

    ::: tip
    This is a tip.
    :::

    ::: warning
    This is a warning.
    :::

    ::: danger
    This is a dangerous warning.
    :::

    ::: danger 自定义标题
    Danger zone, do not proceed
    :::

    ::: details
    This is a details block.
    :::

v1.3.2

2025.02.09

修复

  • 修复了 KaTeX 客户端渲染在 PJAX 模式下 Waline 等评论报错的 bug
  • 修复了 Valine、Gitalk 和 Twikoo 评论系统在 PJAX 模式下抛出异常的 bug
  • 优化了 Waline 和 Gitalk 评论系统的样式
  • 优化了 sticky Tag 的样式
  • 优化了 PJAX 模式下 script 标签的执行逻辑

特性

  • vendor 现在支持使用链接，现在以下配置均合法
    1
    2
    3
    4
    5
    vendor:
      js:
        katex: webcache|katex@0.16.11/dist/katex.min.css # 使用指定 CDN
        katex: https://cdn.jsdelivr.net/npm/katex@0.16.11/dist/katex.min.css # 使用链接
        katex: /vendor/katex.min.css # 使用本地文件

v1.3.1

2025.02.02

修复

  • 修复了代码块存在横向滚动条时行号和代码块不对齐的 bug
  • 修复了侧边栏溢出时无法滚动的 bug

特性

  • 添加了 theme_version_check 配置用于检查主题版本，当主题版本过低时会在控制台输出警告
    1
    theme_version_check: true # true | false
  • 添加了 theme_config_check 配置用于检查主题配置，当主题配置存在冲突时会在控制台输出警告
    1
    theme_config_check: true # true | false
  • 渐进支持了 interpolate-size，现在 Chrome 129+ 的代码块折叠和 TOC 锚点会有动画效果

杂项

  • 升级了 mouse-firework 依赖，减少内存占用

v1.3.0

2025.01.05

修复

  • 修复了自定义封面时 pjax 失效的 bug
  • 修复了点击侧边栏按钮进行跳转时 pjax 失效的 bug
  • 修复了当标题以数字开头时 TOC 无法正常显示的 bug
  • 修正样式

特性

  • 新增了 share 配置用于开启分享功能，目前支持 facebook、twitter、linkedin、reddit、weibo、qq、weixin。
    1
    2
    3
    4
    5
    6
    7
    8
    share:
      - facebook
      - twitter
      - linkedin
      - reddit
      - weibo
      - qq
      - weixin
    weixin 状态下会生成带有二维码的分享卡片，可保存到本地后分享到微信朋友圈（注意，当文章封面存在跨域问题时无法使用 html-to-image 正确生成含图片的卡片！）
  • 支持在文章 front-matter 中配置 sidebar 字段，用于控制文章是否显示侧边栏，优先级高于全局配置
    1
    2
    3
    ---
    sidebar: left # left | right | false
    ---
  • reimu_cursor 配置结构发生变化，新增 cursor 配置用于自定义鼠标路径。（仍然兼容老配置）
    1
    2
    3
    4
    5
    6
    reimu_cursor:
      enable: true
      cursor:
        default: ../images/cursor/reimu-cursor-default.png
        pointer: ../images/cursor/reimu-cursor-pointer.png
        text: ../images/cursor/reimu-cursor-text.png

v1.2.0

2024.12.28

修复

  • 修复 home_categories 只能填写一个以上分类的 bug

特性

  • 新增了 live2d_widgets 配置用于开启/关闭 live2d-widgets

    1
    2
    3
    live2d_widgets:
      enable: true # true | false
      position: left # left | right

  • 为 top 和 live2d 新增 position 配置，用于控制其位置

    1
    2
    3
    4
    5
    6
    7
    top:
      enable: true # true | false
      position: right # left | right

    live2d:
      enable: true # true | false
      position: left # left | right

  • 新增 player 配置用于配置 Aplayer / Meting 音乐播放器，使用前建议打开 pjax

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    player:
      aplayer:
        enable: false
        options:
          audio: []
          fixed:
          autoplay:
          loop:
          order:
          preload:
          volume:
          mutex:
          listFolded:
      meting:
        enable: false
        meting_api: # custom api
        options:
          id:
          server:
          type:
          auto:

v1.1.1

2024.12.15

修复

  • 修复了客户端渲染下 KaTeX 内链公式无法显示的 bug

特性/优化

现在数学公式不论客户端渲染还是服务端渲染均需安装 @reimujs/hexo-renderer-markdown-it-plus

不论 KaTeX 还是 MathJax3 的客户端渲染，都强烈建议在外层 _config.yml 中添加如下配置

1
2
markdown_it_plus:
  rawLaTeX: true # for client render

这样便无需添加 raw 标签即可直接使用原生 LaTeX 多行块公式

v1.1.0

2024.12.07

修复

  • 修复了部分 css token 未统一的问题

特性

  • 添加了配置用于控制代码块的默认展开状态，expand 可以设置为 true、false 或数字，数字表示当代码块的行数大于该数字时默认收缩。
    1
    2
    code_block:
      expand: true # true | false | number
  • 添加了 local_font 配置用于定义本机兜底字体，其优先级比谷歌字体低：
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    local_font:
      article:
        - "-apple-system"
        - PingFang SC
        - Microsoft YaHei
        - sans-serif
      code:
        - Menlo
        - Monaco
        - Consolas
        - monospace

杂项

  • 为 README 添加了“自定义主题”和“内置卡片 Tag”板块

v1.0.0

🎉🎉🎉 hexo-theme-reimu 的第一个正式版本发布了 🎉🎉🎉

2024.12.01

修复

  • 修复了 KaTeX 带有 tag 时会有多余的滚动条的 bug
  • 修复了 KaTeX 带有 tag 且宽度过小时会和左侧公式重叠的 bug
  • 修复了 giscus 评论不会随着日夜模式切换而改变主题的 bug，现在 giscus 的 commentTheme 配置无效
    1
    2
    giscus:
      commentTheme: # 无效的配置，现在主题由 reimu 托管了
  • 修复了 postLinkCard Tag 未对 excerpt 进行转义的 bug
  • 修复了 Github icon 在夜间模式下颜色不明显的问题
  • 同步了部分 transition 动画，使得动画更加统一

特性

  • 现在 KaTeX 服务端渲染建议使用 @reimujs/hexo-renderer-markdown-it-plus 插件，以支持最新的 KaTeX
  • 现在数学公式的配置结构发生了变化（与老配置不兼容）同时支持了 MathJax3 和 KaTeX，且 KaTeX 还支持了客户端渲染（不需要再安装 hexo 插件，但是会增加页面加载时间）
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    math:
      enable: false
      katex:
        enable: false # KaTeX
        autoRender: false # true 代表客户端渲染，false 代表服务端渲染，需要安装 `@reimujs/hexo-renderer-markdown-it-plus` 插件
      mathjax:
        enable: false # MathJax3，客户端渲染，无需安装插件
        options: # MathJax3 配置
          {
            tex:
              {
                tags: "ams",
                useLabelIds: true,
                inlineMath: [["$", "$"], ['\\(', '\\)']],
                displayMath: [["$$", "$$"], ['\\[', '\\]']],
                processEscapes: true,
                processEnvironments: true,
                autoload: { color: [], colorv2: ["color"] },
                packages: { "[+]": ["noerrors"] },
              },
            options:
              {
                skipHtmlTags:
                  ["script", "noscript", "style", "textarea", "pre", "code"],
                ignoreHtmlClass: "tex2jax_ignore",
                processHtmlClass: "tex2jax_process",
              },
            loader: { load: ["input/asciimath", "[tex]/noerrors"] },
          }
  • 现在支持在首页展示分类卡片，用来代替 widget 的 categories，默认关闭
    1
    2
    3
    4
    5
    home_categories:
      enable: false # true | false
      content:
        - categories: # 目录名称，格式和 front-matter 中的 categories 一致，可以为字符串（单级分类）或数组（多级分类）
          cover: # 卡片封面，不填则使用随机封面

性能

  • CSS 持续性 tree-shaking，现在 social 中只有用到的图标会被打包
  • CSS 持续性 tree-shaking，现在 KaTeX 的样式是按需打包的

⚠️ 重构 ⚠️

如何定制你的hexo-theme-reimu
如何定制你的hexo-theme-reimu
本文针对 v1.0.0+ 版本的 hexo-theme-reimu 主题，介绍如何定制你的 hexo-theme-reimu。 ## 动态适配主题色 (v1.7.0+ 实验性功能) 默认关闭，打开后会基于 Google's Material You 的设计规范根据文章头图的主色调动态生成主题色 ```yml material_theme: enable: false # true

  • 现在搜索和移动端侧边栏共用一个 mask，减少了代码量

  • 统一了 css 中的 token 颜色，现在可以通过修改某些 token 实现替换主题色

  • 重构了 menu 配置，现在支持自定义 icon

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    menu:
      - name: home
        url: /
        icon: # 不填默认使用太极图标
      - name: archives
        url: /archives
        icon: f0c1 # 你可以填写一个十六进制的数字来自定义 icon，支持 fontawesome 和 icon font
      - name: about
        url: /about
        icon:
      - name: friend
        url: /friend
        icon:

  • 重构了 footer、top、sponsor 配置，现在支持自定义 icon

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    footer:
      icon:
        url: "../images/taichi.png" # 相对于 css/style.css 的路径，所以需要向上一级才能找到 images 文件夹
        rotate: true
        mask: true

    top: # 这是新增配置
      enable: true # true | false
      icon:
        url: "../images/taichi.png"
        rotate: true
        mask: true

    sponsor:
      icon:
        url: "../images/taichi.png"
        rotate: true
        mask: true

  • 重构了 preloader 配置，现在支持自定义加载动画 icon

    1
    2
    3
    4
    preloader:
      enable: true
      text: 少女祈祷中...
      icon: # 不填默认使用内链的svg（保证首屏加载速度），你可以填入一个链接来自定义加载图标，如 '/images/taichi.png'

  • 新增了 anchor_icon 配置，现在支持自定义锚点 icon

    1
    anchor_icon: # 不填默认使用 # 图标

v0.3.5

2024.11.23

修复

  • 修复了 photoswipe 对于 gallery 可能加载异常的 bug
  • 修复了 photoswipe 对于常规图片可能加载异常的 bug
  • 修复了 basePath 含有子目录时静态资源加载异常的 bug
  • 修复了 externalLinkCard 的链接缺少 noopenner noreferrer 的 bug
  • 修复了首页卡片未对 excerpt 进行转义的 bug

v0.3.4

2024.11.16

修复

  • 各种乱七八糟的杂项修复
  • 优化 excerpt 的显示逻辑
    • excerpt 字段单用时仅仅作为摘要，不会作为文章内容显示，而仅仅出现在首页
    • excerpt 字段和 link 字段合用时，会作为文章内容显示，且文章会出现 Read More 按钮用于跳转

特性

  • 现在 quicklink 默认改为关闭

  • 代码高亮支持了 patch 语言类型

  • vendor 支持 SRI 校验：

    1
    2
    3
    4
    js:
      clipboard:
        src: webcache|clipboard@2.0.11/dist/clipboard.min.js
        integrity: sha384-J08i8An/QeARD9ExYpvphB8BsyOj3Gh2TSh1aLINKO3L0cMSH2dN3E22zFoXEi0Q

性能

  • photoswipe 相关 js 现在只会在 page 和 post 页面加载
  • comment 相关 js 现在只会在 page 和 post 页面加载

重构

  • 重构了 layout，移除了无关的代码（可能会有 BUG，请及时反馈）

v0.3.3

2024.11.03

修复

  • 修复了 giscus 在首页和归档页面异常显示的 bug

v0.3.2

2024.11.02

修复

  • 修正了 front-matter 中文章版权声明配置读取逻辑。现在的逻辑为：
    • 首先读取文章的 front-matter 中的 copyright，如果不存在则再读取全局配置（保证与其他配置项一致）

特性

  • 搜索蒙层添加了动画效果

  • 新增了赞助功能，可以通过以下配置设置赞助信息

    1
    2
    3
    4
    5
    6
    7
    8
    sponsor:
      enable: false # true | false
      tip: 请作者喝杯咖啡吧！ # 赞助提示
      qr:
        # - name: 支付宝
        #   src: "/sponsor/alipay.jpg"
        # - name: 微信
        #   src: "/sponsor/wechat.png"

    此外，也可以通过文章的 front-matter 控制，其优先级高于全局配置

    1
    2
    3
    ---
    sponsor: true # 是否展示赞助二维码？
    ---

  • Open Graph 添加了 default_og_image 字段，用于设置默认的 Open Graph 图片（适用于主页、归档等无图页面）

    1
    2
    3
    open_graph:
      options:
        default_og_image: /images/banner.webp # 默认 Open Graph 图片，同时支持绝对路径

性能

  • CSS 持续性 tree-shaking，现在 widget、copyright 和 sponsor 的样式都是按需打包的

v0.3.1

2024.10.26

修复

  • 修复了 pjax 下 title 无法更新的 bug
  • 修复了 pjax 下文章头图无法更新的 bug
  • 修复了 fontawesome 下部分图标显示异常的 bug

特性

  • 支持在文章 front-matter 中配置是否关闭文章版权声明（需开启 article_copyright），适合如关于和友链等不需要版权声明的页面
    1
    2
    3
    ---
    copyright: false
    ---
  • 支持页脚展示 ICP 备案号
    1
    2
    3
    4
    icp:
      icpnumber: # ICP备案号
      beian: # 网安备案号
      recordcode: # 网安备案链接中的recordcode参数

v0.3.0

2024.10.20

修复

  • 修复了 pjax 下 clipboard 的内存泄露问题
  • 修复了 pjax 下 pace 的内存泄露问题

特性

  • 支持了 Open Graph，具体配置说明可以参考 Hexo-Open-Graph
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    open_graph:
      enable: true # true | false
      options:
        #twitter_card: <twitter:card>
        #twitter_id: <twitter:creator>
        #twitter_site: <twitter:site>
        #twitter_image: <twitter:image>
        #google_plus: <g+:profile_link>
        #fb_admins: <fb:admin_id>
        #fb_app_id: <fb:app_id>
  • 支持配置过渡动画，现在可以为每种元素配置不同的过渡动画，过渡动画类型可参考 AOS
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    animation:
      enable: true # true | false
      options:
        header:
          title: slide-up
          subTitle: slide-down
        home:
          post: fade-up
          widget: fade-up
          sidebar: fade-up
        article:
          whole: fade-up
          date: zoom-in
          category: zoom-in
          tag: zoom-in
          comment: zoom-in
          reading: zoom-in
          nav: fade-up
        archive:
          whole: fade-up
          tag: zoom-in
          category: zoom-in
          section: fade-up
          nav: fade-up
  • 支持配置 Google Font 字体
    1
    2
    3
    4
    5
    6
    7
    8
    font:
      article:
        - Mulish
        - Noto Serif SC
      code:
        # - Ubuntu Mono
        # - Source Code Pro
        # - JetBrains Mono
  • 支持配置是否开启 pace 进度条（以前是默认开启）
    1
    2
    pace:
      enable: true # true | false

⚠️ 重构 ⚠️

  • WOW 现在改为使用精简版 AOS，同时修改了动画的类型，并修复了 pjax 下内存泄露的问题
  • 样式的大量重构，包括但不限于
    • loader
      • 修改加载动画太极的颜色
    • header
      • 修改了默认头图样式
      • 标题和副标题添加了 AOS 动画
      • nav 太极图改为使用图标，并修改 hover 动画
    • search
      • input 框修改颜色，添加 hover 样式，并移除清空按钮
      • 添加博丽灵梦背景
    • article
      • 文章添加了 AOS 动画
      • 修改并统一 hr 样式
      • 优化夜间模式下的代码块样式
      • 文章底部的版权声明添加了背景
      • 修复 pull quote 样式异常
    • sidebar
      • 太极图改为使用图标，并修改 hover 动画
      • 修改按钮样式
      • 为 widget 添加了溢出省略号隐藏
    • footer
      • 优化夜间模式下的样式

性能

  • 搜索 js 现在改为异步加载
  • phtotswipe、主页的 katex/waline/gitalk css 现在改为异步加载
  • photoswipe 改用 min 版本 js
  • 化简 ejs 和 css 代码

v0.2.4

2024.09.17

特性

  • 优化了搜索，为其添加了花里胡哨的动画效果，并消除了由蒙版带来的页面抖动，现在搜索更好看了！
  • 现在代码复制支持携带版权信息，当复制的字符数大于 count 时会在复制的内容后面添加 content 版权声明。默认关闭
    1
    2
    3
    4
    5
    clipboard:
      copyright:
        enable: false # true | false 是否携带版权信息
        count: 50 # 大于多少字符添加版权声明
        content: 本文版权：本博客所有文章除特别声明外，均采用 BY-NC-SA 许可协议。转载请注明出处！
  • 新增了文章过期提醒功能，默认关闭
    1
    2
    3
    4
    outdate:
      enable: false # true | false 是否开启文章过期提醒
      daysAgo: 180 # 多少天前的文章算过期
      message: 本文最后更新于 {time}，请注意文中内容可能已经发生变化。 # 提示信息

修复

  • 修复了灵梦鼠标指针在 firefox 下显示异常的 bug
  • 改变了 live2d 的 cdn 地址，并修复了原 api 无法拉取模型的 bug

v0.2.3

2024.09.01

特性

  • 优化了 gitalk 评论系统，现在可以使用 md5 hash 来解决 gitalk 标签数量限制的问题
    1
    2
    gitalk:
      md5: # true | false 是否使用 md5 hash
  • 新增了 ServiceWorker 更新提示功能，现在在开启了 ServiceWorker 的情况下，当重新生成博客时会弹出弹窗提示用户更新
  • 新增了 ServiceWorker 自动卸载功能，现在在关闭了 ServiceWorker 的情况下，当用户访问博客时会自动卸载旧有的 ServiceWorker
  • 新增了 quicklink 功能，默认开启，打开后可以在用户停留在页面时预加载链接，提高用户体验
    1
    2
    3
    4
    5
    quicklink:
      enable: # true | false
      timeout: 3000 # 预加载超时时间
      priority: true # 是否优先加载
      ignores: [] # 忽略的链接，目前仅仅支持字符串

v0.2.2

2024.08.24

修复

  • 修复了 gitalk 评论系统 admin 字段读取异常的 bug
  • 简化了 css 和 js 代码，减少了文件大小

特性

  • 优化了 TOC 的样式，现在更好看了！

重构

  • 现在 ServiceWorker 默认关闭，需要手动开启

v0.2.1

2024.07.19

修复

  • 修复了使用 npm 安装主题时，显示 no such file or directory, open '...\themes\reimu\source\js\sw.js' 的 bug

特性

  • 新增了邮箱等 iconfont 图标，详情见 图标优化

v0.2.0

2024.06.09

修复

  • 修复了在使用 hexo-blog-encrypt 时代码块样式显示异常
  • 修复了 pjax 模式下 waline 的内存泄露问题
  • 修复了 config.url 含有 pathname 时静态资源 404 的 bug

特性

  • 新增了文章版权声明的功能，默认关闭
    1
    2
    3
    4
    5
    6
    7
    8
    9
    article_copyright:
      enable: # true | false 是否展示版权卡片？
      content:
        author: # true | false 版权卡片展示作者？
        link: # true | false 版权卡片展示链接？
        title: # true | false 版权卡片展示标题？
        date: # true | false 版权卡片展示创建日期？
        updated: # true | false 版权卡片展示更新日期？
        license: # true | false 版权卡片展示协议？
  • 新增了内链/外链卡片的标签插件
    • postLinkCard
      1
      {% postLinkCard slug [cover]|"auto" [escape] %}
      其中第一个参数为文章的 slug；第二个参数（可选）为卡片展示的封面，如果设置为 auto 则自动使用博客的 banner；第三个参数（可选）表示文章标题是否被转义
    • externalLinkCard
      1
      {% externalLinkCard title link [cover]|"auto" %}
      其中第一个参数为文章的标题；第二个参数为文章的外部链接，第三个参数（可选）为卡片展示的封面，如果设置为 auto 则自动使用缺省封面
  • 友链优化，现在变得更好看了！
  • 代码区域粘贴优化，现在粘贴后会有图标变化，且会弹出对应消息
  • 新增了 banner_srcset 功能，默认关闭
    1
    2
    3
    4
    5
    6
    7
    8
    9
    banner_srcset:
    enable: # true | false
    srcset:
      - src: "/images/banner-600w.webp"
        media: "(max-width: 479px)"
      - src: "/images/banner-800w.webp"
        media: "(max-width: 799px)"
      - src: "/images/banner.webp"
        media: "(min-width: 800px)"

性能

  • banner 和 avatar 改用 webp 格式，降低文件大小
  • Google font 字体优化
    • <link rel="preconnect" href="https://fonts.gstatic.com/" crossorigin>
    • <link rel="preload" as="style" href="https://fonts.googleapis.com/css">
    • <link rel="stylesheet" href="https://fonts.googleapis.com/css" media="print" onload="this.media='all'">
  • mermaid 支持懒加载，但现在需要同时在 config 和 front-matter 中启用 mermaid
    1
    2
    3
    ---
    mermaid: true
    ---

⚠️ 重构 ⚠️

  • 图标改用了 iconfont，但同时也保留了 fontawesome（icon_font 为 false 时默认使用 fontawesome）
    1
    icon_font: # icon_id | false
  • 移除了 JQuery 依赖
  • 移除了 fancybox 依赖，改用 photoswipe
  • 移除了文章分享按钮
  • 移除了部分过时的 css

v0.1.2

2024.04.27

修复

v0.1.1

2024.04.05

特性

  • 新增了可爱灵梦(╹▽╹)鼠标指针，默认开启
    1
    reimu_cursor: # true | false
  • 新增了 clarity 统计
    1
    clarity: # clarity ID
  • 移除了废弃的 gauges 统计，以下配置现在不可用
    1
    gauges_analytics: # gauges ID

修复

  • 修复了 front-matter 中未填写 comment 字段时评论不显示的 bug
  • 修复了 giscus 评论系统宽度显示异常的 bug

性能

  • 提升了 lighthouse 无障碍相关分数
  • 减少了 banner.jpg 的体积

v0.1.0

2024.01.14

🎉🎉🎉 经过了近一年的摸鱼，v0.1.0 终于发布啦 🎉🎉🎉

⚠️ 重构 ⚠️

  • hexo-algolia 替换为了 hexo-algoliasearch
  • 配置中的 vendor 进行了完全重构，现在支持手动切换 CDN：
    1
    2
    3
    4
    5
    6
    7
    8
    9
    vendor:
      cdn_jsdelivr_gh: https://cdn.jsdelivr.net/gh/
      cdn_jsdelivr_npm: https://cdn.jsdelivr.net/npm/
      fastly_jsdelivr_gh: https://fastly.jsdelivr.net/gh/
      fastly_jsdelivr_npm: https://fastly.jsdelivr.net/npm/
      unpkg: https://unpkg.com/
      webcache: https://npm.webcache.cn/
      js:
        jquery: webcache|jquery@3.7.1/dist/jquery.min.js
    目前提供了 jsdelivr/gh、jsdelivr/npm、fastly.jsdelivr/gh、fastly.jsdelivr/npm、unpkg 和 webcache 这几个 CDN 源。所有的依赖地址现在的结构为 CDN源|依赖路径，在生成博客的过程中主题会自动将 CDN 源和后续路径拼接从而形成完整的地址

特性

  • ServiceWorker 增加对部分域名的选择缓存
  • 完善 TOC，目前 TOC 可以随着页面滚动而动态更新，也可以通过点击 TOC 跳转到对应锚点
  • 支持了 waline 的阅读统计功能，启用方式：
    1
    2
    waline:
      pageview: true

修复

  • 修复了 pjax 模式下 mermaid 显示异常的问题
  • 修复了 pjax 模式下 insert_highlight 多次调用的 bug
  • 同步了所有动画的持续时间和缓动函数
  • 修复了配置项未填写 widgets 后空指针的 bug

性能

  • 提升了 LCP 分数
    • google font 采用 rel:preload 的方式加载
    • banner 添加 fetchpriority="high"
    • fontawesome 部分 css 采用 rel:preload 的方式加载

v0.0.11

2024.01.10

特性

  • 新增了 ServiceWorker 功能，默认开启
    1
    2
    service_worker:
      enable: # true | false
  • 新增了 live2d 功能，默认关闭
    1
    2
    live2d:
      enable: # true | false
  • 导航栏优化，现在支持导航栏随着页面滚动的方向而动态显示和隐藏
  • 代码块现在支持了日夜模式，变得更好看了！
  • 日夜模式颜色 token 优化，变得更好看了！

v0.0.10

2024.01.07

修复

  • 修复了 404 页面不能正常搜索的 bug
  • 修复了 TOC 样式异常

特性

  • 现在不仅仅支持 algolia 搜索，也支持使用 hexo-generate-search 进行搜索了
    1
    2
    generator_search:
      enable: # true | false
  • 新增了鼠标烟火效果，默认开启（具体配置可以看 mouse-firework，也是本人写的一个库）
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    firework:
    enable: # true | false
    options:
      excludeElements: ["a"]
      particles:
        - shape: circle
          move: ["emit"]
          easing: easeOutExpo
          colors: ["#ff5252", "#ff7c7c", "#ffafaf", "#ffd0d0"]
          number: 20
          duration: [1200, 1800]
          shapeOptions:
            radius: [16, 32]
            alpha: [0.3, 0.5]
        - shape: circle
          move: ["diffuse"]
          easing: easeOutExpo
          colors: ["#ff0000"]
          number: 1
          duration: [1200, 1800]
          shapeOptions:
            radius: 20
            alpha: [0.2, 0.5]
            lineWidth: 6
  • 新增了 pjax 功能，但目前仍然不稳定，会有很多 bug，默认关闭
    1
    2
    pjax:
      enable: # true | false

v0.0.9

2024.01.01

修复

  • 修复了缓存设置异常造成的 TOC 显示不正确的 bug
  • 修复了 valine 评论数显示异常的 bug

特性

  • 回到顶部按钮变得更好看了
  • TOC 新增了切换到首页的按钮
  • 支持了 valine 的阅读统计功能，启用方式：
    1
    2
    valine:
      visitor: true

v0.0.8

2023.12.31

特性

  • 万众期待的 TOC 终于实现了一部分
  • fontawesome 升级到 v6，同时为 social 新增了一堆图标
  • 新增了回到顶部按钮
  • 日夜模式颜色 token 优化，变得更好看了！
  • 适配 hexo v7

v0.0.7

2023.09.09

修复

  • 修复了 lazyload 和 fancybox 冲突的 bug
  • 新增了更多的封面选项

v0.0.6

2023.07.02

修复

  • 修复了移动端分页显示异常

特性

  • 新增了过渡动画功能，默认开启
    1
    2
    animation:
      enable: # true | false
  • 新增了日夜模式功能，可以通过以下配置设置默认模式
    1
    2
    dark_mode:
      enable: # true | false

v0.0.5

2023.06.30

特性

  • 新增了加载动画功能，默认开启
    1
    2
    3
    preloader:
      enable: # true | false
      text: # 加载文本
  • 新增了版本检查功能，如果发现了主题的新版本会在控制台中提示

重构

  • 移除本地 Ubuntu Mono 字体
  • 移除本地 fontawesome 字体

v0.0.4

2023.06.26

特性

  • 新增了百度统计

    1
    baidu_analytics: # baidu ID

  • 新增了 waline 评论系统

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    waline:
      enable: # true | false
      serverURL:
      lang: zh-CN
      locale: {} # https://waline.js.org/guide/features/i18n.html#%E8%87%AA%E5%AE%9A%E4%B9%89%E8%AF%AD%E8%A8%80
      emoji:
        - https://unpkg.com/@waline/emojis@1.2.0/weibo
        - https://unpkg.com/@waline/emojis@1.2.0/alus
        - https://unpkg.com/@waline/emojis@1.2.0/bilibili
        - https://unpkg.com/@waline/emojis@1.2.0/qq
        - https://unpkg.com/@waline/emojis@1.2.0/tieba
        - https://unpkg.com/@waline/emojis@1.2.0/tw-emoji
      meta:
        - nick
        - mail
        - link
      requiredMeta:
        - nick
        - mail
      wordLimit: 0
      pageSize: 10

  • 新增了 twikoo 评论系统

    1
    2
    3
    4
    twikoo:
      enable: # true | false
      envId: # 腾讯云环境填 envId；Vercel 环境填地址（https://xxx.vercel.app）
      region:

  • 新增了 gitalk 评论系统

    1
    2
    3
    4
    5
    6
    7
    gitalk:
      enable: # true | false
      clientID:
      clientSecret:
      repo:
      owner:
      admin:

  • 新增了 giscus 评论系统

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    giscus:
      enable: # true | false
      repo:
      repoId:
      category:
      categoryId:
      mapping:
      strict:
      reactionsEnabled:
      emitMetadata:
      inputPosition:
      commentTheme:
      lang:

v0.0.3

2023.06.04

杂项

  • 更新了 cdn 依赖文件

v0.0.2

2023.01.18

特性

  • 允许使用外链 url 定义 banner 和 favicon

v0.0.1

2023.01.17

🎉🎉🎉 hexo-theme-reimu 诞生了 🎉🎉🎉

说些什么吧！

waline