Rackora

Rackora v0.10.3

修复

• 移动端打开目录抽屉（body.toc-open）时锁定底层页面滚动，避免滚动穿透；当视口拉宽至桌面端（> 960px）时自动收起抽屉遮罩，并在关闭抽屉时将键盘焦点归还给目录触发按钮。
• 代码块复制按钮补充连续点击定时器清理与失败状态自动恢复，避免快速点击时状态提前重置或复制失败后文案无法复原。
• 独立页面（SinglePage）补齐 rackora_index_policy 索引策略表单与 noindex,follow 输出，并统一归一化普通独立页与关于页 JSON-LD 中的 isPartOf.url。
• 文档模板（post_docs.html）补齐更新时间、核验日期与推广关系披露声明；当同分类仅含当前文档时隐藏冗余同分类列表，并在右侧栏无可见区块时自动折叠为单栏布局。

新增

• 正文图片灯箱支持展示 <figcaption> 或图片 alt 图注，并支持点击放大后的图片直接关闭灯箱。
• 启用搜索组件（PluginSearchWidget）时，支持使用 Ctrl+K / Cmd+K 快捷键唤起搜索框。

优化

• 目录滚动监听（Scroll Spy）缓存顶栏高度与目录链接集合，仅在当前激活章节变更时更新 DOM；返回顶部按钮增加 requestAnimationFrame 节流与状态缓存，显著降低滚动期间的样式计算与 DOM 操作开销。
• 正文图片自动补齐默认 loading="lazy" 与 decoding="async"，且仅在正文存在可放大图片时才向页面挂载灯箱 <dialog> 节点。
• 文章系列循环仅对匹配当前系列的文章读取 rackora_series_order 注解，减少非本系列文章的模板求值开销。

---

安装包：theme-rackora-0.10.3.zip

完整提交对比：v0.10.2...v0.10.3

---

Generated from v0.10.3

Rackora v0.10.2

修复

• 文章模型（Post）补充注册 rackora_index_policy（索引策略）元数据表单字段，使文章与文档页的 noindex,follow 策略可在 Halo 后台直接下拉选择。
• 统一文章页、文档模板、普通独立页和关于页的正文图片灯箱开关：全部跟随后台「文章 → 点击放大正文图片」设置，普通独立页不再遗漏灯箱，文档与关于页也不再在关闭设置后继续弹出灯箱。
• 文章系列目录在全站同系列公开文章不足 2 篇（仅含当前文章自身）时自动隐藏，避免底部出现单条仅指向当前页的系列列表。
• 修正「插件 → 显示友情链接入口」的后台说明，明确其控制 /links 页面适配与默认页脚导航中的友链入口。
• 补齐 CHANGELOG.md 底部缺失的历史版本标签链接定义。

---

安装包：theme-rackora-0.10.2.zip

完整提交对比：v0.10.1...v0.10.2

---

Generated from v0.10.2

Rackora v0.10.1

修复

• 文章页与文档页的 JSON-LD 内联表达式补上 ${}，并把标签关键词从 #strings.arrayJoin 改为 #strings.listJoin。Halo 2.27 会把原先缺少 ${} 的表达式当成模板错误，文章页因此返回 500。

---

安装包：theme-rackora-0.10.1.zip

完整提交对比：v0.10.0...v0.10.1

---

Generated from v0.10.1

Rackora v0.10.0

修复

• 顶部导航搜索按钮增加 SearchWidget 运行时防御，避免第三方搜索插件脚本尚未加载就绪时抛出未捕获错误。
• 分享栏链接生成增加协议前缀判断防御，避免文章永久链接已包含完整域名时重复拼接导致双重域名。
• 系列文章与相关文章增加空状态自愈清理，当分类下无其他文章或系列列表为空时不再残留多余的标题与空白区块。

新增

