hexo-theme-stellar 1.34.0 → 1.35.0

package/_config.yml

@@ -1,6 +1,6 @@
 ######## Stellar info ########
 stellar:
-  version: '1.34.0'
+  version: '1.35.0'
   homepage: 'https://xaoxuu.com/wiki/stellar/'
   repo: 'https://github.com/xaoxuu/hexo-theme-stellar'
   main_css: /css/main.css
@@ -537,15 +537,6 @@ plugins:
     service: flying_pages # flying_pages
     flying_pages: https://gcore.jsdelivr.net/npm/flying-pages@2/flying-pages.min.js
 
-  # pjax - 无刷新加载
-  # 启用后点击链接将使用 AJAX 加载内容，无需整页刷新
-  pjax:
-    enable: false # 还在测试中，可能存在兼容问题
-    selectors: ['title', '#l_cover', '.l_body'] # 需要替换的元素选择器
-    timeout: 10000 # 请求超时时间（毫秒）
-    cacheBust: false # 是否添加时间戳防止缓存
-    translate-distance: 8px # 动画
-
   # https://fancyapps.com/docs/ui/fancybox/
   # available for {% image xxx %}
   fancybox:

package/layout/_partial/head.ejs

@@ -139,9 +139,6 @@ function generate_canonical() {
     if (path.startsWith('/404') || path.startsWith('404')) {
       return '';
     }
-    if (path.endsWith('.html') && path.length > 5) {
-      path = path.split('.html')[0];
-    }
     return `<link rel="canonical" href="https://${originalHost}${path}">`;
   }
   return '';

package/layout/_partial/scripts/utils.ejs

@@ -146,29 +146,12 @@
       document.head.appendChild(script)
     }),
 
-    // PJAX 事件监听器管理
-    _pjaxListeners: new Set(),
-    
-    jq: (fn, pjax = true) => {
+    jq: (fn) => {
       if (typeof jQuery === 'undefined') {
         utils.js(deps.jquery).then(fn)
       } else {
         fn()
       }
-      if (pjax && !fn._pjax_registered) {
-        document.addEventListener('pjax:complete', fn);
-        fn._pjax_registered = true;
-        utils._pjaxListeners.add(fn); // 追踪监听器以便清理
-      }
-    },
-    
-    // 清理所有 PJAX 事件监听器
-    cleanupPjaxListeners: () => {
-      utils._pjaxListeners.forEach(fn => {
-        document.removeEventListener('pjax:complete', fn);
-        fn._pjax_registered = false;
-      });
-      utils._pjaxListeners.clear();
     },
 
     onLoading: (el) => {
@@ -334,20 +317,6 @@
       }
     },
 
