Skip to content

Releases: D-Sketon/hexo-theme-reimu

V1.2.0

28 Dec 13:08
Compare
Choose a tag to compare

修复

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

特性

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

    live2d_widgets:
      enable: true # true | false
      position: left # left | right
  • toplive2d 新增 position 配置,用于控制其位置

    top:
      enable: true # true | false
      position: right # left | right
    
    live2d:
      enable: true # true | false
      position: left # left | right
  • 新增 player 配置用于配置 Aplayer / Meting 音乐播放器,使用前建议打开 pjax

    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:

Full Changelog: v1.1.1...v1.2.0

v1.1.1

15 Dec 08:12
Compare
Choose a tag to compare

修复

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

特性/优化

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

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

markdown_it_plus:
  rawLaTeX: true # for client render

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

v1.1.0

07 Dec 07:51
Compare
Choose a tag to compare

修复

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

特性

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

杂项

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

Full Changelog: v1.0.0...v1.1.0

v1.0.0

01 Dec 05:13
Compare
Choose a tag to compare

Warning

包含破坏性变更,升级前请仔细阅读版本日志

修复

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

特性

  • 现在 KaTeX 服务端渲染建议使用 @reimujs/hexo-renderer-markdown-it-plus 插件,以支持最新的 KaTeX
  • 现在数学公式的配置结构发生了变化(与老配置不兼容)同时支持了 MathJax3KaTeX,且 KaTeX 还支持了客户端渲染(不需要再安装 hexo 插件,但是会增加页面加载时间)
    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,默认关闭
    home_categories:
      enable: false # true | false
      content:
        - categories: # 目录名称,格式和 front-matter 中的 categories 一致,可以为字符串(单级分类)或数组(多级分类)
          cover:  # 卡片封面,不填则使用随机封面

性能

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

重构

  • 现在搜索和移动端侧边栏共用一个 mask,减少了代码量
  • 统一了 css 中的 token 颜色,现在可以通过修改某些 token 实现替换主题色
  • 重构了 menu 配置,现在支持自定义 icon
    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:
  • 重构了 footertopsponsor 配置,现在支持自定义 icon
    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
    preloader:
      enable: true
      text: 少女祈祷中...
      icon: # 不填默认使用内链的svg(保证首屏加载速度),你可以填入一个链接来自定义加载图标,如 '/images/taichi.png'
  • 新增了 anchor_icon 配置,现在支持自定义锚点 icon
    anchor_icon: # 不填默认使用 # 图标

Full Changelog: v0.3.5...v1.0.0

v0.3.5

23 Nov 07:48
Compare
Choose a tag to compare

What's Changed

修复

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

Full Changelog: v0.3.4...v0.3.5

v0.3.4

16 Nov 10:23
Compare
Choose a tag to compare

What's Changed

修复

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

特性

  • 现在 quicklink 默认改为关闭

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

  • vendor 支持 SRI 校验:

    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,请及时反馈)

Full Changelog: v0.3.3...v0.3.4

v0.3.3

03 Nov 13:29
Compare
Choose a tag to compare

What's Changed

修复

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

Full Changelog: v0.3.2...v0.3.3

v0.3.2

02 Nov 04:39
Compare
Choose a tag to compare

What's Changed

修复

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

特性

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

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

    sponsor:
      enable: false # true | false
      tip: 请作者喝杯咖啡吧! # 赞助提示
      qr:
        # - name: 支付宝
        #   src: "/sponsor/alipay.jpg"
        # - name: 微信
        #   src: "/sponsor/wechat.png"

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

    ---
    sponsor: true # 是否展示赞助二维码?
    ---
  • Open Graph 添加了 default_og_image 字段,用于设置默认的 Open Graph 图片(适用于主页、归档等无图页面)

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

性能

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

Full Changelog: v0.3.1...v0.3.2

v0.3.1

26 Oct 08:12
Compare
Choose a tag to compare

What's Changed

Full Changelog: v0.3.0...v0.3.1

修复

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

特性

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

v0.3.0

20 Oct 09:25
Compare
Choose a tag to compare

What's Changed

Full Changelog: v0.2.4...v0.3.0

修复

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

特性

  • 支持了 Open Graph,具体配置说明可以参考 Hexo-Open-Graph
    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
    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 字体
    font:
      article:
        - Mulish
        - Noto Serif SC
      code:
        # - Ubuntu Mono
        # - Source Code Pro
        # - JetBrains Mono
  • 支持配置是否开启 pace 进度条(以前是默认开启)
    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 代码