计软杂谈hexo

If you have any questions or suggestions, feel free to submit an Issue.

1.7.0

Fixes

  • Optimized the display of the year in the footer.
  • Fixed a bug where i18n was undefined.

Features

  • Added the heatMapCard shortcode to display an article heatmap

    1
    {% heatMapCard levelStandard %}

    The first parameter is the level standard for the heatmap (graded based on the word count of the articles), with the default value being "1000,5000,10000".

  • Added the material_theme configuration, which dynamically generates theme colors based on the dominant color of the article’s banner image, following Google’s Material You design guidelines when enabled

    1
    2
    material_theme:
      enable: false # true | false

    Note: When this feature is enabled, the crossorigin="anonymous" attribute will be added to the img element of the banner to fetch the dominant color of the image. Please ensure your image server supports cross-origin access or use a third-party image proxy.

  • Support for multiple comment systems simultaneously
    Global comment system configuration:

    1
    2
    3
    comment:
      title: Say something! # Title of the comment box  
      default: waline # Default comment system used when multiple are enabled

1.6.0

2025.03.16

Features

  • Added pangu configuration to enable/disable spaces between Chinese and English text. Default is false.
    1
    2
    pangu:
      enable: false # true | false
  • Added cover configuration for global control of post covers. It has lower priority than front-matter and supports false, url, and rgb types.
    1
    cover: # https://example.com / false / rgb(255,117,117)
  • Added toc field in front-matter to control the Table of Contents (TOC) for posts. It has higher priority than global configuration.
    1
    2
    3
    ---
    toc: true # true | false
    ---
  • Added toc configuration for global control of post TOC. It has lower priority than front-matter.
    1
    toc: true # true | false
  • Added only_show_capsule_in_index configuration to control whether to display all categories and tags’ capsule lists only on the archive index page. Default is false. Enabling this option can significantly improve compilation speed when posts contain a large number of categories and tags.
    1
    only_show_capsule_in_index: false # true | false

Performance

  • Improved compilation speed.

27 categories + 100 tags

500 posts1.6.01.5.21.5.1
Default6.3s9.85s4.33min
With i18n9.92s16.97s9.4min
With relative_link9.12s11.54s5.1min
1000 posts1.6.01.5.21.5.1
Default11.01s18.9s15min
With i18n16.69s33.95s>15min
With relative_link14.58s20.89s>15min
2000 posts1.6.01.5.21.5.1
Default19.95s36.66s>30min
With i18n31s40.76s>30min
With relative_link27.76s65.99s>30min

500 categories + 2500 tags

500 posts1.6.0 only_show_capsule_in_index=true1.6.01.5.21.5.1
Default25.57s55.53s2.7min>10min
  • @reimujs/hexo-renderer-markdown-it-plus 1.2.1 improved preprocessing speed.
@reimujs/hexo-renderer-markdown-it-plus1.2.11.2.0
500 posts preprocessing2.98s5.98s
1000 posts preprocessing4.96s11s
2000 posts preprocessing7.85s20s

1.5.2

2025.03.08

Fixes

  • Fixed performance regression caused by the introduction of multilingual support.
1.5.11.5.2
500 Articles, i18n Off7.15min9.63s
500 Articles, i18n On10min16.74s

Features

  • Added tag_limits and tagcloud_limits configurations to limit the number of tags in widgets and tag clouds.
    1
    2
    tag_limits: # Limits the number of tags
    tagcloud_limits: # Limits the number of tags in the tag cloud

1.5.1

2025.03.01

Fixes

  • Fixed incorrect Japanese multilingual translation errors.
  • Resolved footer caching bugs under multilingual mode.
  • Optimized styles: Improved text contrast and enhanced shadow effects.

Features

  • Added injector configuration to inject custom code snippets, with functionality similar to Hexo#Injector. It supports injection into head, body, and sidebar areas:
    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

Fixes

  • Fixed a bug where menu jump links were abnormal when language was set to en.
  • Fixed a bug where the homepage/archive/category/tag/recent posts pages could not correctly display titles and summaries of multilingual articles.
  • Fixed a bug where the article copyright statement displayed incorrect article links in multilingual mode.
  • Fixed a bug where the page language would not update when switching languages under pjax.

