hexo-theme-stellar 2.0.0-rc.2 → 2.0.0-rc.4

package/CHANGELOG.md

@@ -1,5 +1,60 @@
 # Changelog
 
+## 2.0.0-rc.4
+
+> 发布日期：2026-09-10
+
+本节记录从公开候选 `2.0.0-rc.3` 到 `2.0.0-rc.4` 最终文件树的净变化。
+
+### 修复与改进
+
+- 恢复博客列表导航中的专栏入口，使用当前上架专栏索引判断是否显示。
+- 修复移动端专栏文章列表横向溢出，调整 OKR 标签宽度与右对齐；移动端根字号增量由 2px 调整为 1px。
+- 统一集合控件、侧栏菜单与搜索结果字体，修复导航前缀和长标题的布局。
+- minimal 外观下文章、专栏封面与置顶轮播在普通及交互状态均去除边框，保留键盘焦点 outline。
+- Markdown 行内链接的站点信息请求失败时保留原图标，不再显示红色断链图标；数据加载失败时隐藏加载指示器。
+- 将仅用于源码检查的 `glob` 移至开发依赖，并显式声明 ESLint 配置需要的 `@eslint/js` 与 `globals`。
+
+### 升级注意（配置变更与破坏性改动）
+
+- 站点 Brand 的 GitHub 数据区改为显式读取 `leftbar.brand.ghuser`，默认 `null` 不显示；不再从 ghuser Widget 的 username 推断。需要保留统计时设置 `leftbar.brand.ghuser: 你的GitHub用户名`。该数据区仍仅在左栏 regular 样式下显示，Collection Brand 的仓库统计保持原有来源。
+
+Full Changelog: [2.0.0-rc.3...2.0.0-rc.4](https://github.com/xaoxuu/hexo-theme-stellar/compare/2.0.0-rc.3...2.0.0-rc.4)
+
+## 2.0.0-rc.3
+
+> 发布日期：2026-09-10
+
+本节记录从公开候选 `2.0.0-rc.2` 到 `2.0.0-rc.3` 最终文件树的净变化。
+
+### 新功能
+
+- 默认启用同集合局部导航：外壳兼容时更新正文、右栏和页面元数据，保留导航区域；支持历史滚动恢复，不兼容页面或请求失败时整页跳转。
+- 图片尺寸与 HSLA 平均色在 server/generate 时自动增量提取并持久缓存，补全生成 HTML，不修改 Markdown 或原图；新增 `hexo stellar images` 及 `--dry-run/--page/--refresh` 选项。
+- Markdown 文本链接、文章参考链接、远程 Markdown 与评论链接支持站点图标增强；站点信息支持 `appicon/favicon`，保留 `icon` 回退，行内请求失败显示断链图标。
+- 新增字体平滑与设计字重映射；卡片 Spotlight 与 Tilt 可独立开关。
+- 第三方 JS/CSS 地址可在对应搜索、评论、Feature 或 Markdown 服务配置中覆盖；Artalk 默认使用服务端配套资源。
+
+### 修复与改进
+
+- 共享 Collection 模型并隔离构建缓存，复用 PageViewModel 和归档文章投影，减少重复解析与校验；忽略 Collection 目录中的 macOS `.DS_Store` 文件。
+- 完善 Extension 的页面／文档作用域、异步取消及卸载清理；修复 Flying Pages 初始化、图片懒加载与 Safari 错误占位时序，Reveal 待入场透明度在卸载时恢复。
+- 修复文章上下篇、作者页 Topic 文章与作者横幅；Topic 文章默认继承全局分享配置，Wiki 与 Notebook 仍默认关闭分享。
+- Doctor 与构建统一恢复可用的配置：普通字段问题和不适用的表现参数给出 warning，缺少集合显示名时使用 Collection ID；根结构与归属冲突仍阻止构建。
+- 本地搜索按章节组织结果并分批查询、渲染，改进摘要、高亮、加载更多和结束提示。
+- 调整 minimal 外观、暗色背景、移动导航、品牌、目录吸顶与当前条目滚动；修复 Markdown Widget 背景、稀疏 Wiki 网格宽度、画廊列数以及轮播、图片标签、头像、MBTI 卡片的比例与布局。
+- GitHub 卡片默认服务切换为 `https://github-stats-extended.vercel.app`；图片颜色处理新增 Sharp 直接依赖。
+
+### 升级注意（配置变更与破坏性改动）
+
+- 将 `footer.sections` 改为 `footer.sitemap`；分组保留 `title/items`，但 items 中的 `{title, url}` 对象需改写为 `'[标题](地址)'` Markdown 字符串。默认 sitemap 为空数组；默认页脚正文新增 CC BY-NC-SA 4.0 说明，可自行覆盖 `footer.content`。
+- 将 `features.card_hover.enabled` 替换为独立的 `spotlight` 与 `tilt` 布尔值；希望保持原先全部开启效果时两项均设为 `true`，默认均为 `false`。
+- `features.partial_navigation.enabled` 默认开启，含非主题管理可执行脚本的页面使用整页导航；需要全部整页跳转时将其关闭。
+- `features.image_optimization.enabled` 默认开启，首次处理远程图片可能增加构建时间；关闭后仍复用站点 `source/_data/caches/images_metadata.json`。`features.lazy_loading.auto_aspect_ratio` 继续控制尺寸／比例补全。
+- 第三方资源覆盖不保证任意上游 API 版本兼容；KaTeX 自定义 CSS 时需配套更新 `css_integrity`，或设为 `null` 不附加 SRI。仅覆盖 CSS 地址时会清除继承的旧哈希。
+
+Full Changelog: [2.0.0-rc.2...2.0.0-rc.3](https://github.com/xaoxuu/hexo-theme-stellar/compare/2.0.0-rc.2...2.0.0-rc.3)
+
 ## 2.0.0-rc.2
 
 > 发布日期：2026-09-07
@@ -56,7 +111,7 @@ Full Changelog: [2.0.0-rc.1...2.0.0-rc.2](https://github.com/xaoxuu/hexo-theme-s
 - 浏览器后处理必须原样保留 `public/js/runtime/**/*.js` 的 ESM 语义、相对 import 与 JavaScript MIME 类型。
 - v2 当前源码从仓库 `main` 安装并需要执行 `npm install --prefix themes/stellar`；npm 包是否为 v2 以实际公开版本为准。
 
-Full Changelog: [1.44.0...main](https://github.com/xaoxuu/hexo-theme-stellar/compare/1.44.0...main)
+Full Changelog: [1.44.0...2.0.0-rc.1](https://github.com/xaoxuu/hexo-theme-stellar/compare/1.44.0...2.0.0-rc.1)
 
 ## 1.44.0
 

package/_config.yml

@@ -40,6 +40,8 @@ leftbar:
   brand:
     # 设置 Leftbar Brand 的视觉样式；可选值为 regular 或 compact。
     style: regular
+    # 设置站点 Brand 数据区的 GitHub 用户名；留空不显示。
+    ghuser: null
     # 配置品牌图片。
     image:
       # 设置品牌图片地址；null 表示隐藏图片。
@@ -128,10 +130,35 @@ rightbar:
 
 # 配置主内容区页脚。
 footer:
-  # 设置页脚正文，支持 Markdown 与主题模板变量；空字符串表示隐藏正文。
-  content: 本站由 [{author.name}](/) 使用 [{theme.name} {theme.version}]({theme.tree}) 主题创建。
   # 设置主内容区页脚导航分栏；空数组表示不显示分栏。
-  sections: []
+  sitemap: []
+    # - title: 博客
+    #   items:
+    #     - '[近期发布](/)'
+    #     - '[分类](/blog/categories/)'
+    #     - '[标签](/blog/tags/)'
+    #     - '[归档](/blog/archives/)'
+    # - title: 项目
+    #   items:
+    #     - '[xxx](/)'
+    #     - '[xxx](/)'
+    #     - '[xxx](/)'
+    #     - '[xxx](/)'
+    # - title: 社交
+    #   items:
+    #     - '[xxx](/)'
+    #     - '[xxx](/)'
+    #     - '[xxx](/)'
+    #     - '[xxx](/)'
+    # - title: 关于
+    #   items:
+    #     - '[xxx](/)'
+    #     - '[xxx](/)'
+    #     - '[xxx](/)'
+    #     - '[xxx](/)'
+  content: | # 支持 Markdown 格式
+    本站由 [{author.name}](/) 使用 [{theme.name} {theme.version}]({theme.tree}) 主题创建。
+    本博客所有文章除特别声明外，均采用 [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/) 许可协议，转载请注明出处。
 
 # 配置各页面与内容 Profile 的专属设置、路由、导航和 Region 默认值；省略字段时继承站点级 Region。
 profiles:
@@ -457,7 +484,7 @@ article:
   footer:
     # 设置文章许可协议；false 表示不显示许可信息。
     license: 本文采用 [署名-非商业性使用-相同方式共享 4.0 国际](https://creativecommons.org/licenses/by-nc-sa/4.0/) 许可协议，转载请注明出处。
-    # 设置文章分享服务；普通博客默认全部启用，Collection 内容页默认关闭，可通过 footer.share 显式开启。
+    # 设置文章分享服务；普通博客与 Topic 专栏博客默认全部启用，Wiki 与 Notebook 默认关闭，可通过 footer.share 显式开启。
     # 支持 wechat、weibo、x、telegram、whatsapp、email、link、system；空数组表示不显示分享入口。
     share:
       - wechat
@@ -500,6 +527,20 @@ appearance:
 
   # 配置全站排版。
   typography:
+    # 设置全站 -webkit-font-smoothing；可选值为 auto、none 或 antialiased。
+    font_smoothing: antialiased
+    # 将设计字重映射到字体实际提供的字重；例如将 500 改为 600。
+    # 映射只执行一次，目标值范围为 1–1000。
+    font_weight:
+      100: 100
+      200: 200
+      300: 300
+      400: 400
+      500: 500
+      600: 600
+      700: 700
+      800: 800
+      900: 900
     # 配置字体族。
     font_family:
       # 设置正文的字体候选列表。
@@ -614,6 +655,8 @@ search:
     cache_ttl_seconds: 86400
   # 配置 Algolia 搜索参数。
   algolia:
+    # 自定义资源地址；null 使用主题默认资源。
+    js: https://gcore.jsdelivr.net/algoliasearch/3/algoliasearch.min.js
     # 设置 Algolia Application ID。
     appId: null
     # 设置 Algolia Search API Key。
@@ -629,6 +672,8 @@ comments:
   title: null
   # 配置 Beaudar 参数，字段会传递给 Beaudar 客户端。
   beaudar:
+    # 自定义资源地址；null 使用主题默认资源。
+    js: https://beaudar.lipk.org/client.js
     # 设置关联的 GitHub 仓库，格式为 owner/repo。
     repo: xxx/xxx
     # 设置 Issue 映射方式。
@@ -651,6 +696,8 @@ comments:
     branch: main
   # 配置 Utterances 参数，字段会传递给 Utterances 客户端。
   utterances:
+    # 自定义资源地址；null 使用主题默认资源。
+    js: https://utteranc.es/client.js
     # 设置关联的 GitHub 仓库，格式为 owner/repo。
     repo: xxx/xxx
     # 设置 Issue 映射方式。
@@ -663,6 +710,8 @@ comments:
     label: null
   # 配置 Giscus 参数，字段会作为 data 属性传递给 Giscus 客户端。
   giscus:
+    # 自定义资源地址；null 使用主题默认资源。
+    js: https://giscus.app/client.js
     # 设置关联的 GitHub 仓库，格式为 owner/repo。
     data-repo: xxx/xxx
     # 设置 Giscus 仓库 ID；null 表示未配置。
@@ -691,10 +740,18 @@ comments:
     crossorigin: anonymous
   # 配置 Twikoo 参数，字段会传递给 Twikoo 客户端。
   twikoo:
+    # 自定义资源地址；null 使用主题默认资源。
+    js: https://gcore.jsdelivr.net/npm/twikoo@1.6/dist/twikoo.all.min.js
     # 设置 Twikoo 环境 ID 或服务地址。
     envId: https://xxx
   # 配置 Waline 参数，字段会传递给 Waline 客户端。
   waline:
+    # 自定义资源地址；null 使用主题默认资源。
+    js: https://gcore.jsdelivr.net/npm/@waline/client@3.15.2/dist/waline.js
+    # 自定义资源地址；null 使用主题默认资源。
+    css: https://gcore.jsdelivr.net/npm/@waline/client@3.15.2/dist/waline.css
+    # 自定义资源地址；null 使用主题默认资源。
+    meta_css: https://gcore.jsdelivr.net/npm/@waline/client@3.15.2/dist/waline-meta.css
     # 设置 Waline 服务端地址。
     serverURL: https://waline.vercel.app
     # 控制是否启用评论计数。
@@ -703,6 +760,10 @@ comments:
     pageview: false
   # 配置 Artalk 参数，字段会传递给 Artalk 客户端。
   artalk:
+    # 自定义资源地址；null 使用服务端内置的配套资源。
+    js: null
+    # 自定义资源地址；null 使用服务端内置的配套资源。
+    css: null
     # 设置 Artalk 服务端地址；null 表示未配置。
     server: null
     # 设置 Artalk 站点名称；空字符串表示未配置。
@@ -785,24 +846,45 @@ tags:
 
 # 配置可选的浏览器功能。
 features:
+  # 同集合内容页面只更新正文和右栏；不兼容的页面自动整页跳转。
+  partial_navigation:
+    enabled: true
+  # 配置轮播使用的第三方资源；不改变按需加载条件。
+  swiper:
+    # 自定义脚本地址；null 使用默认资源。
+    js: https://unpkg.com/swiper@10.3/swiper-bundle.min.js
+    # 自定义样式地址；null 使用默认资源。
+    css: https://unpkg.com/swiper@10.3/swiper-bundle.min.css
   # 配置配色模式切换功能。
   color_scheme_switch:
     # 控制是否启用配色模式切换。
     enabled: false
+  # 自动优化图片体验：增量提取尺寸与平均色，不压缩或替换原图。
+  image_optimization:
+    # server/generate 自动补齐缺失元数据；关闭后仍复用已有结果，手动 images 命令可用。
+    enabled: true
   # 配置图片懒加载。
   lazy_loading:
+    # 自定义资源地址；null 使用主题默认资源。
+    js: https://gcore.jsdelivr.net/npm/vanilla-lazyload@19.1/dist/lazyload.min.js
     # 设置懒加载过渡效果；可选值为 blur 或 fade。
     transition: fade
-    # 控制是否自动补全图片宽高比。
+    # 从站点图片元数据补全尺寸与比例；server/generate 自动增量预处理，不修改 Markdown。
     auto_aspect_ratio: true
   # 配置图片灯箱。
   lightbox:
+    # 自定义资源地址；null 使用主题默认资源。
+    js: https://gcore.jsdelivr.net/npm/@fancyapps/ui@5.0/dist/fancybox/fancybox.umd.js
+    # 自定义资源地址；null 使用主题默认资源。
+    css: https://gcore.jsdelivr.net/npm/@fancyapps/ui@5.0/dist/fancybox/fancybox.css
     # 控制是否启用图片灯箱。
     enabled: true
     # 设置灯箱匹配图片的 CSS 选择器。
     selector: '.timenode p>img'
   # 配置链接预取。
   link_prefetch:
+    # 自定义资源地址；null 使用主题默认资源。
+    js: https://gcore.jsdelivr.net/npm/flying-pages@2/flying-pages.min.js
     # 控制是否启用链接预取。
     enabled: true
   # 配置滚动揭示动画。
@@ -811,10 +893,16 @@ features:
     enabled: true
   # 配置卡片悬停效果。
   card_hover:
-    # 控制是否启用卡片悬停效果。
-    enabled: false
+    # 控制是否启用鼠标跟随光照。
+    spotlight: false
+    # 控制是否启用 3D 倾斜。
+    tilt: false
   # 配置 Heti 中文排版增强。
   heti:
+    # 自定义资源地址；null 使用主题默认资源。
+    js: https://unpkg.com/heti@0.9/umd/heti-addon.min.js
+    # 自定义资源地址；null 使用主题默认资源。
+    css: https://unpkg.com/heti@0.9/umd/heti.min.css
     # 控制是否启用 Heti。
     enabled: false
   # 配置数学公式渲染。
@@ -822,15 +910,23 @@ features:
     # 设置数学公式 Provider；可选值为 katex、mathjax 或 null。
     provider: null
     # 设置 KaTeX 参数；空对象表示使用 Provider 默认参数。
-    katex: {}
+    katex:
+      # 自定义资源地址；null 使用主题默认资源。
+      css: https://cdn.jsdelivr.net/npm/katex@0.16.23/dist/katex.min.css
+      # CSS 的配套完整性哈希；null 不附加 SRI，自定义 CSS 时请同时提供匹配哈希。
+      css_integrity: sha384-//SZkxyB7axjCAopkAL1E1rve+ZSPKapD89Lo/lLhcsXR+zOYl5z6zJZEFXil+q0
     # 设置 MathJax 参数；空对象表示使用 Provider 默认参数。
-    mathjax: {}
+    mathjax:
+      # 自定义资源地址；null 使用主题默认资源。
+      js: https://cdnjs.cloudflare.com/ajax/libs/mathjax/3.2.2/es5/tex-mml-chtml.min.js
   # 配置图表渲染。
   diagrams:
     # 设置图表 Provider；可选值为 mermaid 或 null。
     provider: null
     # 配置 Mermaid 参数。
     mermaid:
+      # 自定义资源地址；null 使用主题默认资源。
+      js: https://gcore.jsdelivr.net/npm/mermaid@11/dist/mermaid.min.js
       # 设置 Mermaid 主题；可选值为 default、dark、forest 或 neutral。
       theme: neutral
 
@@ -840,6 +936,10 @@ features:
 
 # 配置主题使用的数据服务。
 services:
+  # 配置所有动态 Markdown 内容共享的 Marked 客户端。
+  markdown:
+    # 自定义脚本地址；null 使用默认资源。
+    js: https://gcore.jsdelivr.net/npm/marked@13.0/lib/marked.umd.min.js
   # 配置站点信息服务。
   site_info:
     # 设置站点信息 Provider；可选值为 site_info_api 或 null。
@@ -879,7 +979,7 @@ services:
     # 配置 github_readme_stats Provider。
     github_readme_stats:
       # 设置 GitHub 卡片接口地址。
-      endpoint: https://github-readme-stats.vercel.app
+      endpoint: https://github-stats-extended.vercel.app
   # 配置 GitHub 基础服务地址。
   github:
     # 设置 GitHub API 地址。

package/languages/en.yml

@@ -84,6 +84,7 @@ search:
   scope_all: All
   scope_blog: Blog
   no_results: No Results!
+  no_more: No more results
   close: Close search
 
 settings:

package/languages/zh-CN.yml

@@ -84,6 +84,7 @@ search:
   scope_all: 全站
   scope_blog: 博客
   no_results: 没有找到内容！
+  no_more: 没有更多了
   close: 关闭搜索
 
 settings:

package/languages/zh-TW.yml

@@ -84,6 +84,7 @@ search:
   scope_all: 全站
   scope_blog: 部落格
   no_results: 沒有找到內容！
+  no_more: 沒有更多了
   close: 關閉搜尋
 
 settings:

package/layout/_partial/comments/beaudar/layout.ejs

@@ -4,7 +4,7 @@ function layoutDiv() {
   const cmt = comments;
   if (cmt && cmt.service && (cmt.service.length > 0)) {
     const name = cmt.service;
-    const body = cmt.options;
+    var body = cmt.options;
     el += '<div id="' + name + '"';
     for (let key of Object.keys(body)) {
       if (body[key] !== null) {

package/layout/_partial/comments/giscus/layout.ejs

@@ -4,7 +4,7 @@ function layoutDiv() {
   const cmt = comments;
   if (cmt?.service?.length > 0) {
     const name = cmt.service;
-    var body = Object.assign({}, cmt.options);
+    var body = cmt.options;
     el += '<div id="' + name + '"';
     for (let key of Object.keys(body)) {
       if (body[key] !== null) {

package/layout/_partial/comments/utterances/layout.ejs

@@ -4,7 +4,7 @@ function layoutDiv() {
   const cmt = comments;
   if (cmt && cmt.service && (cmt.service.length > 0)) {
     const name = cmt.service;
-    const body = cmt.options;
+    var body = cmt.options;
     el += '<div id="' + name + '"';
     for (let key of Object.keys(body)) {
       if (body[key] !== null) {

package/layout/_partial/cover/wiki_cover.ejs

@@ -32,6 +32,7 @@ function layoutWikiCover() {
   var effectPresentation = effect.presentation && typeof effect.presentation === 'object' && !Array.isArray(effect.presentation) ? effect.presentation : {};
   var effectBackground = typeof effectPresentation.background === 'string' ? effectPresentation.background : '#000000';
   var respectsReducedMotion = effectRuntime.respectReducedMotion !== false;
+  var effectResourceJson = escape_html(JSON.stringify(hero_effect_resource(effect.type)));
   var effectOptionsJson = escape_html(JSON.stringify(effectOptions));
   var effectRuntimeJson = escape_html(JSON.stringify(effectRuntime));
   var projectName = cover.projectName;
@@ -49,7 +50,7 @@ function layoutWikiCover() {
     el += '<img class="wiki-cover-background-blur" src="' + escape_html(background) + '" alt="" />';
   }
   if (hasEffect) {
-    el += '<canvas data-hero-effect="' + escape_html(effect.type) + '" data-effect-options="' + effectOptionsJson + '" data-effect-runtime="' + effectRuntimeJson + '"></canvas>';
+    el += '<canvas data-hero-effect="' + escape_html(effect.type) + '" data-effect-resource="' + effectResourceJson + '" data-effect-options="' + effectOptionsJson + '" data-effect-runtime="' + effectRuntimeJson + '"></canvas>';
   }
   el += '<div class="wiki-cover-background-overlay"></div></div>';
   el += '<div class="wiki-cover-layout"' + adaptiveTextAttr + '>';

package/layout/_partial/head.ejs

@@ -14,6 +14,12 @@ var stellarResources = {
   fallbacks: stellar_config('fallbacks')
 }
 
+function cssString(value) {
+  return '"' + String(value).replace(/["\\<\u0000-\u001f]/g, function(character) {
+    return '\\' + character.codePointAt(0).toString(16) + ' ';
+  }) + '"';
+}
+
 function generate_title() {
   if (pageRender) {
     return pageRender.seo.title
@@ -185,8 +191,8 @@ function generate_canonical() {
   <%- custom_inject('headBegin') %>
   <meta charset="utf-8">
   <meta name="hexo-theme" content="<%- stellar_info('tree') %>" theme-name="<%- stellar_info('name') %>" theme-version="<%- stellar_info('version') %>">
-  <%- generate_canonical() %>
-  <%- generate_robots() %>
+  <%- page_meta(generate_canonical()) %>
+  <%- page_meta(generate_robots()) %>
   <%- meta_generator() %>
   <meta http-equiv='x-dns-prefetch-control' content='on' />
   <%- preconnect() %>
@@ -198,11 +204,11 @@ function generate_canonical() {
   <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1">
   <meta name="theme-color" media="(prefers-color-scheme: dark)" content="#000">
   <meta name="theme-color" content="#f9fafb">
-  <title><%- generate_title() %></title>
-  <script>
+  <title data-stellar-page-meta><%- generate_title() %></title>
+  <script data-stellar-script="core">
     (function () {
       var key = 'stellar:v2:leftbar-state';
-      var fallback = <%- JSON.stringify(stellar_config('leftbar.defaultState')) %>;
+      var fallback = <%- script_json(stellar_config('leftbar.defaultState')) %>;
       try {
         var value = localStorage.getItem(key);
         document.documentElement.dataset.leftbarState = value === 'collapsed' || value === 'expanded' ? value : fallback;
@@ -212,10 +218,10 @@ function generate_canonical() {
     })();
   </script>
 
-  <%- render_open_graph() %>
-  <%- generate_description() %>
+  <%- page_meta(render_open_graph()) %>
+  <%- page_meta(generate_description()) %>
   
-  <%- generate_keywords() %>
+  <%- page_meta(generate_keywords()) %>
 
   <!-- feed -->
   <% if (config.feed && config.feed.path) { %>
@@ -234,7 +240,7 @@ function generate_canonical() {
 
   <link rel="preload" href="<%- url_for(`${stellar_info('main_css')}?v=${stellar_info('version')}`) %>" as="style">
   <link rel="stylesheet" href="<%- url_for(`${stellar_info('main_css')}?v=${stellar_info('version')}`) %>">
-  <style>:root{--text-loading:<%- JSON.stringify(__('message.loading')) %>;--text-loading-error:<%- JSON.stringify(__('message.loading_failed')) %>}</style>
+  <style>:root{--text-loading:<%- cssString(__('message.loading')) %>;--text-loading-error:<%- cssString(__('message.loading_failed')) %>}</style>
 
 
   <% if (config.favicon) { %>
@@ -247,7 +253,7 @@ function generate_canonical() {
     <% } %>
   <% } %>
 
-  <%- json_ld(pageViewModel || undefined) %>
+  <%- page_meta(json_ld(pageViewModel || undefined)) %>
   <%- custom_inject('headEnd') %>
 
   <!-- icons.yml 驱动的 CSS 装饰图标 -->

package/layout/_partial/main/article/post_footer.ejs

@@ -1,7 +1,7 @@
 <%
 function referenceList(items) {
   return items.map(function(ref) {
-    return `<li class="post-title">${markdown(ref)}</li>`
+    return `<li class="post-title">${enhance_md_links(markdown(ref))}</li>`
   }).join('')
 }
 

package/layout/_partial/main/article/post_read_next.ejs

@@ -3,7 +3,10 @@ function itemHtml(id, item, label) {
   var el = `<div class="item" id="${id}">`
   if (item) {
     var title = item.title || (item.date ? date(item.date, config.date_format) : '')
-    el += `<div class="note">${label}</div>`
+    var note = id === 'prev'
+      ? `${icon('default:arrow-left')} ${label}`
+      : `${label} ${icon('default:arrow-right')}`
+    el += `<div class="note">${note}</div>`
     el += `<a href="${pretty_url(item.path)}">${escape_html(title)}</a>`
   }
   return el + '</div>'

package/layout/_partial/main/footer.ejs

@@ -6,18 +6,18 @@ function layoutDiv() {
   el += `<footer class="page-footer${scrollreveal(' ')} footnote">`
   el += '<hr>'
   // sitemap
-  var sections = siteFooter.sections
-  if (sections.length > 0) {
-    var count = sections.length
+  var sitemap = siteFooter.sitemap
+  if (sitemap.length > 0) {
+    var count = sitemap.length
     if ([6].includes(count)) {
       count = 3
     } else if ([7,8].includes(count)) {
       count = 4
     } else {
-      count = Math.min(sections.length, 5)
+      count = Math.min(sitemap.length, 5)
     }
     el += `<div class="sitemap" style="column-count:${count};">`
-    for (var group of sections) {
+    for (var group of sitemap) {
       var title = escape_html(group.title)
       var items = group.items
       if (items == undefined || items.length == 0) {
@@ -25,9 +25,9 @@ function layoutDiv() {
       }
       el += '<div class="sitemap-group">'
       el += '<span class="fs15">' + title + '</span>'
-      items.forEach((item, i) => {
-        el += '<a href="' + escape_html(url_for(item.url)) + '">'
-        el += escape_html(__(item.title))
+      items.forEach((item) => {
+        el += '<a href="' + escape_html(url_for(md_link(item))) + '">'
+        el += __(md_text(item))
         el += '</a>'
       });
       el += '</div>'

package/layout/_partial/main/listing_nav/blog.ejs

@@ -41,7 +41,8 @@ function layoutDiv() {
     }
   }
 
-  if (stellar_data('topic')?.publish_list?.length > 0) {
+  var topicItems = stellar_data('topicIndex.items');
+  if (Array.isArray(topicItems) && topicItems.length > 0) {
     if (page.layout == 'index_topic') {
       el += '<a class="active" href="' + pretty_url(stellar_config('profiles.topic.path')) + '">' + __("btn.topic") + '</a>';
     } else {

package/layout/_partial/main/navbar/article_banner.ejs

@@ -7,7 +7,9 @@ var postViewModel = ['post', 'topic'].includes(renderViewModel?.collection?.prof
 var wikiViewModel = renderViewModel?.collection?.profile === 'wiki' ? renderViewModel : null
 var notebookViewModel = renderViewModel?.collection?.profile === 'notebook' ? renderViewModel : null
 var pageConfig = content_config(page)
-var banner = Object.assign({}, wikiViewModel
+var banner = Object.assign({}, page.author
+  ? { image: page.author.banner, avatar: page.author.avatar, tagline: page.author.description }
+  : wikiViewModel
   ? wikiViewModel.render.article.banner
   : notebookViewModel
     ? notebookViewModel.render.article.banner

package/layout/_partial/main/pin_slider.ejs

@@ -137,20 +137,24 @@ if (pinItems.length > 0) {
   }
   el += '</div>'
 %>
+<script>document.documentElement.classList.add('stellar-pin-pending');</script>
 <%- el %>
 <script>
+let pinSliderCleanup;
+let pinSliderHidden = false;
 function mountPinSliderWhenReady() {
-  var cleanup = initPinSlider();
-  if (typeof cleanup === 'function') {
-    window.addEventListener('pagehide', cleanup, { once: true });
-  }
-}
-if (document.readyState === 'loading') {
-  document.addEventListener('DOMContentLoaded', mountPinSliderWhenReady, { once: true });
-} else {
-  mountPinSliderWhenReady();
+  pinSliderCleanup?.();
+  try { pinSliderCleanup = pinSliderHidden ? null : initPinSlider(); }
+  finally { document.documentElement.classList.remove('stellar-pin-pending'); }
 }
+window.addEventListener('pagehide', () => { pinSliderHidden = true; pinSliderCleanup?.(); pinSliderCleanup = null; });
+window.addEventListener('pageshow', event => { pinSliderHidden = false; if (event.persisted) mountPinSliderWhenReady(); });
+if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', mountPinSliderWhenReady, { once: true });
+else mountPinSliderWhenReady();
 function initPinSlider() {
+  let colorTimer;
+  var colorController = null;
+  var colorRevision = 0;
   var slider = document.getElementById('pin-slider');
   if (!slider) return;
   var track = slider.querySelector('.pin-slider-track');
@@ -209,24 +213,28 @@ function initPinSlider() {
   // 左右箭头颜色随当前幻灯片封面自适应（contrast：深色背景白箭头、浅色背景深箭头）
   var navColorRetries = 0;
   function updateNavColor() {
+    var revision = ++colorRevision;
+    colorController?.abort();
+    colorController = new AbortController();
     var navs = slider.querySelectorAll('.pin-slider-nav');
     if (navs.length === 0) return;
-    if (!window.stellar || !window.stellar.color || !window.resolveAdaptiveBackdrop) {
+    if (!window.stellar || !window.stellar.color?.getAverageColor) {
       // 懒加载的 color.js / 插件尚未就绪时重试
       if (navColorRetries < 25) {
         navColorRetries++;
-        setTimeout(updateNavColor, 200);
+        clearTimeout(colorTimer);
+        colorTimer = setTimeout(updateNavColor, 200);
       }
       return;
     }
     var slide = slides[index];
     if (!slide) return;
-    var cover = slide.style.getPropertyValue('--pin-cover-url');
-    if (!cover) return;
-    var m = cover.match(/url\((['"]?)(.*?)\1\)/i);
-    if (!m) return;
-    stellar.color.getAverageColor(m[2], { background: window.resolveAdaptiveBackdrop(slide) }).then(function (rgb) {
-      if (!rgb) return;
+    stellar.color.getAverageColor(slide.querySelector('.pin-slide-bg'), { signal: colorController.signal }).then(function (rgb) {
+      if (revision !== colorRevision) return;
+      if (!rgb) {
+        for (var i = 0; i < navs.length; i++) navs[i].style.removeProperty('--text-banner');
+        return;
+      }
       var color = stellar.color.adaptiveTextColor(rgb, { style: 'contrast' });
       for (var i = 0; i < navs.length; i++) {
         navs[i].style.setProperty('--text-banner', color);
@@ -278,13 +286,14 @@ function initPinSlider() {
       next();
     }
   }
-  if (dotsEl) {
-    dotsEl.addEventListener('click', function(e) {
+  const onDotClick = function(e) {
       var btn = e.target.closest ? e.target.closest('.pin-slider-dot') : null;
       if (btn) {
         goTo(parseInt(btn.getAttribute('data-index'), 10) || 0);
       }
-    });
+    };
+  if (dotsEl) {
+    dotsEl.addEventListener('click', onDotClick);
     dotsEl.addEventListener('animationend', onProgressEnd);
   }
   var navPrev = slider.querySelector('.pin-slider-nav.prev');
@@ -310,6 +319,9 @@ function initPinSlider() {
   slider.style.visibility = 'visible';
   start();
   return function() {
+    colorRevision++;
+    colorController?.abort();
+    clearTimeout(colorTimer);
     stop();
     slider.removeEventListener('mouseenter', stop);
     slider.removeEventListener('mouseleave', start);
@@ -318,6 +330,7 @@ function initPinSlider() {
     slider.removeEventListener('touchstart', onTouchStart);
     slider.removeEventListener('touchend', onTouchEnd);
     if (dotsEl) {
+      dotsEl.removeEventListener('click', onDotClick);
       dotsEl.removeEventListener('animationend', onProgressEnd);
     }
     if (navPrev) {