• 文章页与文档页的 Open Graph 元数据补齐 article:author、article:section 以及 article:tag 标签，提升社交平台分享卡片信息完整度。
• 文章页与文档页的 Schema.org 结构化数据（BlogPosting 与 TechArticle）补充 keywords（标签关键词）与 articleSection（主分类）语义字段。
• 文章与文档页支持文章级 rackora_index_policy 索引策略，设置为 noindex 时输出对应的 noindex,follow 标签。
• 首页 WebSite JSON-LD 结构化数据增加标准 SearchAction 声明，助力搜索引擎生成站内搜索框。

优化

• 启用 GA4、Microsoft Clarity 或百度统计时，在 <head> 中动态注入对应的 preconnect 与 dns-prefetch，减少第三方分析服务握手延迟。
• 作者页与关于页的图片补充 decoding="async"，避免首屏解码阻塞页面主线程渲染。

---

安装包：theme-rackora-0.10.0.zip

完整提交对比：v0.9.9...v0.10.0

---

Generated from v0.10.0

Rackora v0.9.9

修复

• 文章侧栏「最新评论」改为同时要求评论插件已启用（haloCommentEnabled）且当前文章已有公开评论；评论插件关闭或没有公开评论时不再调用 commentFinder，也不再渲染空侧栏区块。

优化

• 将官方 Comment Widget 的 --halo-cw-* 样式变量桥接到主题强调色与正文色（含深色模式、提交按钮对比色与评论内图片最大宽度），评论区视觉与 Rackora 配色一致。
• docs/plugin-compatibility.md 补充 Halo / Comment Widget 版本矩阵：主题仍声明 >=2.20.0，Comment Widget 3.4.0+ 需站点先升到 Halo >=2.27.0。

---

安装包：theme-rackora-0.9.9.zip

完整提交对比：v0.9.8...v0.9.9

---

Generated from v0.9.9

Rackora v0.9.8

修复

• 分类页的“精选内容”卡片和文章页的系列列表恢复显示。此前判断条件引用了同一元素上 th:with 定义的变量，而 Thymeleaf 会先执行 th:if 再执行 th:with，判断时变量尚未定义；变量定义已移到外层元素，构建检查会拦截同类写法。
• “外观 → 强调色”设置恢复生效。此前颜色变量写在 <body> 上，而主题在 <html> 上派生强调色，页面始终显示默认绿色；现在浅色模式直接使用所选颜色，深色模式自动提高亮度。以前改过强调色的站点，升级后会按当时所选的颜色显示。
• 安装包内中英文 README 的截图、Logo 和封面改为固定到对应版本标签的地址，仓库之后调整截图不会再让已发布安装包中的图片失效。

优化

• 主题清单声明 Halo 应用市场应用 ID（store.halo.run/app-id），便于 Console 识别已安装的 Rackora 并提示应用市场中的更新。
• “分析”分组的总开关说明补充数据流向，并指向 README 中的隐私说明。
• 清理重复的 CSS 规则，前台显示不变。

文档

• README 补充隐私说明：区分主题自身行为（不设置 Cookie，只在访客本机保存明暗模式选择）与第三方统计的数据处理，列出 GA4、Microsoft Clarity、百度统计的数据类别、浏览器存储、保存与删除方式和隐私政策链接。
• 代码高亮说明改为实际内置的 16 种语言，其他语言保持纯文本显示，不再使用“按需语言包”的说法。
• README 截图更新为中文默认界面，分为前台页面与后台设置两组，并加入应用市场封面。

---

安装包：theme-rackora-0.9.8.zip

完整提交对比：v0.9.7...v0.9.8

---

Generated from v0.9.8

Rackora v0.9.7

本次调整

• 新安装默认使用简体中文，主题界面语言默认为“简体中文”，网站语言默认为 zh-CN。
• 已安装站点保留原有语言设置，不受本次默认值调整影响。
• 主题详情中的描述恢复为英文。

使用说明

• 兼容 Halo 2.20.0 及以上版本。
• 如需英文界面，请在主题“基础”设置中将主题界面语言设为 English，并将网站语言改为 en-US。

前台页面

后台设置