hexo-theme-shokax 0.3.9 → 0.3.11

package/README.md

@@ -80,7 +80,10 @@ AGPL许可证主要目的是限制修改后的分发行为，避免未经许可
 | hexo-theme-shoka | amehime           | 本项目的父主题            |
 
 ## 开发者们
-[![](https://contributors-img.web.app/image?repo=theme-shoka-x/hexo-theme-shokaX)](https://github.com/theme-shoka-x/hexo-theme-shokaX/graphs/contributors)
+Hexo 主题： \
+[![](https://contributors-img.web.app/image?repo=theme-shoka-x/hexo-theme-shokaX)](https://github.com/theme-shoka-x/hexo-theme-shokaX/graphs/contributors) \
+ShokaX 文档： \
+[![](https://contributors-img.web.app/image?repo=theme-shoka-x/shokaX-docs)](https://github.com/theme-shoka-x/shokaX-docs/graphs/contributors) \
 
 ## 特别鸣谢
 [<img src="https://resources.jetbrains.com/storage/products/company/brand/logos/jb_beam.png" width="25%">](https://jb.gg/OpenSourceSupport)

package/_config.yml

@@ -83,13 +83,34 @@ polyfill:
     - fetch
 
 # 显示的动画(烟花)
+# 参阅 https://github.com/D-Sketon/mouse-firework
 fireworks:
   enable: true
-  color:
-    - "rgba(255,182,185,.9)"
-    - "rgba(250,227,217,.9)"
-    - "rgba(187,222,214,.9)"
-    - "rgba(138,198,209,.9)"
+  options: 
+    excludeElements: ["a"]
+    particles:
+      - shape: circle
+        move: ["emit"]
+        easing: easeOutExpo
+        colors: 
+          - "rgba(255,182,185,.9)"
+          - "rgba(250,227,217,.9)"
+          - "rgba(187,222,214,.9)"
+          - "rgba(138,198,209,.9)"
+        number: 30
+        duration: [1200, 1800]
+        shapeOptions:
+          radius: [16, 32]
+      - shape: circle
+        move: ["diffuse"]
+        easing: easeOutExpo
+        colors: ["#fff"]
+        number: 1
+        duration: [1200, 1800]
+        shapeOptions:
+          radius: 20
+          alpha: 0.5
+          lineWidth: 6
 
 font:
   enable: true
@@ -183,29 +204,6 @@ waline:
   pageSize: 10 # 每页评论条数
   pageview: false # 是否开启浏览量统计,可独立开启
 
-# https://github.com/gitalk/gitalk/blob/master/readme-cn.md
-gitalk:
-  clientID:
-  clientSecret:
-  repo:
-  owner:
-  admin:
-  proxy: # 选填
-
-# https://giscus.app/zh-CN
-giscus:
-  repo:
-  repoId:
-  category:
-  categoryId:
-  mapping:
-  strict:
-  reactionsEnabled:
-  emitMetadata:
-  inputPosition:
-  commentTheme:
-  lang:
-
 summary:
   enable: false
   introduce: "我是基于ChatGPT-turbo-3.5实现的AI助手，在此网站上负责整理和概括文章" # AI自我介绍

package/layout/_mixin/comment.pug

@@ -1,6 +1,6 @@
 mixin CommentRender()
     != shokax_inject('comment')
-    - var tk = theme?.twikoo?.enable,wl = theme?.waline?.enable,gt=theme?.gitalk?.enable,gs=theme?.giscus?.enable
+    - var tk = theme?.twikoo?.enable,wl = theme?.waline?.enable
     if page.comment !== false && !theme.experiments.disableThemeComment
         if tk
             div(class="wrap" id="tcomments")
@@ -37,38 +37,5 @@ mixin CommentRender()
                         dark: 'html[data-theme="dark"]'
                     });
                 }, 1000)
-        else if gt
-            div(class="wrap" id="gtcomments")
-            script(type="text/javascript" data-pjax).
-                const gproxy = theme.gitalk.proxy || undefined
-                const gitalk = new Gitalk({
-                    clientID: '#{theme.gitalk.clientID}',
-                    clientSecret: '#{theme.gitalk.clientSecret}',
-                    repo: '#{theme.gitalk.repo}',
-                    owner: '#{theme.gitalk.owner}',
-                    admin: #{theme.gitalk.admin},
-                    id: location.pathname,      // Ensure uniqueness and length less than 50
-                    distractionFreeMode: false,  // Facebook-like distraction free mode
-                    proxy: "#{gproxy}"
-                });
-                gitalk.render("gtcomments")
-        else if gs
-            div(class="wrap giscus" id="gscomments")
-            script( src="https://giscus.app/client.js"
-                    data-repo="#{theme.giscus.repo}"
-                    data-repo-id="#{theme.giscus.repoId}"
-                    data-category="#{theme.giscus.category}"
-                    data-category-id="#{theme.giscus.categoryId}"
-                    data-mapping="#{theme.giscus.mapping}"
-                    data-strict="#{theme.giscus.strict}"
-                    data-reactions-enabled="#{theme.giscus.reactionsEnabled}"
-                    data-emit-metadata="#{theme.giscus.emitMetadata}"
-                    data-input-position="#{theme.giscus.inputPosition}"
-                    data-theme="#{theme.giscus.commentTheme}"
-                    data-lang="#{theme.giscus.lang}"
-                    data-loading="lazy"
-                    crossorigin="anonymous"
-                    async
-                    )
 
 

package/layout/_mixin/segment.pug

@@ -11,7 +11,7 @@ mixin SMRender(item)
             div(class="cover" style=`background: linear-gradient(to bottom right, ${random_color()}, ${random_color()});`)
         else
             div(class="cover")
-                != _url(link1, '<img data-src="'+ _cover_index(item) +'" alt="article cover">', {itemprop: 'url', title: postText})
+                != _url(link1, '<img data-src="'+ _cover(item) +'" alt="article cover">', {itemprop: 'url', title: postText})
         div(class="info")
             +PMRender(item)
             h3

package/layout/_partials/head/head.pug

@@ -3,7 +3,7 @@
 - var siteTitle = config.title,noBaiduT = theme?.seo?.disable_baidu_transformation
 - var feedLink = full_url_for("/feed.json")
 - var tk= theme?.twikoo?.enable
-- var wl = theme.waline.enable,gt=theme?.gitalk?.enable
+- var wl = theme.waline.enable
 meta(charset="UTF-8")
 meta(name="viewport" content="width=device-width,initial-scale=1,maximum-scale=2")
 meta(name="theme-color" content="#222")
@@ -54,9 +54,6 @@ if tk
     script(src=theme.twikoo.link)
 else if wl
     link(rel="stylesheet" href="https://unpkg.com/@waline/client@v2/dist/waline.css")
-else if gt
-    link(rel="stylesheet" href="https://unpkg.com/gitalk/dist/gitalk.css")
-    script(src="https://unpkg.com/gitalk/dist/gitalk.min.js")
 
 - var qw = theme?.qweather?.enable
 if qw

package/layout/_partials/layout.pug

@@ -2,7 +2,7 @@ include ../_mixin/breadcrumb.pug
 include ../_mixin/sidebar.pug
 include ../_mixin/widgets.pug
 
-- var ignores = []
+- ignores = []
 if (theme.quicklink.ignores)
     - ignores.push(theme.quicklink.ignores)
 
@@ -40,7 +40,7 @@ html(lang=page.language?page.language:config.language, style=theme.grayMode ? 'f
                         - var coverImage = theme.experiments.fixedCover || "https://7ed.net/bing/api"
                         img(src=coverImage)
                     else
-                        - var covers = _cover(page, 6)
+                        - var covers = _cover_index(page, 6)
                         if covers.length === 6
                             ul
                                 each image in covers

package/package.json

@@ -1,14 +1,14 @@
 {
     "name": "hexo-theme-shokax",
-    "version": "0.3.9",
+    "version": "0.3.11",
     "description": "a hexo theme based on shoka",
     "main": "index.js",
     "repository": "https://github.com/theme-shoka-x/hexo-theme-shokaX",
     "author": "zkz098",
     "license": "AGPL-3.0-or-later",
     "scripts": {
-        "test": "mocha test",
-        "build": "pnpm install && tsc"
+        "test": "tsc --build --verbose",
+        "build": "cd ./source && tsc --build --verbose && cd ../scripts && tsc --build --verbose"
     },
     "devDependencies": {
         "@types/chai": "^4.3.11",
@@ -18,32 +18,33 @@
         "@types/js-yaml": "^4.0.9",
         "@types/lozad": "^1.16.4",
         "@types/mocha": "^10.0.6",
-        "@types/node": "^20.10.2",
-        "@typescript-eslint/eslint-plugin": "^6.13.1",
-        "@typescript-eslint/parser": "^6.13.1",
-        "chai": "^4.3.10",
-        "eslint": "^8.55.0",
+        "@types/node": "^20.10.6",
+        "@typescript-eslint/eslint-plugin": "^6.18.0",
+        "@typescript-eslint/parser": "^6.18.0",
+        "chai": "^5.0.0",
+        "eslint": "^8.56.0",
         "eslint-config-standard": "~17",
         "eslint-plugin-chai-friendly": "^0.7.2",
-        "eslint-plugin-import": "^2.29.0",
-        "eslint-plugin-n": "^16.3.1",
+        "eslint-plugin-import": "^2.29.1",
+        "eslint-plugin-n": "^16.6.1",
         "eslint-plugin-promise": "^6.1.1",
         "eslint-plugin-vue": "^9.19.2",
         "hexo-fs": "^4.1.1",
         "hexo-util": "^3.1.0",
-        "instantsearch.js": "^4.60.0",
-        "jsdom": "^23.0.1",
+        "instantsearch.js": "^4.63.0",
+        "jsdom": "^23.1.0",
         "mocha": "^10.2.0",
-        "typescript": "^5.3.2",
-        "vue": "^3.3.9"
+        "typescript": "^5.3.3",
+        "vue": "^3.4.5"
     },
     "dependencies": {
-        "esbuild": "^0.19.8",
+        "esbuild": "^0.19.11",
         "hexo": "^7.0.0",
         "js-yaml": "^4.1.0",
         "lozad": "^1.16.0",
-        "theme-shokax-anime": "^0.0.4",
-        "theme-shokax-pjax": "^0.0.2"
+        "mouse-firework": "^0.0.3",
+        "theme-shokax-anime": "^0.0.6",
+        "theme-shokax-pjax": "^0.0.3"
     },
     "engines": {
         "node": ">=18.0.0"

package/scripts/filters/locals.js

@@ -1,15 +1,19 @@
+// @ts-ignore
 const fmtNum = (num) => {
     return num < 10 ? '0' + num : num;
 };
 hexo.extend.filter.register('template_locals', (locals) => {
     const { config } = hexo;
     const { __, theme } = locals;
+    // @ts-ignore
     const { i18n } = hexo.theme;
     const pangu = {
         spacing: (data) => {
             return data;
         }
     };
+    // Language & Config
+    // 根据主题配置的 Creative Commons 许可证生成链接
     locals.alternate = theme.alternate;
     locals.title = pangu.spacing(__('title') !== 'title' ? __('title') : config.title);
     locals.subtitle = pangu.spacing(__('subtitle') !== 'subtitle' ? __('subtitle') : config.subtitle);
@@ -19,6 +23,8 @@ hexo.extend.filter.register('template_locals', (locals) => {
     locals.languages.splice(locals.languages.indexOf('default'), 1);
     locals.page.lang = locals.page.lang || locals.page.language;
     locals.hostname = new URL(config.url).hostname || config.url;
+    // Creative Commons
+    // 根据主题配置的 Creative Commons 许可证生成链接
     if (theme.creative_commons.license === 'zero') {
         locals.ccURL = 'https://creativecommons.org/' + 'publicdomain/zero/1.0/' + (theme.creative_commons.language || '');
     }

package/scripts/filters/post.js

@@ -1,3 +1,5 @@
+/* global hexo */
 hexo.extend.filter.register('after_post_render', (data) => {
+    // 使用正则表达式将<img>标签的src属性替换为data-src属性
     data.content = data.content.replace(/(<img[^>]*) src=/img, '$1 data-src=');
 }, 0);

package/scripts/generaters/archive.js

@@ -1,13 +1,17 @@
+/* global hexo */
 'use strict';
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+// @ts-ignore
 const hexo_pagination_1 = __importDefault(require("hexo-pagination"));
+// @ts-ignore
 const fmtNum = num => {
     return num < 10 ? '0' + num : num;
 };
 if (!(hexo.config.archive && hexo.config.archive.enabled === false)) {
+    // when archive disabled pagination, per_page should be 0.
     let per_page;
     if (hexo.config.archive === 1) {
         per_page = 0;
@@ -28,6 +32,7 @@ if (!(hexo.config.archive && hexo.config.archive.enabled === false)) {
         const config = hexo.config;
         let archiveDir = config.archive_dir;
         const paginationDir = config.pagination_dir || 'page';
+        // @ts-ignore
         const allPosts = locals.posts.sort(config.archive_generator.order_by || '-date');
         const perPage = config.archive_generator.per_page;
         let result = [];
@@ -49,11 +54,14 @@ if (!(hexo.config.archive && hexo.config.archive.enabled === false)) {
         if (!config.archive_generator.yearly)
             return result;
         const posts = {};
+        // 按日期对文章进行分类
         allPosts.forEach(post => {
             const date = post.date;
             const year = date.year();
-            const month = date.month() + 1;
+            const month = date.month() + 1; // month is started from 0
             if (!Object.prototype.hasOwnProperty.call(posts, year)) {
+                // 13个数组. 第一个数组是给这一年的文章准备的
+                // 其他则是各个月份的文章
                 posts[year] = [
                     [],
                     [],
@@ -72,6 +80,7 @@ if (!(hexo.config.archive && hexo.config.archive.enabled === false)) {
             }
             posts[year][0].push(post);
             posts[year][month].push(post);
+            // Daily
             if (config.archive_generator.daily) {
                 const day = date.date();
                 if (!Object.prototype.hasOwnProperty.call(posts[year][month], 'day')) {
@@ -83,6 +92,7 @@ if (!(hexo.config.archive && hexo.config.archive.enabled === false)) {
         const Query = this.model('Post').Query;
         const years = Object.keys(posts);
         let year, data, month, monthData, url;
+        // Yearly
         for (let i = 0, len = years.length; i < len; i++) {
             year = +years[i];
             data = posts[year];
@@ -92,6 +102,7 @@ if (!(hexo.config.archive && hexo.config.archive.enabled === false)) {
             generate(url, new Query(data[0]), { year });
             if (!config.archive_generator.monthly && !config.archive_generator.daily)
                 continue;
+            // Monthly
             for (month = 1; month <= 12; month++) {
                 monthData = data[month];
                 if (!monthData.length)
@@ -104,6 +115,7 @@ if (!(hexo.config.archive && hexo.config.archive.enabled === false)) {
                 }
                 if (!config.archive_generator.daily)
                     continue;
+                // Daily
                 for (let day = 1; day <= 31; day++) {
                     const dayData = monthData.day[day];
                     if (!dayData || !dayData.length)

package/scripts/generaters/config.js

@@ -3,19 +3,22 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+/* global hexo */
 const hexo_util_1 = require("hexo-util");
 const node_fs_1 = __importDefault(require("node:fs"));
 const path_1 = __importDefault(require("path"));
 const js_yaml_1 = __importDefault(require("js-yaml"));
 hexo.extend.filter.register('before_generate', () => {
     if (hexo.config.theme_config) {
+        // @ts-ignore
         hexo.theme.config = (0, hexo_util_1.deepMerge)(hexo.theme.config, hexo.config.theme_config);
     }
     const data = hexo.locals.get('data');
     if (data.languages) {
+        // @ts-ignore
         const { i18n } = hexo.theme;
         const mergeLang = lang => {
-            if (data.languages[lang]) {
+            if (data.languages[lang]) { // @ts-ignore
                 i18n.set(lang, (0, hexo_util_1.deepMerge)(i18n.get([lang]), data.languages[lang]));
             }
         };

package/scripts/generaters/images.js

@@ -1,5 +1,7 @@
+/* global hexo */
 'use strict';
 Object.defineProperty(exports, "__esModule", { value: true });
+// @ts-ignore
 const fs = require("hexo-fs");
 hexo.extend.generator.register('images', function (locals) {
     const theme = hexo.theme.config;

package/scripts/generaters/index.js

@@ -1,3 +1,5 @@
+// @ts-nocheck
+/* global hexo */
 'use strict';
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
@@ -15,7 +17,7 @@ hexo.extend.generator.register('index', function (locals) {
     let pages;
     const config = hexo.config;
     const sticky = locals.posts.find({ sticky: true }).sort(config.index_generator.order_by);
-    const posts = locals.posts.find({ sticky: { $exists: false } }).sort(config.index_generator.order_by);
+    const posts = locals.posts.find({ sticky: { $in: [false, undefined] } }).sort(config.index_generator.order_by);
     const paginationDir = config.pagination_dir || 'page';
     const path = config.index_generator.path || '';
     const categories = locals.categories;
@@ -96,7 +98,8 @@ hexo.extend.generator.register('index', function (locals) {
                 data: {
                     __index: true,
                     catlist,
-                    sticky
+                    sticky,
+                    current: 1,
                 }
             }];
     }

package/scripts/generaters/pages.js

@@ -1,5 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
 hexo.extend.generator.register('pages', function () {
     const config = hexo.config;
     return [

package/scripts/generaters/script.js

@@ -1,16 +1,40 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const package_json_1 = __importDefault(require("../../package.json"));
-const fs = require("hexo-fs");
-const esbuild = require("esbuild");
+/* global hexo */
+// import env from '../../package.json'
+const fs = __importStar(require("hexo-fs"));
+const esbuild_1 = require("esbuild");
+const env = {
+    version: '0.3.10'
+};
 hexo.extend.generator.register('script', function (locals) {
     const config = hexo.config;
     const theme = hexo.theme.config;
     const siteConfig = {
-        version: package_json_1.default.version,
+        version: env.version,
         hostname: config.url,
         root: config.root,
         statics: theme.statics,
@@ -27,6 +51,7 @@ hexo.extend.generator.register('script', function (locals) {
             fancybox: theme.vendors.js.fancybox
         },
         css: {
+            // valine: theme.css + '/comment.css',
             katex: theme.vendors.css.katex,
             mermaid: theme.css + '/mermaid.css',
             fancybox: theme.vendors.css.fancybox
@@ -45,8 +70,8 @@ hexo.extend.generator.register('script', function (locals) {
         disableVL: theme.disableVL,
         noPlayer: theme.experiments?.noPlayer,
         audio: undefined,
-        fireworks: (theme.fireworks && theme.fireworks.enable)
-            ? (theme.fireworks.color || ['rgba(255,182,185,.9)', 'rgba(250,227,217,.9)', 'rgba(187,222,214,.9)', 'rgba(138,198,209,.9)'])
+        fireworks: (theme.fireworks && theme.fireworks.enable && theme.fireworks.options)
+            ? theme.fireworks.options
             : undefined
     };
     if (config?.algolia) {
@@ -69,7 +94,7 @@ hexo.extend.generator.register('script', function (locals) {
         enterPoint = 'node_modules/hexo-theme-shokax/source/js/_app/pjax/siteInit.js';
     }
     text = 'const CONFIG = ' + JSON.stringify(siteConfig) + ';';
-    esbuild.buildSync({
+    (0, esbuild_1.buildSync)({
         entryPoints: [enterPoint],
         bundle: true,
         outfile: 'shokax_temp.js',

package/scripts/helpers/asset.js

@@ -1,10 +1,11 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
+/* global hexo */
 Object.defineProperty(exports, "__esModule", { value: true });
-const package_json_1 = __importDefault(require("../../package.json"));
+// import theme_env from '../../package.json'
 const hexo_util_1 = require("hexo-util");
+const theme_env = {
+    version: '0.3.10'
+};
 hexo.extend.helper.register('_new_comments', function (mode) {
     const root = this.config.url.replace(/^(https?:\/\/)?[^\/]*/, '');
     if (mode === 'twikoo') {
@@ -85,7 +86,7 @@ hexo.extend.helper.register('hexo_env', function (type) {
     return this.env[type];
 });
 hexo.extend.helper.register('theme_env', function (type) {
-    return package_json_1.default[type];
+    return theme_env[type];
 });
 hexo.extend.helper.register('_vendor_font', () => {
     const config = hexo.theme.config.font;
@@ -95,6 +96,7 @@ hexo.extend.helper.register('_vendor_font', () => {
     const fontSubset = '&subset=latin,latin-ext';
     const fontStyles = ':300,300italic,400,400italic,700,700italic';
     const fontHost = 'https://fonts.googleapis.com';
+    // Get a font list from config
     let fontFamilies = ['global', 'logo', 'title', 'headings', 'posts', 'codes'].map(item => {
         if (config[item] && config[item].family && config[item].external) {
             return config[item].family + fontStyles;
@@ -102,8 +104,11 @@ hexo.extend.helper.register('_vendor_font', () => {
         return '';
     });
     fontFamilies = fontFamilies.filter(item => item !== '');
+    // @ts-ignore
     fontFamilies = [...new Set(fontFamilies)];
+    // @ts-ignore
     fontFamilies = fontFamilies.join('|');
+    // Merge extra parameters to the final processed font string
     return fontFamilies
         ? (0, hexo_util_1.htmlTag)('link', {
             rel: 'stylesheet',
@@ -111,10 +116,12 @@ hexo.extend.helper.register('_vendor_font', () => {
         })
         : '';
 });
+// TODO 废弃方法
 hexo.extend.helper.register('_vendor_js', () => {
     const config = hexo.theme.config.vendors.js;
     if (!config)
         return '';
+    // Get a font list from config
     let vendorJs = ['pace', 'pjax', 'fetch', 'anime', 'algolia', 'instantsearch', 'lazyload', 'quicklink'].map(item => {
         if (config[item]) {
             return config[item];
@@ -122,7 +129,9 @@ hexo.extend.helper.register('_vendor_js', () => {
         return '';
     });
     vendorJs = vendorJs.filter(item => item !== '');
+    // @ts-ignore
     vendorJs = [...new Set(vendorJs)];
+    // @ts-ignore
     vendorJs = vendorJs.join(',');
     return vendorJs ? (0, hexo_util_1.htmlTag)('script', { src: `https://cdn.jsdelivr.net/combine/${vendorJs}` }, '') : '';
 });
@@ -130,12 +139,12 @@ hexo.extend.helper.register('_css', function (...urls) {
     const { statics, css } = hexo.theme.config;
     return urls.map(url => (0, hexo_util_1.htmlTag)('link', {
         rel: 'stylesheet',
-        href: hexo_util_1.url_for.call(this, `${statics}${css}/${url}?v=${package_json_1.default.version}`)
+        href: hexo_util_1.url_for.call(this, `${statics}${css}/${url}?v=${theme_env.version}`)
     })).join('');
 });
 hexo.extend.helper.register('_js', function (...urls) {
     const { statics, js } = hexo.theme.config;
-    return urls.map(url => (0, hexo_util_1.htmlTag)('script', { src: hexo_util_1.url_for.call(this, `${statics}${js}/${url}?v=${package_json_1.default.version}`) }, '')).join('');
+    return urls.map(url => (0, hexo_util_1.htmlTag)('script', { src: hexo_util_1.url_for.call(this, `${statics}${js}/${url}?v=${theme_env.version}`) }, '')).join('');
 });
 hexo.extend.helper.register('_list_vendor_js', () => {
     return hexo.theme.config.vendorsList.js;

package/scripts/helpers/engine.js

@@ -1,5 +1,6 @@
 'use strict';
 Object.defineProperty(exports, "__esModule", { value: true });
+// @ts-ignore
 const hexo_util_1 = require("hexo-util");
 const randomServer = parseInt(String(Math.random() * 4), 10) + 1;
 const randomBG = function (count = 1, image_server = null, image_list = []) {
@@ -18,7 +19,7 @@ const randomBG = function (count = 1, image_server = null, image_list = []) {
         if (img.startsWith('//') || img.startsWith('http')) {
             return img;
         }
-        else if (hexo.theme.config.experiments?.usingRelative) {
+        else if (hexo.theme.config.experiments?.usingRelative) { // support relative url
             return img;
         }
         else {
@@ -47,7 +48,9 @@ const randomBG = function (count = 1, image_server = null, image_list = []) {
     }
     return parseImage(image_list[Math.floor(Math.random() * image_list.length)], 'mw690');
 };
+// 注册hexo主题中的URL帮助方法
 hexo.extend.helper.register('_url', function (path, text, options = {}) {
+    // 如果未提供URL路径，则返回
     if (!path) {
         return;
     }
@@ -59,6 +62,7 @@ hexo.extend.helper.register('_url', function (path, text, options = {}) {
     if (attrs.class && Array.isArray(attrs.class)) {
         attrs.class = attrs.class.join(' ');
     }
+    // 返回HTML标记字符串
     return (0, hexo_util_1.htmlTag)(tag, attrs, decodeURI(text), false);
 });
 hexo.extend.helper.register('_image_url', function (img, path = '') {
@@ -95,24 +99,43 @@ hexo.extend.helper.register('_cover_index', function (item) {
         return randomBG(1, image_server, index_images.length === 0 ? image_list : index_images);
     }
 });
+// 注册hexo主题的永久链接帮助方法
 hexo.extend.helper.register('_permapath', function (str) {
+    // 获取hexo的永久链接配置
     const { permalink } = hexo.config;
+    // 将输入字符串中的'index.html'替换为空字符串
     let url = str.replace(/index\.html$/, '');
+    // 如果永久链接不以'.html'结尾，将输入字符串中的'.html'替换为空字符串
     if (!permalink.endsWith('.html')) {
         url = url.replace(/\.html$/, '');
     }
+    // 返回处理后的URL字符串
     return url;
 });
 hexo.extend.helper.register('canonical', function () {
     return `<link rel="canonical" href="${this._permapath(this.url)}">`;
 });
+/**
+ * Get page path given a certain language tag
+ */
+// 注册hexo主题的国际化路径帮助方法
 hexo.extend.helper.register('i18n_path', function (language) {
+    // 获取当前页面的path和lang
     const { path, lang } = this.page;
+    // 如果path以lang开头，则截取掉lang部分，作为基础路径
     const base = path.startsWith(lang) ? path.slice(lang.length + 1) : path;
+    // 通过调用url_for方法，生成国际化路径
     return hexo_util_1.url_for.call(this, `${this.languages.indexOf(language) === 0 ? '' : '/' + language}/${base}`);
 });
+/**
+ * Get the language name
+ */
+// 注册hexo主题的语言名称帮助方法
 hexo.extend.helper.register('language_name', function (language) {
+    // 从主题配置中获取指定语言的名称
+    // @ts-ignore
     const name = hexo.theme.i18n.__(language)('name');
+    // 如果名称为默认值'name'，则返回语言代码，否则返回语言名称
     return name === 'name' ? language : name;
 });
 hexo.extend.helper.register('random_color', function () {