Features

  • Article copyright now supports multiple languages.

Refactor

  • Released the @reimujs/hexo-algoliasearch plugin to support searching for multilingual articles. Its usage is identical to hexo-algoliasearch.
  • Built-in hexo-generator-search plugin to support searching for multilingual articles, so there’s no need to install hexo-generator-search separately. Its configuration is mostly the same as hexo-generator-search:
    1
    2
    3
    4
    generator_search:
      enable: true # true | false
      field: post
      content: true

v1.4.0

2025.02.16

Fixes

  • Fixed a bug where <video></video> tags were not visible.

Features

  • Aplayer now has a lrcType configuration to control lyric types.

  • dark_mode now supports an auto mode, which automatically switches based on the user’s system settings. The default mode is now auto.

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

  • Experimental introduction of hexo-generator-i18n with multilingual switching functionality. You can configure i18n in the inner _config.yml to add custom languages. Refer to hexo-generator-i18n for configuration:

    1
    2
    3
    4
    5
    i18n:
      enable: false # false | true
      type: [page, post]
      generator: [archive, category, tag, index]
      languages: [zh-CN, en] # List of languages, the first one is the default language.

    For multilingual support in posts, you can add lang in the Front-matter to specify languages other than the default (the default language does not need to be added).

    1
    lang: en

    This will generate a page at /en/:permalink.

    For multilingual support in pages, you can directly create a folder for the corresponding language in the source folder and place index.md inside it, such as source/en/about/index.md. This will generate a page at /en/about.

  • Added a custom container feature similar to vitepress. Before using it, you need to install the latest (v1.2.0+) @reimujs/hexo-renderer-markdown-it-plus and set markdown.container to true in the inner _config.yml.

    1
    2
    markdown:
      container: true

    Usage is as follows:

    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 Custom Title
    Danger zone, do not proceed.
    :::

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

v1.3.2

2025.02.09

Fixes

  • Fixed a bug where KaTeX client-side rendering caused errors in Waline and other comments in PJAX mode.
  • Fixed a bug where Valine, Gitalk, and Twikoo comment systems threw exceptions in PJAX mode.
  • Optimized the styles of Waline and Gitalk comment systems.
  • Optimized the style of sticky tags.
  • Optimized the execution logic of script tags in PJAX mode.

Features

  • Vendor now supports using links. The following configurations are now valid:
    1
    2
    3
    4
    5
    vendor:
      js:
        katex: webcache|katex@0.16.11/dist/katex.min.css # Use a specific CDN
        katex: https://cdn.jsdelivr.net/npm/katex@0.16.11/dist/katex.min.css # Use a link
        katex: /vendor/katex.min.css # Use a local file

v1.3.1

2025.02.02

Fixes

  • Fixed a bug where line numbers and code blocks were misaligned when horizontal scrollbars were present.
  • Fixed a bug where the sidebar could not scroll when overflowing.

Features

  • Added theme_version_check configuration to check the theme version. A warning will be output in the console if the theme version is too low.
    1
    theme_version_check: true # true | false
  • Added theme_config_check configuration to check theme configurations. A warning will be output in the console if there are conflicts in the theme configuration.
    1
    theme_config_check: true # true | false
  • Gradually supported interpolate-size. Now code block folding and TOC anchor points will have animation effects in Chrome 129+.

Miscellaneous

  • Upgraded the mouse-firework dependency to reduce memory usage.

v1.3.0

2025.01.05

Fixes

  • Fixed a bug where pjax failed when using a custom cover.
  • Fixed a bug where pjax failed when jumping by clicking the sidebar button.
  • Fixed a bug where TOC could not display correctly when the title started with a number.
  • Adjusted styles.

