hexo-theme-reimu开发日志

2024-06-01

计软杂谈 hexo

hexo-theme-reimu 的开发日志

v0.2.0

0.2.0 伴随着大量的重构，可能会有许多 bug，欢迎大家提交 ISSUE 和 PR

2024-06-09

修复

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

特性

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 功能，默认关闭

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

修复

修复了在使用 hexo-blog-encrypt 时 TOC 无法显示的 bug

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：

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|[email protected]/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，也是本人写的一个库）

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 评论系统

waline:
  enable: # true | false
  serverURL:
  lang: zh-CN
  locale: {} # https://waline.js.org/guide/features/i18n.html#自定义语言
  emoji:
    - https://unpkg.com/@waline/[email protected]/weibo
    - https://unpkg.com/@waline/[email protected]/alus
    - https://unpkg.com/@waline/[email protected]/bilibili
    - https://unpkg.com/@waline/[email protected]/qq
    - https://unpkg.com/@waline/[email protected]/tieba
    - https://unpkg.com/@waline/[email protected]/tw-emoji
  meta:
    - nick
    - mail
    - link
  requiredMeta:
    - nick
    - mail
  wordLimit: 0
  pageSize: 10

新增了 twikoo 评论系统

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

新增了 gitalk 评论系统

gitalk:
  enable: # true | false
  clientID:
  clientSecret:
  repo:
  owner:
  admin:

新增了 giscus 评论系统

giscus:
  enable: # true | false
  repo:
  repoId:
  category:
  categoryId:
  mapping:
  strict:
  reactionsEnabled:
  emitMetadata:
  inputPosition:
  commentTheme:
  lang: