ppoffice/hexo-theme-icarus 7.0.0

on GitHub

Upgrade Notes

• Icarus now requires hexo-component-inferno 5.0.0 or later, and inferno-server is a dependency. If you install Icarus from npm, you get them automatically, with hexo-component-inferno 5.1.0. If you cloned the theme into themes/icarus, run the install command that the dependency check prints, for example npm install --save hexo-component-inferno@^5.0.0 inferno-server@^8.2.3. See the release notes of hexo-component-inferno 5.0.0 and 5.1.0 beb5317
• The theme configuration file does not change: its version is still 5.1.0. The new options below are off by default
• Removed integrations: Facebook Comments, Share.js, Baidu Share, AddThis and the Google FeedBurner subscribe_email widget show a notice instead of loading. Switch to another comment plugin, set share.type to web_share, addtoany or sharethis, and use the followit widget. See the hexo-component-inferno 5.0.0 release notes beb5317
• Gitalk: Icarus uses Gitalk 2, which requires a GitHub App and your own proxy, set in proxy. Remove client_secret from your configuration and generate a new client secret, because the old one was published in your pages beb5317
• Profile widget: it no longer falls back to /img/avatar.png when neither avatar nor gravatar is set. To keep the image, set avatar: /img/avatar.png in the widget c2f3135 56a9f61
• Gallery: lightGallery 3 is licensed under GPLv3 or a commercial license; check that it fits your site. Rename the justifiedGallery CDN override to justified-gallery, and replace jQuery calls to lightGallery() or justifiedGallery() in your own scripts with the native APIs 5bc84de e930a5a
• MathJax: MathJax 4 loads tex-mml-chtml.js without the es5/ prefix and loads its fonts on demand. If you host MathJax yourself, mirror the whole mathjax and @mathjax/mathjax-newcm-font packages 760213c
• PJAX: PJAX is now part of the theme, so the pjax CDN override is no longer used. If you added scripts that set up the content of a page, run them on the pjax:complete event as well 3cf03b7
• If you have customized copies of these files, apply the changes of this release to them: layout/layout.jsx, layout/common/head.jsx, layout/common/navbar.jsx, layout/common/article.jsx, layout/common/plugins.jsx, layout/common/scripts.jsx, source/js/main.js and source/js/pjax.js. The navbar and PJAX code moved to source/js/navbar.js, source/js/appearance.js and source/js/pjax-*.js, and layout/widget/profile.jsx is removed 9742f94 a0dbc4d c2f3135
• Cusdis is deprecated and prints a warning: it was archived on July 17, 2026. Switch to another comment plugin 8187984

New Features

• Material 3 Expressive variant: variant: m3e brings tinted surfaces, rounded cards and pill-shaped controls that change shape on hover and keyboard focus, in light, dark or auto appearance (see the Material 3 Expressive Theme Variant post) 0086cb5 fab96ef c295880 f5bbc44
• Appearance switch: pages with appearance: auto have a sun and moon button in the navbar. Visitors can pick light or dark, and their browser remembers the choice 74cad5e
• Web Share: share.type: web_share shows links to X, Facebook, Weibo, Telegram and LinkedIn, and a button for the share menu of the visitor's device, without a third-party SDK 8a654bf
• GitHub contribution calendar: the github_calendar widget shows the contributions of a GitHub user. No GitHub token is needed d567719
• Reading progress bar: posts show how far they have been read in a 3px bar at the top of the window, in browsers that support scroll-driven animations ce1fa5c
• Cookie Consent: with type: opt-in, the web analytics plugins only load after the visitor allows cookies; with opt-out, they stop loading after the visitor declines them. info remains a notice only 966e7f9
• LiveRe: set client_id to the client-id of the installation code from LiveRe Admin to use the current LiveRe widget. uid keeps loading the legacy LiveRe City code e2069ac

Improvements

• PJAX keeps working through Back and Forward, restoring the scroll position of each page, and reinitializes the navbar, comments, math and gallery of the pages it switches to 3cf03b7 9742f94 2105054 a0dbc4d
• The gallery uses lightGallery 3 and justified-gallery 4 in all variants and across PJAX page switches 5bc84de e930a5a
• MathJax 4 typesets the expressions of each page switched to with PJAX 760213c
• The outdated browser notice checks the CSS features that the variant needs, instead of loading the old detection library 46d0591
• Google Custom Search results follow the colors and fonts of the theme, with compact thumbnails and controls that fit narrow screens 3a5baa5
• The default author avatar is replaced a21c3e5
• The README presents the three variants and the supported integrations 5335005
• Tests: cover dates, rendering, the published Artalk, Waline, KaTeX and Valine clients, Disqus color parsing and behavior on different platforms 7ef6ac5 62274ba e136741 f9108b9 694c588 1fb6876

Bug Fixes

• Cyberpunk: fix comment plugins and code highlighting turning light for visitors whose system prefers a light color scheme, and fix the colors of code and tag fonts, ShareThis counts, dropdowns and messages 562154a
• Gallery: fix lightbox captions being hard to read, and the gallery styles after switching CDN providers d8aab4e
• CI: fix the Cookie Consent tests and the keyboard focus test of the navbar sub-menus being unreliable 238f22d