Features

  • Added share configuration to enable sharing features. Currently supports facebook, twitter, linkedin, reddit, weibo, qq, and weixin.
    1
    2
    3
    4
    5
    6
    7
    8
    share:
      - facebook
      - twitter
      - linkedin
      - reddit
      - weibo
      - qq
      - weixin
    In the weixin state, a share card with a QR code will be generated, which can be saved locally and shared on WeChat Moments (Note: If the article cover has cross-origin issues, the card with images cannot be generated correctly using html-to-image!).
  • Supported configuring the sidebar field in the article front-matter to control whether the sidebar is displayed for the article. This has higher priority than the global configuration.
    1
    2
    3
    ---
    sidebar: left # left | right | false
    ---
  • The reimu_cursor configuration structure has changed. Added cursor configuration to customize the mouse path. (Still compatible with old configurations.)
    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

Fixes

  • Fixed a bug where home_categories could only be filled with one or more categories.

Features

  • Added live2d_widgets configuration to enable/disable live2d-widgets.

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

  • Added position configuration for top and live2d to control their positions.

    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

  • Added player configuration to configure Aplayer / Meting music players. It is recommended to enable pjax before using.

    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

Fixes

  • Fixed a bug where KaTeX inline formulas could not be displayed in client-side rendering.

Features/Optimizations

Now, whether using client-side or server-side rendering for mathematical formulas, you need to install @reimujs/hexo-renderer-markdown-it-plus.

For both KaTeX and MathJax3 client-side rendering, it is strongly recommended to add the following configuration in the outer _config.yml:

1
2
markdown_it_plus:
  rawLaTeX: true # for client render

This way, you can use native LaTeX multi-line block formulas without adding raw tags.

v1.1.0

2024.12.07

Fixes

  • Fixed an issue where some CSS tokens were not unified.

Features

  • Added configuration to control the default expansion state of code blocks. expand can be set to true, false, or a number. A number indicates that the code block will be collapsed by default if the number of lines exceeds that number.
    1
    2
    code_block:
      expand: true # true | false | number
  • Added local_font configuration to define fallback fonts for the local machine. These have lower priority than Google Fonts:
    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

Miscellaneous

  • Added “Custom Theme” and “Built-in Card Tags” sections to the README.

v1.0.0

🎉🎉🎉 The first official version of hexo-theme-reimu is released! 🎉🎉🎉

2024.12.01

Fixes

  • Fixed a bug where KaTeX with tags had extra scrollbars.
  • Fixed a bug where KaTeX with tags and small width overlapped with the left formula.
  • Fixed a bug where giscus comments did not change themes with day/night mode switching. Now giscus’s commentTheme configuration is invalid.
    1
    2
    giscus:
      commentTheme: # Invalid configuration, now the theme is hosted by reimu.
  • Fixed a bug where the postLinkCard tag did not escape excerpt.
  • Fixed an issue where the Github icon was not clearly visible in dark mode.
  • Synchronized some transition animations to make them more consistent.

Features

  • Now KaTeX server-side rendering recommends using the @reimujs/hexo-renderer-markdown-it-plus plugin to support the latest KaTeX.
  • The configuration structure for mathematical formulas has changed (incompatible with old configurations). Now both MathJax3 and KaTeX are supported, and KaTeX also supports client-side rendering (no need to install a hexo plugin, but it will increase page load time).
    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 for client-side rendering, false for server-side rendering, requires `@reimujs/hexo-renderer-markdown-it-plus` plugin.
      mathjax:
        enable: false # MathJax3, client-side rendering, no plugin required.
        options: # MathJax3 configuration
          {
            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"] },
          }
  • Now supports displaying category cards on the homepage to replace the categories widget. Disabled by default.
    1
    2
    3
    4
    5
    home_categories:
      enable: false # true | false
      content:
        - categories: # Directory name, format consistent with categories in front-matter, can be a string (single-level category) or an array (multi-level category).
          cover: # Card cover, if not filled, a random cover will be used.

Performance

  • CSS continuous tree-shaking, now only the icons used in social are packaged.
  • CSS continuous tree-shaking, now KaTeX styles are packaged on-demand.

⚠️ Refactoring ⚠️