-    // 重新初始化所有插件（用于 PJAX 等场景）
-    reinitPlugins: () => {
-      utils._pluginInitializers.forEach(plugin => {
-        // 跳过标记为不需要重新初始化的插件
-        if (plugin.options.skipReinit) return;
-        
-        try {
-          plugin.fn();
-        } catch (error) {
-          console.error(`[Plugin ${plugin.name}] 重新初始化失败:`, error);
-        }
-      });
-    },
-    
     // 清理所有插件资源
     cleanupPlugins: () => {
       utils._pluginCleanups.forEach((cleanup, name) => {
@@ -363,21 +332,9 @@
     // 清理所有资源（用于页面卸载或重置）
     cleanupAll: () => {
       utils.cleanupPlugins();
-      utils.cleanupPjaxListeners();
     },
   };
 
-  // 自动处理 PJAX 事件
-  document.addEventListener('pjax:before', () => {
-    // 在导航前清理旧的 PJAX 监听器（如果需要重新注册）
-    // 注意：这里不清理，因为监听器应该是持久的
-    // utils.cleanupPjaxListeners();
-  });
-  
-  document.addEventListener('pjax:complete', () => {
-    utils.reinitPlugins();
-  });
-
   // utils.dark.mode 当前模式 dark or light
   // utils.dark.toggle() 暗黑模式触发器
   // utils.dark.push(callBack[,"callBackName"]) 传入触发器回调函数

package/layout/layout.ejs

@@ -69,7 +69,6 @@ if (theme.style.prefers_theme === 'auto') {
     html += `<div class="scripts">`
       html += partial('_partial/scripts')
     html += `</div>`
-    html += `<div class="page-loading-bar"><img src="${theme.default.loading}"></div>`
   html += `</body>`
 html += `</html>`
 %>

package/package.json

@@ -1,10 +1,12 @@
 {
   "name": "hexo-theme-stellar",
-  "version": "1.34.0",
+  "version": "1.35.0",
   "description": "Elegant and powerful theme for Hexo.",
   "main": "package.json",
   "scripts": {
-    "test": "echo test"
+    "test": "echo test",
+    "release": "node release.js",
+    "release:dry": "node release.js --dry-run"
   },
   "repository": {
     "type": "git",

package/scripts/events/index.js

@@ -3,6 +3,8 @@
 'use strict';
 
 hexo.on('generateBefore', () => {
+  // 页面路径归一化：xxx.html → xxx/，必须先于所有读取 page.path 的逻辑
+  require('./lib/path_normalize')(hexo);
   // Merge config.
   require('./lib/config')(hexo);
   require('./lib/links')(hexo);
@@ -65,4 +67,3 @@ hexo.extend.filter.register('before_generate', async () => {
   }
 });
 
-

package/scripts/events/lib/doc_tree.js

@@ -4,13 +4,15 @@
 
 'use strict';
 
+const { normalize_path } = require('../../lib/path_utils');
+
 class WikiPage {
   constructor(page) { 
     this.id = page._id
     this.wiki = page.wiki
     this.title = page.title
     this.path = page.path
-    this.path_key = page.path.replace('.html', '')
+    this.path_key = normalize_path(page.path)
     this.layout = page.layout
     this.updated = page.updated
   }
@@ -107,7 +109,7 @@ module.exports = ctx => {
       for (let id of Object.keys(item.tree)) {
         const sec = item.tree[id]
         for (let key of sec) {
-          let hs = sub_pages.filter(p => p.path_key == item.base_dir + key)
+          let hs = sub_pages.filter(p => p.path_key == normalize_path(item.base_dir + key))
           if (hs.length > 0) {
             homepage = hs[0]
             break
@@ -134,8 +136,9 @@ module.exports = ctx => {
       for (let title of Object.keys(item.tree)) {
         var sec = { title: title, pages: []}
         for (let key of item.tree[title]) {
-          sec.pages = sec.pages.concat(sub_pages.filter(p => p.path_key == item.base_dir + key))
-          others = others.filter(p => p.path_key != item.base_dir + key)
+          const pagePathKey = normalize_path(item.base_dir + key)
+          sec.pages = sec.pages.concat(sub_pages.filter(p => p.path_key == pagePathKey))
+          others = others.filter(p => p.path_key != pagePathKey)
         }
         sections.push(sec)
       }

package/scripts/events/lib/merge_posts.js

@@ -5,6 +5,8 @@
 
 'use strict';
 
+const { normalize_path } = require('../../lib/path_utils');
+
 class RelatedPage {
   constructor(page) { 
     this.id = page._id
@@ -12,7 +14,7 @@ class RelatedPage {
     this.topic = page.topic
     this.title = page.title
     this.path = page.path
-    this.path_key = page.path.replace('.html', '')
+    this.path_key = normalize_path(page.path)
     this.layout = page.layout
     this.date = page.date
     this.updated = page.updated

package/scripts/events/lib/notebooks.js

@@ -4,6 +4,8 @@
 
 'use strict'
 
+const { normalize_path } = require('../../lib/path_utils');
+
 class NotePage {
   constructor(page) {
     this.id = page._id
@@ -11,7 +13,7 @@ class NotePage {
     this.title = page.title
     this.tags = page.tags
     this.path = page.path
-    this.path_key = page.path.replace('.html', '')
+    this.path_key = normalize_path(page.path)
     this.layout = page.layout
     this.date = page.date
     this.updated = page.updated || page.date
@@ -39,8 +41,8 @@ function prepareNotebook(id, info, ctx) {
     if (notebook.base_dir.startsWith('/')) {
       notebook.base_dir = notebook.base_dir.substring(1)
     }
-    if (notebook.base_dir.endsWith('/')) {
-      notebook.base_dir = notebook.base_dir.substring(0, notebook.base_dir.length - 1)
+    if (notebook.base_dir.length > 1 && !notebook.base_dir.endsWith('/')) {
+      notebook.base_dir = notebook.base_dir + '/'
     }
   } else {
     const notebooksBaseDir = ctx.theme.config.site_tree.notebooks.base_dir

package/scripts/events/lib/path_normalize.js

@@ -0,0 +1,22 @@
+'use strict';
+
+/**
+ * 页面路径归一化：将 xxx.html 归一为目录形式 xxx/
+ * 必须在 generateBefore 最早阶段执行（先于 doc_tree / notebooks 等读取 page.path），
+ * 直接改写 Page model 存储，保证 page.permalink、JSON-LD、sitemap、search.json
+ * 与 canonical（尾斜杠格式）一致。
+ */
+module.exports = ctx => {
+  const data = ctx.model('Page').data || {}
+  Object.values(data).forEach(page => {
+    if (!page || typeof page.path !== 'string') {
+      return
+    }
+    if (page.layout === false || page.layout === 'false') {
+      return
+    }
+    if (page.path.endsWith('.html') && !page.path.endsWith('/index.html')) {
+      page.path = page.path.replace(/\.html$/, '/')
+    }
+  })
+}

package/scripts/generators/search.js

@@ -2,6 +2,7 @@
  * https://github.com/wzpan/hexo-generator-search
  */
 const { stripHTML } = require('hexo-util')
+const { normalize_path } = require('../lib/path_utils')
 
 hexo.extend.generator.register('search_json_generator', function (locals) {
   if (this.theme.config.search.service != 'local_search') { return {} }
@@ -28,7 +29,8 @@ hexo.extend.generator.register('search_json_generator', function (locals) {
       temp_post.title = post.title.trim()
     }
     if (post.path) {
-      temp_post.path = root + post.path
+      const path = normalize_path(root + post.path)
+      temp_post.path = path === '/' ? '/' : path + '/'
     }
     if (cfg.content != false && post.content) {
       var content = stripHTML(post.content.replace(/<span class="line">\d+<\/span>/g, '')).trim()

package/scripts/helpers/json_ld.js

@@ -75,7 +75,8 @@ hexo.extend.helper.register('json_ld', function(args) {
 
   } else if (isPage || this.is_home()) {
 
-    const url = this.is_home() ? config.url : this.pretty_url(page.permalink);
+    // 首页 URL 归一为带尾斜杠形式，与 canonical 保持一致
+    const url = this.is_home() ? config.url.replace(/\/?$/, '/') : this.pretty_url(page.permalink);
     schema = {
       '@context': 'https://schema.org',
       '@type': 'Website',
@@ -119,4 +120,4 @@ hexo.extend.helper.register('json_ld', function(args) {
   }
 
   return `<script type="application/ld+json">${JSON.stringify(schema)}</script>`;
-});
+});

package/scripts/helpers/pretty_url.js

@@ -1,22 +1,21 @@
 'use strict';
 
+const { normalize_path } = require('../lib/path_utils');
+
+hexo.extend.helper.register('normalize_path', function (path = '') {
+  return normalize_path(path);
+});
+
 hexo.extend.helper.register('pretty_url', function (path = '') {
   if (path.startsWith('http://') || path.startsWith('https://')) {
-    // 如果是绝对 URL，直接返回
     return path;
   }
-  
   let url = this.url_for(path);
 
-  // 替换 /index.html → /
-  url = url.replace(/\/index\.html$/, '/');
-
-  // 替换 /about.html → /about/
-  url = url.replace(/\.html$/, '/');
+  url = normalize_path(url);
 
-  // 如果没有扩展名，并且不以 / 结尾，补一个 /
-  const hasExtension = /\.[a-zA-Z0-9]+$/.test(url);
-  if (!hasExtension && !url.endsWith('/')) {
+  // 添加尾 /（根路径 / 除外）
+  if (url !== '/') {
     url += '/';
   }
 

package/scripts/lib/path_utils.js

@@ -0,0 +1,24 @@
+'use strict';
+
+/**
+ * 统一路径规范化：去除 .html 后缀，输出无尾斜杠的干净路径（path_key 格式）
+ * 用于路径比较和匹配
+ */
+function normalize_path(path = '') {
+  if (path.startsWith('http://') || path.startsWith('https://')) {
+    return path;
+  }
+  // /index.html → /
+  path = path.replace(/\/index\.html$/, '/');
+  // 目录首页（无 .html 后缀形式，如 wiki/stellar/index）→ /
+  path = path.replace(/\/index$/, '/');
+  // /xxx.html → /xxx
+  path = path.replace(/\.html$/, '');
+  // 去除尾 /
+  if (path.length > 1 && path.endsWith('/')) {
+    path = path.slice(0, -1);
+  }
+  return path;
+}
+
+module.exports = { normalize_path };

package/source/css/_plugins/index.styl

@@ -14,9 +14,6 @@ if hexo-config('plugins.copycode.enable')
   @import 'copycode'
 if hexo-config('plugins.tianli_gpt.enable')
   @import 'tianli_gpt'
-if hexo-config('plugins.pjax.enable')
-  @import 'pjax'
-
 if hexo-config('plugins.katex.enable')
   @import 'katex'
 

package/source/js/main.js

@@ -315,7 +315,3 @@ stellar.initPage = function () {
 stellar.initPage();
 init.canonicalCheck();
 
-// Listen for PJAX navigation complete
-document.addEventListener('pjax:complete', function () {
-  stellar.initPage();
-});

package/CLAUDE.md

@@ -1,217 +0,0 @@
-# Stellar Theme Development
-
-这是 Hexo 主题 **Stellar** 的仓库。主题是一个独立的 npm 包，用于 [hexo-theme-stellar](https://github.com/xaoxuu/hexo-theme-stellar)。
-
-## 技术栈
-
-| 层级 | 技术 | 目录 |
-|------|------|------|
-| 模板引擎 | EJS | `layout/` |
-| CSS 预处理 | Stylus | `source/css/` |
-| 服务端 JS | CommonJS (ES5) | `scripts/` |
-| 浏览器 JS | ES5 (Babel 转译) | `source/js/` |
-| 国际化 | YAML | `languages/` |
-| 文档 | Markdown | `docs/` |
-
-## 目录结构
-
-```
-layout/                     # EJS 模板
-├── _partial/               #   可复用组件
-│   ├── main/               #     文章列表、导航、页脚
-│   ├── sidebar/            #     侧栏组件
-│   ├── cover/              #     封面
-│   ├── comments/           #     评论系统
-│   ├── widgets/            #     小部件
-│   └── scripts/            #     脚本注入
-├── _plugins/               #   可选插件片段
-├── layout.ejs              #   根布局
-├── index.ejs               #   首页
-├── page.ejs                #   通用页面
-└── archive.ejs             #   归档页
-scripts/                    # Hexo 服务端脚本
-├── tags/                   #   自定义标签 `{% tag %}`
-│   └── lib/                #     标签实现
-├── helpers/                #   EJS 辅助函数
-├── filters/                #   Hexo 过滤器
-├── generators/             #   页面生成器
-├── events/                 #   事件处理
-└── commands/               #   CLI 命令
-source/                     # 浏览器端资源
-├── css/                    #   Stylus 样式
-│   ├── _defines/           #     变量和函数
-│   ├── _common/            #     通用基础样式
-│   ├── _components/        #     组件样式
-│   └── _plugins/           #     插件样式
-└── js/                     #   浏览器 JavaScript
-    ├── plugins/            #     交互插件
-    ├── services/           #     数据服务
-    └── search/             #     搜索
-```
-
-## EJS 模板规范
-
-- `<% %>` 逻辑控制，`<%- %>` 输出非转义 HTML
-- 变量声明用 `var`（IE8 兼容）
-- 2 空格缩进，HTML 属性双引号
-- 可复用片段提取到 `_partial/`
-- 复杂逻辑提取到 `helpers/` 辅助函数
-
-```ejs
-<%
-var items = site.posts.sort('date', -1).limit(10)
-items.forEach(function(post) {
-%>
-  <article>
-    <%- partial('_partial/main/post_list/post_card', {post: post}) %>
-  </article>
-<%
-})
-%>
-```
-
-## Node.js 脚本规范
-
-- CommonJS: `require()` / `module.exports`
-- 文件头: `/* global hexo */` + `'use strict';`
-- 2 空格缩进，双引号，分号结尾
-- 标签注册: `hexo.extend.tag.register(name, handler, options)`
-- 辅助函数注册: `hexo.extend.helper.register(name, handler)`
-
-```js
-/* global hexo */
-'use strict';
-
-module.exports = function(hexo) {
-  return function(args, content) {
-    var result = '';
-    // ...
-    return result;
-  };
-};
-```
-
-## Stylus 样式规范
-
-- 文件引入顺序: `const` → `custom` → `theme_base` → `theme_colorful` → `func`
-- 类名和文件名: `kebab-case`
-- 变量在 `_defines/`，通用样式在 `_common/`，组件在 `_components/`
-- 2 空格缩进，属性后空格
-- CSS 兼容 IE8
-
-## 浏览器 JS 规范
-
-- ES5 语法（Gulp Babel 转译为 ES2015+）
-- 避免直接操作 DOM，使用主题工具函数
-- 注释: `//` 单行，`/* */` 多行
-
-## 工作流程
-
-每次修改必须遵循以下流程，产物保留在仓库中：
-
-### 1. 方案
-
-在 `docs/` 目录下创建或更新方案文档，描述：
-- 要解决的问题或新增的能力
-- 技术方案和实现思路
-- 影响范围（涉及哪些文件/模块）
-
-### 2. 执行计划
-
-方案通过后，列出具体执行步骤，记录在对应文档中：
-- 改动文件清单
-- 分步实施顺序
-- 依赖关系
-
-### 3. 测试
-
-变更完成后，在自己的 Hexo 项目中集成验证：
-- **`npm run g && npx gulp minify` 全量验证**（`scripts/` 变更必须执行：`npm run g` 发现模板渲染错误，`npx gulp minify` 发现 HTML 结构错误如多余引号等）
-- `npm run s` 启动本地服务
-- 检查涉及的所有页面类型（首页、文章页、Wiki 页等）
-- 验证浏览器兼容性
-- 测试结果记录在 `docs/` 中
-
-### 4. 文档归档
-
-- 方案、执行计划、测试记录保存在 `docs/` 目录
-- 文件命名: `docs/{YYYY-MM-DD}-{功能简称}.md`
-- 涉及逻辑变更（API、配置项、行为变化）必须同步更新仓库 Wiki
-
-### 新增功能 Checklist
-
-新增功能必须覆盖以下维度:
-
-1. `layout/` — EJS 模板
-2. `scripts/` — Hexo 标签 / 辅助函数 / 过滤器
-3. `source/css/` — Stylus 样式
-4. `source/js/` — 浏览器脚本（如需）
-5. `docs/` — 方案 + 执行计划 + 测试记录
-6. `languages/` — 国际化文案（如需新增文本）
-
-## 组件架构
-
-### 自定义标签开发
-
-1. 在 `scripts/tags/lib/` 下创建标签实现文件
-2. 在 `scripts/tags/index.js` 中注册
-3. 在 `source/css/_components/tag-plugins/` 添加对应样式
-4. 推荐使用 `hexo` 参数传入，避免 `require('hexo')`
-
-### 评论系统
-
-- 接口目录: `layout/_partial/comments/`
-- 每个评论系统提供 `layout.ejs` 和 `script.ejs`
-- 遵循现有的配置驱动模式
-
-## Git 规范
-
-```
-<type>(<scope>): <description>
-```
-
-| Type | 说明 |
-|------|------|
-| `feat` | 新功能 |
-| `fix` | Bug 修复 |
-| `refactor` | 重构 |
-| `perf` | 性能优化 |
-| `style` | CSS/样式修改 |
-| `docs` | 文档更新 |
-
-## 发版规范
-
-发版分两步：脚本完成版本号更新和推送 → CI 自动完成 npm 发布和 tag 创建。
-
-```
-npm-publish.sh → push main + npm → CI → npm publish + git tag
-```
-
-### 使用方式
-
-```bash
-# 正常发版（CI 自动处理 npm publish 和 tag）
-bash npm-publish.sh 1.33.2
-
-# 预览模式（仅显示改动，不提交/推送，执行后自动回滚）
-bash npm-publish.sh 1.33.2 --dry-run
-```
-
-### AI 调用指南
-
-1. **分析变更确定版本号**: 查看上一版本以来的 commit，按以下规则确定版本号：
-   - `x.y.z` → `x.y.(z+1)`: 仅含 fix / perf / style（修复和优化，安全升级）
-   - `x.y.z` → `x.(y+1).0`: 含 feat / refactor / breaking change（功能增减、一般重构）
-   - `x.y.z` → `(x+1).0.0`: 大型重构，用户可感知的设计调整
-   - `x.y.z` → `x.y.z-rc.N`: 测试版本
-2. **向用户确认**: 列出版本号和变更摘要，等待用户确认后再继续
-3. **dry-run 预览**: `bash npm-publish.sh <version> --dry-run` 检查变更是否正确
-4. **正式执行**: `bash npm-publish.sh <version>`
-5. **CI 自动**: 检测 `release:` commit → npm publish + tag
-
-## 约束
-
-- **修改 `scripts/` 目录下任何文件后，必须运行 `npm run g && npx gulp minify` 验证构建成功。** `npm run g` 做全量渲染发现模板错误，`npx gulp minify` 做 HTML 压缩发现结构错误（如多余引号）。`npm run s` 是按需渲染，不能替代全量验证。
-- 不引入新构建系统，保持 Hexo 原生 + Gulp 后处理
-- 不混用 EJS 和前端框架语法
-- CSS 兼容 IE8，JS 兼容 ES2015+