Rackora v0.10.3

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

Rackora v0.10.2

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

Rackora v0.10.1

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

Rackora v0.10.0

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

Rackora v0.9.9

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

Rackora v0.9.8

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

Rackora v0.9.7

Rackora v0.9.7

调整

• 新安装默认使用简体中文：“主题界面语言”默认简体中文，“网站语言”默认 zh-CN。已安装的站点保留原有设置；需要英文界面时，在“基础”中选择 English，并把网站语言改为 en-US。
• 主题详情中的描述恢复为英文。

---

安装包：theme-rackora-0.9.7.zip

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

Rackora v0.9.6

Rackora v0.9.6

修复

• 中文界面统一使用“分类”称呼文章分类（分类索引、面包屑、空状态、文档模板侧栏、降级导航与页脚），与 Halo 后台一致，不再与“栏目”混用。
• 英文界面的计数在数量为 1 时使用单数，例如 1 post、1 public post、1 view、1 comment。
• 页脚 Halo 署名、首页资料卡的副标题回退文案和首页横幅的图片描述跟随主题界面语言，中文界面不再残留英文。
• 主题详情中的描述与自定义模板名称改为中文（模板名保留英文对照），与中文的主题设置一致；模板文件和已选择的模板不受影响。

优化

• “主题界面语言”与“网站语言”的设置说明补充：中文站点应同时把网站语言设为 zh-CN，避免中文正文输出英文 lang。

文档

• README 开头加入主题 Logo；界面预览补充手机端、分类与标签列表、独立页和 Console 主题详情，并收录全部设置分组截图。

---

安装包：theme-rackora-0.9.6.zip

完整提交对比：v0.9.5...v0.9.6

Rackora v0.9.5

Rackora v0.9.5

修复

• 归档页同一年份有多个月份时，第二个及之后的月份不再被挤进左侧年份列导致标题逐字竖排；年份标题在整年范围内保持吸顶。
• 分页只有“下一页”或“上一页”时，按钮保持在左右两端，页码始终居中。
• 文章只有“下一篇”时，卡片固定在右列并右对齐，不再落到“上一篇”的位置；没有相邻文章时不再留下空白导航区。
• 主导航不再把 # 占位链接、空链接和站外链接高亮为当前页。
• 桌面端二级菜单补齐父项与子菜单之间的悬停区域，鼠标下移时子菜单不再消失。
• 没有 Logo 的友情链接、没有图片的推广卡片不再把文字挤进图片列。
• 友情链接页、插件页和 Documentation 模板的眉题与标题补齐样式，与归档页标题保持一致。
• 首页侧栏英文统计的运行天数只显示数字，不再与 Days 标签重复并折成两行。
• 403、500 等非 404 错误不再回退到 Halo 默认错误页，改用带主题页头页脚的通用错误页；只有 4xx 显示错误说明，5xx 不向访客暴露服务端异常信息。
• 复制文章链接后按钮切换为对勾图标并更新提示，读屏器会播报“链接已复制”；复制失败时显示叉号与失败提示，连续点击不会被上一次的恢复计时提前还原。
• 浅色模式的次要文字、推广标签和代码注释颜色对比度提升到 WCAG AA（4.5:1）以上。

优化

• 图标渲染只处理新增的占位符，文章页加载、复制代码时不再把页面上已渲染的全部图标重复重建。
• 阅读进度条改为按动画帧更新并使用 transform，滚动时不再触发布局计算。
• 页面渐变背景改由固定定位的伪元素承载，滚动时无需重绘整页背景，iOS 上也不再被拉伸到整篇文章高度。
• 配色设为“跟随系统”时，系统切换明暗后配色按钮的图标与提示同步更新。
• 本地预览新增多年份多月份归档、友情链接页、错误页、二级菜单和无图推广卡片，验证脚本覆盖上述布局约束与配色对比度。

发布

• 安装包新增 THIRD_PARTY_LICENSES.txt，随包附带 IBM Plex Sans、Source Serif 4、Highlight.js 和 Lucide 的版权声明与许可证原文。
• 发布工作流接入 Halo 应用市场同步：配置仓库变量 HALO_APP_ID 与密钥 HALO_PAT 后，打标签发布会自动同步新版本；未配置时只发布 GitHub Release。
• 移除模板遗留的 CD 工作流：它使用占位应用 ID，且会因重复上传同名安装包而失败。

---

安装包：theme-rackora-0.9.5.zip

完整提交对比：v0.9.4...v0.9.5

Rackora v0.9.4

Rackora v0.9.4

修复

• 首页、栏目、标签、作者和归档的第 2 页及以后现在使用带页码的 canonical 与标题，并输出 rel="prev" / rel="next"，避免分页被收成首页重复内容。
• About 模板与页头、首页资料卡使用同一套方形 / 横向 Logo 回退，不再只读取 Halo 站点 Logo。
• Organization 结构化数据的 @id 统一为去掉尾斜杠的站点地址加 #organization，独立页不再因 site.url 是否带 / 拆成两个实体。
• 文章分享按钮在服务端直接输出各平台 URL，无脚本时不再落到页顶的 #。

---

安装包：theme-rackora-0.9.4.zip

完整提交对比：v0.9.3...v0.9.4