How to customize your hexo-theme-reimu
How to customize your hexo-theme-reimu
This article introduces how to customize your **hexo-theme-reimu** for versions **v1.0.0+** of the theme. ## Dynamic Theme Color Adaptation (Experimental Feature in v1.7.0+) Disabled by default. W

  • Now search and mobile sidebar share a mask, reducing code volume.

  • Unified CSS token colors, now you can replace theme colors by modifying certain tokens.

  • Refactored menu configuration, now supports custom icons.

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    menu:
      - name: home
        url: /
        icon: # If not filled, the default Tai Chi icon is used.
      - name: archives
        url: /archives
        icon: f0c1 # You can fill in a hexadecimal number to customize the icon, supports fontawesome and icon font.
      - name: about
        url: /about
        icon:
      - name: friend
        url: /friend
        icon:

  • Refactored footer, top, sponsor configurations, now supports custom icons.

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    footer:
      icon:
        url: "../images/taichi.png" # Relative path to css/style.css, so you need to go up one level to find the images folder.
        rotate: true
        mask: true

    top: # This is a new configuration.
      enable: true # true | false
      icon:
        url: "../images/taichi.png"
        rotate: true
        mask: true

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

  • Refactored preloader configuration, now supports custom loading animation icons.

    1
    2
    3
    4
    preloader:
      enable: true
      text: Praying...
      icon: # If not filled, the default inline SVG is used (ensures first-screen loading speed). You can fill in a link to customize the loading icon, such as '/images/taichi.png'.

  • Added anchor_icon configuration, now supports custom anchor icons.

    1
    anchor_icon: # If not filled, the default # icon is used.

v0.3.5

2024.11.23

Fixes

  • Fixed a bug where photoswipe might load abnormally for galleries.
  • Fixed a bug where photoswipe might load abnormally for regular images.
  • Fixed a bug where static resources could not load correctly when basePath contained subdirectories.
  • Fixed a bug where externalLinkCard links were missing noopenner noreferrer.
  • Fixed a bug where the homepage card did not escape excerpt.

v0.3.4

2024.11.16

Fixes

  • Various miscellaneous fixes.
  • Optimized the display logic of excerpts.
    • When the excerpt field is used alone, it only serves as a summary and does not display as article content, only appearing on the homepage.
    • When the excerpt field is used together with the link field, it will display as article content, and the article will have a Read More button for redirection.

Features

  • Now quicklink is disabled by default.

  • Code highlighting now supports the patch language type.

  • Vendor now supports SRI verification:

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

Performance

  • Photoswipe-related JS now only loads on page and post pages.
  • Comment-related JS now only loads on page and post pages.

Refactor

  • Refactored layout, removed irrelevant code (there may be bugs, please report them in time).

v0.3.3

2024.11.03

Fixes

  • Fixed a bug where giscus displayed abnormally on the homepage and archive pages.

v0.3.2

2024.11.02

Fixes

  • Corrected the reading logic of the article copyright statement configuration in front-matter. The current logic is:
    • First read the copyright in the article’s front-matter, if it does not exist, then read the global configuration (consistent with other configuration items).

Features

  • Added animation effects to the search mask.

  • Added a sponsorship feature. You can set sponsorship information with the following configuration:

    1
    2
    3
    4
    5
    6
    7
    8
    sponsor:
      enable: false # true | false
      tip: Buy the author a cup of coffee! # Sponsorship prompt
      qr:
        # - name: Alipay
        #   src: "/sponsor/alipay.jpg"
        # - name: WeChat
        #   src: "/sponsor/wechat.png"

    Additionally, you can control it through the article’s front-matter, which has higher priority than the global configuration.

    1
    2
    3
    ---
    sponsor: true # Whether to display the sponsorship QR code?
    ---

  • Open Graph added a default_og_image field to set the default Open Graph image (for homepage, archive, and other pages without images).

    1
    2
    3
    open_graph:
      options:
        default_og_image: /images/banner.webp # Default Open Graph image, also supports absolute paths.

Performance

  • Continuous CSS tree-shaking, now widget, copyright, and sponsor styles are packaged on-demand.

v0.3.1

2024.10.26

Fixes

  • Fixed a bug where the title could not be updated in pjax mode.
  • Fixed a bug where the article cover image could not be updated in pjax mode.
  • Fixed a bug where some icons displayed abnormally with fontawesome.

