Repository navigation
Releases: evannotfound/hexo-theme-redefine
Release list
v2.9.0
更新日志
新增 / 重大更新
- Callout 模块(替代 Note):新增
{% callout %}标签,旧版{% note %}/{% notel %}等标签保持兼容但已弃用(使用时将输出一次性提示)。 - 写作模块升级(Tabs / Button / Grid / Folding):参数解析与渲染逻辑更稳健,解决了复杂嵌套场景下的渲染问题(样式与排版更新详见 #587)。
- 瀑布流(Masonry)升级:引入懒加载与分批加载机制,支持为图片指定
width/height以降低 CLS 影响,图片查看器交互增强并新增可选 EXIF 面板(#578)。 - 评论系统新增:
- Utterances(#582)
- Artalk(#585)@fenychn0206
- 单页模式(Swup)运行时重构:新增生命周期事件与页面作用域清理机制,减少页面切换后的重复绑定和残留监听(#577)。
- Home Banner 社交链接支持稳定排序:
home_banner.social_links.links/qrs现推荐使用数组格式以保证顺序稳定;旧的对象映射格式仍可自动转换,但已弃用(#583)。
修复 / 优化
- Tabs 渲染修复:修复了
notel在 Tabs 中的渲染问题,并解决了折叠框嵌套的相关缺陷(#579, #572)@DenvoZonis - 主题闪白与切换体验优化:优化了深浅色主题的切换逻辑,显著降低刷新时的闪白概率(#562)。
- Stylus 警告修复:调整了 mixin 顺序,避免了压缩时的 Stylus 警告(#555, #552)。
- 多语言/文案修正:修复了菜单栏“书签”等翻译与文案细节(#585)@fenychn0206
- CI / 工程化改进:优化了 PR 预览与发布流程(#584, #586)。
更新方法
- NPM:
npm install hexo-theme-redefine@latest - Git:
cd themes/redefine && git pull
详见:Redefine 文档 #更新
本版本建议迁移配置文件,重点注意 home_banner.social_links 格式的变更。旧格式虽然兼容,但会提示弃用;写作模块的旧标签同样会提示弃用。
相关文档(建议阅读):
- Callout:https://redefine-docs.ohevan.com/zh/docs/modules/callout
- Tabs:https://redefine-docs.ohevan.com/zh/docs/modules/tabs
- Button:https://redefine-docs.ohevan.com/zh/docs/modules/buttons
- Grid:https://redefine-docs.ohevan.com/zh/docs/modules/grid
- Folding:https://redefine-docs.ohevan.com/zh/docs/modules/folding
- 评论:https://redefine-docs.ohevan.com/zh/docs/posts/comment
- Home Banner 社交链接:https://redefine-docs.ohevan.com/zh/docs/home/home_banner
- Masonry:https://redefine-docs.ohevan.com/zh/docs/page_templates/masonry
- JS 开发指南(单页/Swup):https://redefine-docs.ohevan.com/zh/docs/developer/js-guide
Release Notes
New Features / Major Updates
- Callout module (replacement for Notes): Added
{% callout %}; legacy{% note %}/{% notel %}tags remain compatible but are deprecated. - Writing modules refreshed (Tabs / Button / Grid / Folding): Safer arg parsing and rendering in nested scenarios (style/layout refresh: #587).
- Masonry upgrades: Lazy + batched loading, optional
width/heightto reduce CLS, improved image viewer with optional EXIF panel (#578). - New comment systems: Utterances (#582) and Artalk (#585).
- SPA runtime refactor (Swup): Lifecycle + page-scoped cleanup to prevent duplicate listeners after navigation (#577).
- Home banner social links ordering: Prefer array format for stable ordering; legacy object-map auto-converts but is deprecated (#583).
Fixes / Improvements
- Tabs rendering fixes: Fix
notelrendering issues inside Tabs and related nested folding edge cases (#579, Issue #572). - Theme switching: Reduce flash and improve dark/light toggle logic (#562).
- Stylus warning fix: Reorder mixins to avoid Stylus warnings during minification (#555, Issue #552).
- i18n/text: Minor translation fixes (e.g., bookmarks in navbar) (#585).
- CI/tooling: PR preview and release workflow improvements (#584, #586).
Update Instructions
- NPM: Run
npm install hexo-theme-redefine@latest - Git: Run
cd themes/redefine && git pull
For detailed instructions, visit the Redefine Documentation – Updates
This version recommends configuration migration (notably home_banner.social_links ordering and deprecation warnings for legacy writing tags).
更多 🔥
🎉 ChatGPT Plus 会员,每月仅需 23.9 元!省下官网 20 美元/月
👉 立即体验 GPT Plus 共享站
- ✅ 官方正版账号池,支持 GPT-5.2 / GPT-5.2 Pro 等最新模型,Sora 2 视频/图片生成
- ✅ 国内直接访问,无需梯子,即开即用
- ✅ 免费试用一天,满意再付款,零风险体验
- ✅ 运营两年老站,售后有保障,Evan 亲自维护
👨💻 AI 编程助手,让效率翻倍!Arc Codex 一站式编程平台
💰 注册即送 $5 美元额度,首月套餐仅 ¥15.9 起!
👉 立即体验 Arc Codex
- ✅ 支持 GPT-5.3-Codex 等最新编程模型,代码生成更精准
- ✅ 每日 $40 美元额度自动重置,月总额高达 $1200,随便用不封顶
- ✅ 标准版首月仅 15.9 元,远低于官网价,同时使用优惠码
REDEFINE,续费享 8折 优惠! - ✅ Evan 运营保障,不满意包退,无后顾之忧
v2.8.5
更新日志
修复
- 生成博客时 CSS 报错(Issue #542)
- 推荐阅读永久链接生成缺少域名(Issue #540)
- Note 块和 Folding 块无法正确渲染 Markdown 表格(Issue #505)@liohi
更新方法:
- NPM:
npm install hexo-theme-redefine@latest - Git:
cd themes/redefine && git pull
本版本无需迁移配置文件。
Release Notes
Fixes
- Blog build error during generation (#542)
- Missing domain prefix in permalinks generated by Recommended Reading (#540)
- Note & Folding blocks failed to render Markdown tables correctly (#505)
Update Instructions
- NPM: Run
npm install hexo-theme-redefine@latest - Git: Run
cd themes/redefine && git pull
For detailed instructions, visit the Redefine Documentation – Updates
This version does not require configuration file migration.
v2.8.4
更新日志
新增
- Note 组件增强:支持动态图标与标题,观感更一致 #514
- 折叠与按钮模块升级:改进
{% folding %}/{% button %}的参数解析与 HTML 生成,使用更灵活 - 文章导航优化:上下篇按钮在标题过长时自动截断 #499
- 侧边工具栏:新增齿轮旋转动画开关并支持自动展开 #525 (新增
global.side_tools配置项) - Tailwind CSS:升级至 v4.1.11,并重构构建脚本 #531
- Waline:升级至 v3.5.7 并简化评论系统配置 #531
- 社交链接:现可使用本地图标 #522 @Wandering233
更改项/修复
- 修复:404 页面无法正常显示 @xzadudu179
- 修复:说说时间异常(自动 +8 小时)及文章日期时区错误 #515 #465 @Freshwlnd @chanwj
- 修复:自定义图标 note 块英文支持及排版问题 #513 @wavky
- 修复:深色模式下刷新页面闪白 #510 @ChocoFleece
- 修复:繁体中文翻译错别字 #507 @JacKooDesu
- 其他若干样式与布局优化
更新方法:
- NPM:
npm install hexo-theme-redefine@latest - Git:
cd themes/redefine && git pull
详见:[Redefine 文档 #更新](https://redefine-docs.ohevan.com/getting-started#%E6%9B%B4%E6%96%B0)
新版本刚发布后,部分 CDN 同步需要时间,如需使用,请等待几小时后生成站点查看日志以确定 CDN 是否可用。
推荐使用 npmmirror CDN,由阿里云官方提供,访问速度极快(国内与海外)。
本版本需要迁移配置文件。
Release Notes
New Features
- Theme Switching: Added light/dark theme toggle with Critical CSS to prevent flash of wrong theme #511 @evannotfound (new
globals.theme_switchand related options) - Enhanced Note Blocks: Dynamic icons and titles for better readability #514 @evannotfound
- Improved Folding & Button Short-codes: More flexible argument parsing and HTML generation @evannotfound
- Post Navigation: Automatically truncates over-long titles in previous/next buttons #499 @evannotfound
- Side Tools Panel: Added rotating-gear animation and auto-expand capability #525 @evannotfound
- Tailwind CSS upgraded to v4.1.11 with refactored build scripts #531 @evannotfound
- Waline updated to v3.5.7 with streamlined configuration #531 @evannotfound
- Social Links can now use local icons #522 @Wandering233
Fixes
- Fixed: 404 page not displaying correctly @xzadudu179
- Fixed: Incorrect +8 h time offset in “Sayings” and wrong timezone in post dates #515 #465
- Fixed: Misaligned icons and poor English support in custom note blocks #513
- Fixed: Flash of white when refreshing in dark mode #510
- Fixed: Misspellings in zh-TW translations #507
- Various style and layout improvements
Update Instructions
- NPM: Run
npm install hexo-theme-redefine@latest - Git: Run
cd themes/redefine && git pull
For detailed instructions, visit the [Redefine Documentation – Updates](https://redefine-docs.ohevan.com/getting-started#%E6%9B%B4%E6%96%B0).
This version requires configuration file migration.
v2.8.2
更新日志
新增
- 支持自定义 Opengraph 图片 #469 @BrotherJie (更改配置文件
globals.open_graph配置项) - 为 Markdown 中的
<del>添加遮罩效果 @QSlotus(新增articles.delete_mask配置项)
更改项
更新方法:
- NPM:
npm install hexo-theme-redefine@latest - Git:
cd themes/redefine && git pull
新版本刚发布后,部分CDN 同步需要时间,如需使用,请等待几小时后,生成站点查看日志以确定 CDN 是否可用。
推荐使用 npmmirror CDN,由阿里云官方提供,访问速度极快(国内与海外)。
本版本需要迁移配置文件。
Release Notes
New Features
- Added support for custom OpenGraph images #469 @BrotherJie (Configure via
globals.open_graphin the settings file) - Added a mask effect for the
<del>tag in Markdown @QSlotus (Newarticles.delete_maskconfiguration option)
Fixes
- Fixed: APlayer display issues #463
- Fixed: Missing borders in code blocks #467
- Fixed: Changes to the mermaid.js version not taking effect #470
- Fixed: Errors with CDNJ and zstatic CDNs
Update Instructions
- NPM: Run
npm install hexo-theme-redefine@latest - Git: Run
cd themes/redefine && git pull
For detailed instructions, visit the Redefine Documentation - Updates.
This version requires configuration file migration.
v2.8.1
更新日志
更改项
更新方法:
- NPM:
npm install hexo-theme-redefine@latest - Git:
cd themes/redefine && git pull
新版本刚发布后,部分CDN 同步需要时间,如需使用,请等待几小时后,生成站点查看日志以确定 CDN 是否可用。
推荐使用 npmmirror CDN,由阿里云官方提供,访问速度极快(国内与海外)。
本版本主要为 bug 修复,从上一版本升级,不需要迁移配置文件。
Release Notes
Improvements
Update Instructions
- NPM: Run
npm install hexo-theme-redefine@latest - Git: Run
cd themes/redefine && git pull
For more details, see the Redefine documentation on updates.
Please Note: After a new version is released, it may take a few hours for some CDNs to sync. If you're using a CDN, generate your site and check the logs to confirm availability.
Upgrading from the previous version focuses on bug fixes and does not require configuration file migration.
v2.8.0
更新日志
🥰 性能史诗级大更新!压缩,简化,重构主题样式文件,网站资源大小大幅减小以及访问速度大幅提升。页面切换动画,纵享丝滑。极度推荐更新!
新增
更改项
- ✨ 优化:改进页面进入动画效果,提升用户体验,纵享丝滑
- 优化:添加法语国际化支持(特别鸣谢 @Passionlinux)
- 优化:压缩,简化,重构主题样式文件,提升网站性能
- 优化:调整链接下划线和图标样式
- 修复:代码 Diff 高亮显示问题 #437(特别鸣谢 @RocketMaDev)
更新方法:
- NPM:
npm install hexo-theme-redefine@latest - Git:
cd themes/redefine && git pull
注意:新版本发布后,部分 CDN 同步可能需要时间。如需使用 CDN,请等待几小时后生成站点并检查日志以确认 CDN 是否可用。
推荐 CDN: 使用阿里云官方提供的npmmirror,访问速度快(国内外均适用)。
本版本需要迁移配置文件,请注意,更新时请将配置项 fontawsome.sharp_solid 改为 true!
如需使用新功能,请逐项核对配置文件,详情请见:更新文档。
特别鸣谢
Release Notes
🥰 Epic performance update! Theme stylesheets have been compressed, simplified, and refactored, resulting in significantly reduced site resource size and greatly improved loading speeds. Highly recommended to update.
New Features
- Bookmarks Page Template: Introducing a new page template design. Example as shown above #440 #364, documentation.
- PanguJS: Automatically adds spaces between Chinese and English text (new config option:
articles.pangu_js) #450.
Improvements
- Fixed: Code Diff highlighting issues #437 (Special thanks to @RocketMaDev)
- Improved: Added French localization support (Special thanks to @Passionlinux)
- Improved: Compressed, simplified, and refactored theme stylesheets to enhance performance
- Improved: Updated link underlines and icon styles
- ✨ Improved: Enhanced page entry animations for better user experience
Update Instructions:
- NPM:
npm install hexo-theme-redefine@latest - Git:
cd themes/redefine && git pull
For more details, see the Redefine documentation on updates.
Note: CDN synchronization may take a few hours after a new release. If you are using a CDN, generate your site and check the logs to confirm CDN availability.
Recommended CDN: Usenpmmirrorby Alibaba Cloud for super-fast access speeds (both domestic and international).
This release requires configuration file migration. To use the new features, please review and update your configuration files as needed. See update documentation for details.
Special Thanks
v2.7.3
更新日志
更改项
- 修复:行内 Mathjax 公式渲染成行间公式 #447
更新方法:
- NPM:
npm install hexo-theme-redefine@latest - Git:
cd themes/redefine && git pull
新版本刚发布后,部分CDN 同步需要时间,如需使用,请等待几小时后,生成站点查看日志以确定 CDN 是否可用。
推荐使用 npmmirror CDN,由阿里云官方提供,访问速度极快(国内与海外)。
本版本主要为 bug 修复,从上一版本升级,不需要迁移配置文件。
Release Notes
Improvements
- Fixed: Inline Mathjax formulas display issue. #447
Update Instructions
- NPM: Run
npm install hexo-theme-redefine@latest - Git: Run
cd themes/redefine && git pull
For more details, see the Redefine documentation on updates.
Please note: It may take a few hours for some CDNs to sync after a new version is released. If you're using a CDN, generate your site and check the logs to verify availability.
Recommended CDN: npmmirror, which is provided by Alibaba Cloud and offers very fast access speeds both domestically and internationally.
Configuration file migration is not required.
v2.7.2
更新日志
新增(需迁移配置文件)
- 首页 SEO 副标题配置,需要迁移配置文件(#431)
更改项
- 优化:导航栏页面切换增加动画,更流畅
- 优化:页面预加载页面动画优化,缩短时间
- 修复:Essay 说说时区问题,改为动态显示(#367)
- 修复:较长的 Mathjax 行间公式出现遮挡(#422)
- 修复:Logo 大小过大问题(#438)
- 修复:404 页面翻译问题
- 修复:阅读进度中工具栏百分比出现 Infinity、 -Infinity 或 NaN(#432)
- 修复:代码块暗色某些主题无法显示的问题(#435,#437)
更新方法:
- NPM:
npm install hexo-theme-redefine@latest - Git:
cd themes/redefine && git pull
新版本刚发布后,部分CDN 同步需要时间,如需使用,请等待几小时后,生成站点查看日志以确定 CDN 是否可用。
推荐使用 npmmirror CDN,由阿里云官方提供,访问速度极快(国内与海外)。
本版本需要迁移配置文件,如需使用新功能,需要你一一核对,详情请见:更新文档。
特别鸣谢
- @FrederickBun
- @xzadudu179
Release Notes
New Features (Configuration File Migration Required)
- SEO Subtitle Configuration for the homepage. Migration of the configuration file is required (#431).
Improvements
- Optimization: Added transition animations for smoother page navigation.
- Optimization: Improved preloading animations to shorten duration.
- Fixed: Time zone issues with the "Essay" feature, now displayed dynamically (#367).
- Fixed: Long Mathjax inline formulas being obstructed (#422).
- Fixed: Logo size being too large (#438).
- Fixed: Translation issues on the 404 page.
- Fixed: Reading progress toolbar showing Infinity, -Infinity, or NaN for percentage (#432).
- Fixed: Dark-themed code blocks not displaying correctly on some themes (#435, #437).
Update Instructions
- NPM: Run
npm install hexo-theme-redefine@latest - Git: Run
cd themes/redefine && git pull
For more details, see the Redefine documentation on updates.
Please note: It may take a few hours for some CDNs to sync after a new version is released. If you're using a CDN, generate your site and check the logs to verify availability.
Recommended CDN: npmmirror, which is provided by Alibaba Cloud and offers very fast access speeds both domestically and internationally.
Configuration file migration is required to use new features. Users should check the update documentation for details.
v2.7.1
更新日志
更改项
更新方法:
- NPM:
npm install hexo-theme-redefine@latest - Git:
cd themes/redefine && git pull
新版本刚发布后,部分CDN 同步需要时间,如需使用,请等待几小时后,生成站点查看日志以确定 CDN 是否可用。
推荐使用 npmmirror CDN,由阿里云官方提供,访问速度极快(国内与海外)。
本版本主要为 bug 修复,不需要迁移配置文件。
关于 BootCDN 以及 Staticfile CDN 投毒
Staticfile 以及 Bootcdn 由于存在 CDN 投毒的安全风险,已经不再安全。因此,Redefine 主题的新版本 (2.7.0+) 已切换到 Cloudflare 的 CDNJS 作为 Twikoo 和 Gitalk 的脚本源,并且移除这两个 CDN 的支持。
如需进一步了解相关内容,请访问 【BootCDN/Staticfile投毒分析】供应链投毒后,我们的选择还剩下哪些?(来源:吾爱破解论坛)。
请及时更新主题版本到 2.7.0 即以上,并避免使用 bootCDN 和 staticfileCDN。
感谢您的理解与支持。
Release Notes
Changes
New Features (configuration file migration required)
- None.
Update Instructions
- NPM:
npm install hexo-theme-redefine@latest - Git:
cd themes/redefine && git pull
Configuration file migration is required to use new features. Users should check the update documentation for details.
The npmmirror CDN is recommended for fast access speeds both domestically and internationally.
Security Note
BootCDN and Staticfile CDN support has been removed due to security risks. Users are advised to update to version 2.7.0 or higher and avoid using these CDNs.
v2.7.0
更新日志
新增(需迁移配置文件)
- 自定义代码高亮主题 (#380),预览可前往 highlightjs 官网演示,目前支持:
- 亮色主题:
github,atom-one-light,default - 暗色主题:
github-dark,monokai-sublime,vs2015,night-owl,atom-one-dark,nord,tokyo-night-dark,a11y-dark,agate
- 亮色主题:
- 导航栏站点标题以及主页侧边栏站点标题自定义字体 #398
- Hitokoto 显示作者功能 #409
- 主题预加载页面自定义文字 #416
- 自定义首页文章摘要长度 #414
更改项
- 移除:
staticfile以及bootcdn两个 CDN。两者具有 CDN 投毒风险,详情请往下看 - 修复:文章加密与主题单页加载冲突导致无法加载图片 / 执行 js 代码问题 #405 #400
- 修复:
categories以及tags标签页自定义标题会空白页面问题 - 修复:标题单引号报错 #402 #403
- 修复:说说时间显示问题 #395
- 优化:国际化翻译 #389
- 优化:文章归档分类排序 #395
- 优化:404 页面显示问题 #389
- 优化:主题预加载页面默认关闭
- 优化:Twikoo 以及 Gitalk 使用 Cloudflare CDNJS 作为脚本提供源,移除原先的 Staticfile #415
更新方法:
- NPM:
npm install hexo-theme-redefine@latest - Git:
cd themes/redefine && git pull
新版本刚发布后,部分CDN 同步需要时间,如需使用,请等待几小时后,生成站点查看日志以确定 CDN 是否可用。
推荐使用 npmmirror CDN,由阿里云官方提供,访问速度极快(国内与海外)。
本版本需要迁移配置文件,如需使用新功能,需要你一一核对,详情请见:更新文档。
特别鸣谢
- @feiju12138 代码优化
- @FrederickBun 代码贡献 + 主题文档
- @Smileslime47 代码贡献
- @RyouSY Bug 修复
- @jackgdn 新增功能
关于 BootCDN 以及 Staticfile CDN 投毒
Staticfile 以及 Bootcdn 由于存在 CDN 投毒的安全风险,已经不再安全。因此,Redefine 主题的新版本 (2.7.0+) 已切换到 Cloudflare 的 CDNJS 作为 Twikoo 和 Gitalk 的脚本源,并且移除这两者的支持。
如需进一步了解相关内容,请访问 【BootCDN/Staticfile投毒分析】供应链投毒后,我们的选择还剩下哪些?(来源:吾爱破解论坛)。
请及时更新主题版本到 2.7.0 即以上,并避免使用 bootCDN 和 staticfileCDN。
感谢您的理解与支持。
Release Notes
New Features (configuration file migration required)
- Custom code highlighting themes (#380). Preview available on the highlightjs website. Supported themes:
- Light themes:
github,atom-one-light,default - Dark themes:
github-dark,monokai-sublime,vs2015,night-owl,atom-one-dark,nord,tokyo-night-dark,a11y-dark,agate
- Light themes:
- Custom fonts for navigation bar site title and homepage sidebar site title (#398)
- Display author for Hitokoto quotes (#409)
- Custom text for theme preload page (#416)
- Custom length for article excerpts on homepage (#414)
Changes
- Removed:
staticfileandbootcdnCDNs due to security risks - Fixed: Conflict between article encryption and theme single page loading causing images/JS not to load (#405 #400)
- Fixed: Blank page issue with custom titles for
categoriesandtagspages - Fixed: Error with single quotes in titles (#402 #403)
- Fixed: Time display issue for blog posts (#395)
- Improved: Internationalization translations (#389)
- Improved: Sorting of article archive categories (#395)
- Improved: 404 page display (#389)
- Improved: Theme preload page disabled by default
- Improved: Twikoo and Gitalk now use Cloudflare CDNJS as script source, removed Staticfile (#415)
Update Instructions
- NPM:
npm install hexo-theme-redefine@latest - Git:
cd themes/redefine && git pull
Configuration file migration is required to use new features. Users should check the update documentation for details.
The npmmirror CDN is recommended for fast access speeds both domestically and internationally.
Security Note
BootCDN and Staticfile CDN support has been removed due to security risks. Users are advised to update to version 2.7.0 or higher and avoid using these CDNs.