Features

  • Supported configuring whether to disable the article copyright statement in the article front-matter (requires enabling article_copyright), suitable for pages like about and friend links that do not need copyright statements.
    1
    2
    3
    ---
    copyright: false
    ---
  • Supported displaying ICP filing number in the footer.
    1
    2
    3
    4
    icp:
      icpnumber: # ICP filing number
      beian: # Public security filing number
      recordcode: # The recordcode parameter in the public security filing link.

v0.3.0

2024.10.20

Fixes

  • Fixed a memory leak issue with clipboard in pjax mode.
  • Fixed a memory leak issue with pace in pjax mode.

Features

  • Supported Open Graph, specific configuration instructions can refer to 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>
  • Supported configuring transition animations, now you can configure different transition animations for each element. Refer to AOS for transition animation types.
    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
  • Supported configuring Google Font fonts.
    1
    2
    3
    4
    5
    6
    7
    8
    font:
      article:
        - Mulish
        - Noto Serif SC
      code:
        # - Ubuntu Mono
        # - Source Code Pro
        # - JetBrains Mono
  • Supported configuring whether to enable the pace progress bar (previously enabled by default).
    1
    2
    pace:
      enable: true # true | false

⚠️ Refactoring ⚠️

  • WOW is now replaced with a streamlined version AOS, modified animation types, and fixed memory leak issues in pjax mode.
  • Extensive style refactoring, including but not limited to:
    • loader
      • Modified the color of the Tai Chi loading animation.
    • header
      • Modified the default cover image style.
      • Added AOS animations to titles and subtitles.
      • Replaced the Tai Chi image in nav with an icon and modified hover animations.
    • search
      • Modified input box colors, added hover styles, and removed the clear button.
      • Added a Hakurei Reimu background.
    • article
      • Added AOS animations to articles.
      • Modified and unified hr styles.
      • Optimized code block styles in dark mode.
      • Added a background to the copyright statement at the bottom of articles.
      • Fixed pull quote style abnormalities.
    • sidebar
      • Replaced the Tai Chi image with an icon and modified hover animations.
      • Modified button styles.
      • Added overflow ellipsis hiding for widgets.
    • footer
      • Optimized styles in dark mode.

Performance

  • Search JS is now loaded asynchronously.
  • Phtotswipe, homepage’s katex/waline/gitalk CSS are now loaded asynchronously.
  • Photoswipe uses minified JS.
  • Simplified ejs and CSS code.

v0.2.4

2024.09.17

Features

  • Optimized search, addedfancyanimation effects, and eliminated page jitter caused by masks. Now search looks better!
  • Now code copying supports carrying copyright information. When the number of copied characters exceeds count, the content will be appended with a copyright statement. Disabled by default.
    1
    2
    3
    4
    5
    clipboard:
      copyright:
        enable: false # true | false Whether to carry copyright information.
        count: 50 # Add a copyright statement when the number of characters exceeds this value.
        content: Copyright: All articles in this blog, unless otherwise stated, adopt the BY-NC-SA license. Please indicate the source!
  • Added an article expiration reminder feature, disabled by default.
    1
    2
    3
    4
    outdate:
      enable: false # true | false Whether to enable the article expiration reminder.
      daysAgo: 180 # Articles older than this number of days are considered expired.
      message: This article was last updated {time}, please note that the content may have changed. # Reminder message.

Fixes

  • Fixed a bug where the Reimu mouse pointer displayed abnormally in Firefox.
  • Changed the live2d CDN address and fixed a bug where the original API could not fetch models.

v0.2.3

2024.09.01

Features

  • Optimized the gitalk comment system. Now you can use md5 hash to solve the gitalk tag limit issue.
    1
    2
    gitalk:
      md5: # true | false Whether to use md5 hash.
  • Added a ServiceWorker update notification feature. Now, when the blog is regenerated with ServiceWorker enabled, a popup will prompt the user to update.
  • Added a ServiceWorker automatic uninstallation feature. Now, when ServiceWorker is disabled, the old ServiceWorker will be automatically uninstalled when the user visits the blog.
  • Added a quicklink feature, enabled by default. When enabled, links can be preloaded while the user stays on the page, improving user experience.
    1
    2
    3
    4
    5
    quicklink:
      enable: # true | false
      timeout: 3000 # Preload timeout.
      priority: true # Whether to prioritize loading.
      ignores: [] # Ignored links, currently only supports strings.

v0.2.2

2024.08.24

Fixes

  • Fixed a bug where the gitalk comment system admin field was read abnormally.
  • Simplified CSS and JS code, reducing file size.

Features

  • Optimized TOC styles, now it looks better!

Refactor

  • Now ServiceWorker is disabled by default and needs to be manually enabled.

v0.2.1

2024.07.19

Fixes

  • Fixed a bug where no such file or directory, open '...\themes\reimu\source\js\sw.js' was displayed when installing the theme via npm.

Features

v0.2.0

2024.06.09

Fixes

  • Fixed a bug where code block styles displayed abnormally when using hexo-blog-encrypt.
  • Fixed a memory leak issue with waline in pjax mode.
  • Fixed a bug where static resources returned 404 when config.url contained pathname.

Features

  • Added an article copyright statement feature, disabled by default.
    1
    2
    3
    4
    5
    6
    7
    8
    9
    article_copyright:
      enable: # true | false Whether to display the copyright card?
      content:
        author: # true | false Display the author in the copyright card?
        link: # true | false Display the link in the copyright card?
        title: # true | false Display the title in the copyright card?
        date: # true | false Display the creation date in the copyright card?
        updated: # true | false Display the update date in the copyright card?
        license: # true | false Display the license in the copyright card?
  • Added tag plugins for internal/external link cards.
    • postLinkCard
      1
      {% postLinkCard slug [cover]|"auto" [escape] %}
      The first parameter is the article’s slug; the second parameter (optional) is the cover displayed on the card. If set to auto, the blog’s banner will be used automatically; the third parameter (optional) indicates whether the article title is escaped.
    • externalLinkCard
      1
      {% externalLinkCard title link [cover]|"auto" %}
      The first parameter is the article’s title; the second parameter is the article’s external link; the third parameter (optional) is the cover displayed on the card. If set to auto, a default cover will be used.
  • Optimized friend links, now they look better!
  • Optimized code area pasting. Now there will be icon changes after pasting, and a corresponding message will pop up.
  • Added banner_srcset feature, disabled by default.
    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)"

Performance

  • Banner and avatar now use webp format to reduce file size.
  • Google font optimization.
    • <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 supports lazy loading, but now it needs to be enabled in both config and front-matter.
    1
    2
    3
    ---
    mermaid: true
    ---

⚠️ Refactoring ⚠️

  • Icons now use iconfont, but fontawesome is still retained (defaults to fontawesome when icon_font is false).
    1
    icon_font: # icon_id | false
  • Removed JQuery dependency.
  • Removed fancybox dependency, replaced with photoswipe.
  • Removed article share buttons.
  • Removed some outdated CSS.

v0.1.2

2024.04.27

Fixes

v0.1.1

2024.04.05

Features

  • Added a cute Reimu(╹▽╹) mouse pointer, enabled by default.
    1
    reimu_cursor: # true | false
  • Added clarity statistics.
    1
    clarity: # clarity ID
  • Removed deprecated gauges statistics. The following configuration is now invalid.
    1
    gauges_analytics: # gauges ID

Fixes

  • Fixed a bug where comments did not display when the comment field was not filled in front-matter.
  • Fixed a bug where the giscus comment system width displayed abnormally.

Performance

  • Improved lighthouse accessibility scores.
  • Reduced the size of banner.jpg.

v0.1.0

2024.01.14

🎉🎉🎉 After nearly a year ofslacking off, v0.1.0 is finally released! 🎉🎉🎉

⚠️ Refactoring ⚠️

  • hexo-algolia was replaced with hexo-algoliasearch.
  • The vendor configuration was completely refactored. Now it supports manually switching CDNs:
    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
    Currently, jsdelivr/gh, jsdelivr/npm, fastly.jsdelivr/gh, fastly.jsdelivr/npm, unpkg, and webcache CDN sources are provided. All dependency addresses now have the structure CDN source|dependency path. During blog generation, the theme will automatically concatenate the CDN source and the subsequent path to form a complete address.

Features

  • ServiceWorker added selective caching for some domains.
  • Improved TOC. Now TOC can be dynamically updated as the page scrolls, and you can also jump to the corresponding anchor by clicking TOC.
  • Supported waline’s reading statistics feature. Enable it with:
    1
    2
    waline:
      pageview: true

Fixes

  • Fixed a bug where mermaid displayed abnormally in pjax mode.
  • Fixed a bug where insert_highlight was called multiple times in pjax mode.
  • Synchronized all animation durations and easing functions.
  • Fixed a bug where a null pointer occurred when the widgets configuration was not filled.

Performance

  • Improved LCP scores.
    • Google font uses rel:preload for loading.
    • Banner adds fetchpriority="high".
    • Part of fontawesome CSS uses rel:preload for loading.

v0.0.11

2024.01.10

Features

  • Added ServiceWorker feature, enabled by default.
    1
    2
    service_worker:
      enable: # true | false
  • Added live2d feature, disabled by default.
    1
    2
    live2d:
      enable: # true | false
  • Optimized the navigation bar. Now it supports dynamically showing and hiding as the page scrolls.
  • Code blocks now support day/night modes, looking better!
  • Day/night mode color token optimization, looking better!

v0.0.10

2024.01.07

Fixes

  • Fixed a bug where the 404 page could not search normally.
  • Fixed TOC style abnormalities.

Features

  • Now not only supports algolia search, but also supports using hexo-generate-search for search.
    1
    2
    generator_search:
      enable: # true | false
  • Added a mouse firework effect, enabled by default (specific configuration can be found in mouse-firework, a library also written by me).
    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
  • Added pjax feature, but it is still unstable and may have many bugs, disabled by default.
    1
    2
    pjax:
      enable: # true | false

v0.0.9

2024.01.01

Fixes

  • Fixed a bug where cache settings caused TOC to display incorrectly.
  • Fixed a bug where valine comment counts displayed abnormally.

Features

  • The back-to-top button looks better now.
  • TOC added a button to switch to the homepage.
  • Supported valine’s reading statistics feature. Enable it with:
    1
    2
    valine:
      visitor: true

v0.0.8

2023.12.31

Features

  • The long-awaited TOC has finally been implementedpartially
  • Upgraded fontawesome to v6, adding a bunch of new icons for social
  • Added a back-to-top button
  • Optimized day and night mode color tokens for a more appealing look!
  • Adapted for hexo v7

v0.0.7

2023.09.09

Fixes

  • Fixed a bug with lazyload conflicting with fancybox
  • Added more cover options

v0.0.6

2023.07.02

Fixes

  • Fixed abnormal pagination display on mobile devices

Features

  • Added transition animation feature, enabled by default
    1
    2
    animation:
      enable: # true | false
  • Added day and night mode feature, allowing default mode setting via the following configuration
    1
    2
    dark_mode:
      enable: # true | false

v0.0.5

2023.06.30

Features

  • Added loading animation feature, enabled by default
    1
    2
    3
    preloader:
      enable: # true | false
      text: # Loading text
  • Added version check feature; if a new theme version is detected, a prompt will appear in the console

Refactoring

  • Removed local Ubuntu Mono font
  • Removed local fontawesome font

v0.0.4

2023.06.26

Features

  • Added Baidu Analytics

    1
    baidu_analytics: # baidu ID

  • Added Waline comment system

    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

  • Added Twikoo comment system

    1
    2
    3
    4
    twikoo:
      enable: # true | false
      envId: # For Tencent Cloud environment, fill in envId; for Vercel environment, fill in the address (https://xxx.vercel.app)
      region:

  • Added Gitalk comment system

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

  • Added Giscus comment system

    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

Miscellaneous

  • Updated CDN dependency files

v0.0.2

2023.01.18

Features

  • Allowed defining banner and favicon using external URLs

v0.0.1

2023.01.17

🎉🎉🎉 hexo-theme-reimu is born 🎉🎉🎉

Say something!

waline