hexo-theme-stellar 1.40.0 → 1.41.0

package/scripts/events/lib/doc_tree.js

@@ -1,216 +1,20 @@
 /**
  * doc_tree.js v2 | https://github.com/xaoxuu/hexo-theme-stellar/
+ *
+ * Wiki 文档树构建入口：委托 scripts/lib/doc_tree.js 的纯函数，
+ * 保持 ctx.theme.config.wiki 输出结构与旧实现一致。
  */
 
 '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 = normalize_path(page.path)
-    this.layout = page.layout
-    this.updated = page.updated
-  }
-}
-
-function getWikiObject(ctx) {
-  var wiki = { tree:{} }
-  const data = ctx.locals.get('data')
-  var list = []
-  for (let key of Object.keys(data)) {
-    if (key.endsWith('.DS_Store')) {
-      continue
-    }
-    if (key.includes('wiki/') && key.length > 5) {
-      let newKey = key.replace('wiki/', '')
-      let obj = data[key]
-      if ((typeof obj.tags == 'string') && obj.tags.constructor == String) {
-        obj.tags = [obj.tags]
-      }
-      if ((typeof obj.tree == 'object') && obj.tree.constructor == Array) {
-        obj.tree = { '': obj.tree }
-      }
-      obj.id = newKey
-      if (obj.sort == null) {
-        obj.sort = 0
-      }
-      if (obj.base_dir) {
-        if (obj.base_dir.startsWith('/')) {
-          obj.base_dir = obj.base_dir.substring(1)
-        }
-        if (obj.base_dir.length > 1 && obj.base_dir.endsWith('/') == false) {
-          obj.base_dir = obj.base_dir + '/'
-        }
-      } else {
-        obj.base_dir = ''
-      }
-      list.push(obj)
-    }
-  }
-  list = list.sort((p1, p2) => p2.sort - p1.sort)
-  for (let item of list) {
-    wiki.tree[item.id] = item
-  }
-  return wiki
-}
+const { buildWikiTree } = require('../../lib/doc_tree');
 
 module.exports = ctx => {
-  // wiki 配置
-  var wiki = getWikiObject(ctx)
-  const pages = ctx.locals.get('pages')
-  // wiki 所有页面
-  const wiki_pages = pages.filter(p => (p.wiki != null)).map(p => new WikiPage(p))
-  const wiki_list = Object.keys(wiki.tree).filter(id => wiki_pages.some(p => p.wiki === id))
-  // 上架的项目列表
-  wiki.shelf = ctx.locals.get('data').wiki || []
-  
-  // 数据整合：项目标签
-  var all_tag_name = []
-  for (let id of wiki_list) {
-    let item = wiki.tree[id]
-    let tags = item.tags
-    if (tags) {
-      tags.forEach((tag, i) => {
-        if (all_tag_name.includes(tag) === false) {
-          all_tag_name.push(tag)
-        }
-      })
-      wiki.tree[id].tags = tags
-    }
-  }
-
-  // 补充项目名称和首页
-  for (let id of wiki_list) {
-    let item = wiki.tree[id]
-    item.id = id
-    if (item.title == undefined || item.title.length === 0) {
-      item.title = id
-    }
-    if (item.name == undefined || item.name.length == 0) {
-      item.name = id
-    }
-  }
-  
-  // 数据整合：每个项目的子页面
-  for (let i = 0; i < wiki_list.length; i++) {
-    let id = wiki_list[i];
-    let item = wiki.tree[id]
-    let sub_pages = wiki_pages.filter(p => p.wiki === id)
-
-    // 首页
-    // 未特别指定首页时，获取TOC第一页作为首页
-    var homepage = item.homepage
-    if (homepage == null && item.tree != null) {
-      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 == normalize_path(item.base_dir + key))
-          if (hs.length > 0) {
-            homepage = hs[0]
-            break
-          }
-        }
-        if (homepage != null) {
-          break
-        }
-      }
-    }
-    if (homepage == null) {
-      homepage = sub_pages[0]
-    }
-    if (typeof homepage == 'string') {
-      homepage = {path: homepage}
-    }
-    homepage.is_homepage = true
-    item.homepage = homepage
-    // 内页分组
-    var sections = []
-    var others = sub_pages
-    if (item.tree) {
-      // 根据配置设置顺序
-      for (let title of Object.keys(item.tree)) {
-        var sec = { title: title, pages: []}
-        for (let key of item.tree[title]) {
-          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)
-      }
-      if (others.length > 0 && others.filter(p => p.title?.length > 0).length > 0) {
-        sections.push({
-          title: '...',
-          pages: others.sort((p1, p2) => p1.title - p2.title)
-        })
-      }
-    } else {
-      // 自动设置顺序
-      sections.push({
-        pages: sub_pages.sort((p1, p2) => p1.title - p2.title)
-      })
-    }
-    
-    // page number
-    var page_number = 0
-    for (let sec of sections) {
-      for (let page of sec.pages) {
-        page.page_number = page_number++
-      }
-    }
-    item.sections = sections
-    item.pages = sub_pages
-  }
-  
-  // 全站所有的项目标签
-  var all_tags = {}
-  all_tag_name.forEach((tag_name, i) => {
-    var items = []
-    for (let id of wiki_list) {
-      let item = wiki.tree[id]
-      // 过滤掉找不到页面的项目
-      if (item.homepage == null) {
-        continue
-      }
-      // 过滤掉未上架的项目
-      if (!wiki.shelf.includes(item.id)) {
-        continue
-      }
-      if (item.tags && item.tags.includes(tag_name) === true && items.includes(tag_name) === false) {
-        items.push(item.id)
-      }
-    }
-    all_tags[tag_name] = {
-      name: tag_name,
-      path: (ctx.theme.config.site_tree.index_wiki.base_dir) + '/tags/' + tag_name + '/index.html',
-      items: items
-    }
-  })
-
-  // 关联相似项目
-  for (let id of wiki_list) {
-    let item = wiki.tree[id]
-    if (item.tags) {
-      var relatedItems = []
-      item.tags.forEach((tag_name, i) => {
-        let relatedOtherItems = all_tags[tag_name].items.filter(name => name != item.id)
-        if (relatedOtherItems.length > 0) {
-          relatedItems.push({
-            name: tag_name,
-            items: relatedOtherItems
-          })
-        }
-      })
-      item.relatedItems = relatedItems
-    }
-  }
-
-  wiki.all_tags = all_tags
-  wiki.all_pages = wiki_pages
-  ctx.theme.config.wiki = wiki
-
-}
+  const wiki = buildWikiTree({
+    data: ctx.locals.get('data'),
+    pages: ctx.locals.get('pages'),
+    shelf: ctx.locals.get('data').wiki || [],
+    siteTree: ctx.theme.config.site_tree
+  });
+  ctx.theme.config.wiki = wiki;
+};

package/scripts/events/lib/notebooks.js

@@ -1,155 +1,15 @@
 /**
  * notebooks.js v1
+ *
+ * 笔记本系统构建入口：委托 scripts/lib/notebooks.js 的纯函数，
+ * 保持 ctx.theme.config.notebooks 输出结构与旧实现一致。
  */
 
-'use strict'
+'use strict';
 
-const { normalize_path } = require('../../lib/path_utils');
-
-class NotePage {
-  constructor(page) {
-    this.id = page._id
-    this.notebook = page.notebook
-    this.title = page.title
-    this.tags = page.tags
-    this.path = page.path
-    this.path_key = normalize_path(page.path)
-    this.layout = page.layout
-    this.date = page.date
-    this.updated = page.updated || page.date
-
-    const pin = page.pin ?? page.sticky ?? 0
-    if (pin === true) {
-      this.pin = 1
-    } else if (pin === false) {
-      this.pin = 0
-    } else {
-      this.pin = pin
-    }
-  }
-}
-
-function splitTag(tag) {
-  return tag.split('/').filter(t => t.length > 0)
-}
-
-function prepareNotebook(id, info, ctx) {
-  const notebook = info
-  notebook.id = id
-
-  if (notebook.base_dir) {
-    if (notebook.base_dir.startsWith('/')) {
-      notebook.base_dir = notebook.base_dir.substring(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
-    notebook.base_dir = notebooksBaseDir ? `${notebooksBaseDir}/${id}` : id
-  }
-
-  notebook.sort ||= 0
-  notebook.auto_excerpt ||= ctx.theme.config.notebook.auto_excerpt || 0
-  notebook.per_page ??= ctx.theme.config.notebook.per_page ?? ctx.config.per_page ?? 10
-  notebook.order_by ||= ctx.theme.config.notebook.order_by || '-updated'
-  notebook.menu_id ??= ctx.theme.config.site_tree.notes.menu_id
-  notebook.license ??= ctx.theme.config.notebook.license
-  notebook.share ??= ctx.theme.config.notebook.share
-
-  notebook.leftbar ??= ctx.theme.config.site_tree.notes.leftbar
-  notebook.rightbar ??= ctx.theme.config.site_tree.notes.rightbar
-  notebook.note_leftbar ??= ctx.theme.config.site_tree.note.leftbar
-  notebook.note_rightbar ??= ctx.theme.config.site_tree.note.rightbar
-
-  const tagMap = new Map() // tagId: tagInfo
-  notebook.tagTree = tagMap
-
-  const rootTag = {
-    id: '',
-    name: '',
-    part: '',
-    path: notebook.base_dir,
-    parent: null, // parent tag id
-    childSet: new Set(), // child tag ids
-    noteSet: new Set(), // note ids
-  }
-  tagMap.set(rootTag.id, rootTag)
-
-  // Iterate through all notes in the notebook, build the tag tree.
-  const allPages = ctx.locals.get('pages')
-  const pages = allPages.filter(p => p.notebook === notebook.id)
-  for (const page of pages.data) {
-    rootTag.noteSet.add(page._id)
-
-    if (!page.tags) {
-      continue
-    }
-
-    for (const hierarchyTag of page.tags) {
-      const parts = splitTag(hierarchyTag)
-      let parent = rootTag
-      for (const part of parts) {
-        const tagName = parent.name ? `${parent.name}/${part}` : part
-        const tagId = tagName.toLowerCase()
-        let tag = tagMap.get(tagId)
-        if (tag == null) {
-          tag = {
-            id: tagId,
-            name: tagName,
-            part: part,
-            path: `${notebook.base_dir}/tags/${tagId}`,
-            parent: parent.id,
-            childSet: new Set(),
-            noteSet: new Set(),
-          }
-          tagMap.set(tagId, tag)
-          parent.childSet.add(tagId)
-        }
-
-        tag.noteSet.add(page._id)
-        parent = tag
-      }
-    }
-  }
-
-  notebook.noteMap = pages.map(p => new NotePage(p)).reduce((map, note) => {
-    map.set(note.id, note)
-    return map
-  }, new Map())
-
-  // Sort child tags for each tag.
-  for (const [_, tag] of tagMap) {
-    tag.children = Array.from(tag.childSet)
-    tag.children.sort()
-  }
-
-  return notebook
-}
-
-function getNotebooksObject(ctx) {
-  const notebooks = {
-    tree: {},
-  }
-
-  const data = ctx.locals.get('data')
-  const list = []
-  for (const [key, info] of Object.entries(data)) {
-    if (!key.startsWith('notebooks/') || key.endsWith('.DS_Store')) {
-      continue
-    }
-    const id = key.substring(10)
-    list.push(prepareNotebook(id, info, ctx))
-  }
-  list.sort((a, b) => a.sort - b.sort)
-  for (const info of list) {
-    notebooks.tree[info.id] = info
-  }
-
-  return notebooks
-}
+const { getNotebooksObject } = require('../../lib/notebooks');
 
 module.exports = ctx => {
-  const notebooks = getNotebooksObject(ctx)
-  ctx.theme.config.notebooks = notebooks
-}
+  const notebooks = getNotebooksObject(ctx);
+  ctx.theme.config.notebooks = notebooks;
+};

package/scripts/events/lib/utils.js

@@ -71,7 +71,7 @@ module.exports = hexo => {
     }
   };
   hexo.utils = {
-    icon: (key, args) => {
+    icon: (key, args, inline) => {
       const { icons } = hexo.theme.config
       var result = ''
       if (icons[key]) {
@@ -81,9 +81,18 @@ module.exports = hexo => {
       }
       if (result.startsWith('/') || result.startsWith('https://') || result.startsWith('http://')) {
         return `<img ${args?.length > 0 ? args : ''} src="${result}" />`
+      } else if (inline === true) {
+        return result
+      } else if (result.startsWith('<svg')) {
+        // 非首屏图标：输出占位符，由 /js/icons.js 异步拉取 js/icons/{ns}.json 后原位替换
+        return `<svg class="icon" data-icon="${key}" aria-hidden="true"></svg>`
       } else {
         return result
       }
+    },
+    iconData: (key) => {
+      const { icons } = hexo.theme.config
+      return icons && icons[key] ? icons[key] : ''
     }
   };
 };

package/scripts/filters/index.js

@@ -2,6 +2,7 @@
 
 hexo.extend.filter.register('after_render:html', require('./lib/img_lazyload').processSite);
 hexo.extend.filter.register('after_render:html', require('./lib/img_onerror').processSite);
+hexo.extend.filter.register('after_post_render', require('./lib/md_table').processPost);
 
 function change_image(data) {
     if (this.theme.config.tag_plugins.image.parse_markdown) {

package/scripts/filters/lib/img_lazyload.js

@@ -7,6 +7,10 @@
 
 // 懒加载强制开启：不再读取 enable 配置，no-lazy 是唯一例外
 function lazyProcess(htmlContent) {
+  // 短路：无 <img 的页面（如 404）无需正则扫描
+  if (typeof htmlContent !== 'string' || !/<img/i.test(htmlContent)) {
+    return htmlContent;
+  }
   return htmlContent.replace(/<img(.*?)src="(.*?)"(.*?)>/gi, function(imgTag, src_before, src_value, src_after) {
     // 已由 tag 插件输出懒加载标记（data-src / data-srcset）的图片不重复处理
     if (/data-src/gi.test(imgTag)) {

package/scripts/filters/lib/img_onerror.js

@@ -6,6 +6,10 @@
 'use strict';
 
 module.exports.processSite = function(htmlContent) {
+  // 短路：无 <img 的页面（如 404）无需正则扫描
+  if (typeof htmlContent !== 'string' || !/<img/i.test(htmlContent)) {
+    return htmlContent;
+  }
   const default_image = this.theme.config.default.image;
   return htmlContent.replace(/<img(.*?)src="(.*?)"(.*?)>/gi, function(imgTag) {
     if (/="data:image(.*?)/gi.test(imgTag)) {

package/scripts/filters/lib/md_table.js

@@ -0,0 +1,46 @@
+/**
+ * md_table.js v1 | https://github.com/xaoxuu/hexo-theme-stellar/
+ * 普通 Markdown 表格包一层 .md-table-scroll 横向滚动容器，
+ * 宽度足够时铺满容器，内容超出容器宽度时横向滚动。
+ */
+
+'use strict';
+
+const cheerio = require('cheerio');
+
+/**
+ * 将内容中的普通 `<table>` 包一层 `.md-table-scroll` 容器。
+ * 排除代码高亮表格（.highlight）与 {% table %} 标签容器（.tag-plugin.table）。
+ */
+function wrapMdTables(htmlContent) {
+  // 短路：不含 <table 时无需解析，避免 cheerio 全量 parse + serialize
+  if (typeof htmlContent === 'string' && !htmlContent.includes('<table')) {
+    return htmlContent;
+  }
+  const $ = cheerio.load(htmlContent, null, false);
+  $('table').each(function () {
+    const $table = $(this);
+    if ($table.parent().is('.md-table-scroll')) {
+      return;
+    }
+    if ($table.closest('.highlight').length) {
+      return;
+    }
+    if ($table.closest('.tag-plugin.table').length) {
+      return;
+    }
+    $table.wrap('<div class="md-table-scroll"></div>');
+  });
+  return $.html();
+}
+
+module.exports.wrapMdTables = wrapMdTables;
+
+function processPost(data) {
+  if (data.content) {
+    data.content = wrapMdTables(data.content);
+  }
+  return data;
+}
+
+module.exports.processPost = processPost;

package/scripts/generators/search.js

@@ -1,8 +1,8 @@
 /**
  * https://github.com/wzpan/hexo-generator-search
  */
-const { stripHTML } = require('hexo-util')
 const { normalize_path } = require('../lib/path_utils')
+const { buildSearchIndex } = require('../lib/search_index')
 
 hexo.extend.generator.register('search_json_generator', function (locals) {
   if (this.theme.config.search.service != 'local_search') { return {} }
@@ -33,19 +33,11 @@ hexo.extend.generator.register('search_json_generator', function (locals) {
       temp_post.path = path === '/' ? '/' : path + '/'
     }
     if (cfg.content != false && post.content) {
-      var content = stripHTML(post.content.replace(/<span class="line">\d+<\/span>/g, '')).trim()
-      // 部分HTML标签
-      content = content.replace(/<iframe[\s|\S]+iframe>/g, '')
-      content = content.replace(/<hr>/g, '')
-      content = content.replace(/<br>/g, '')
-      // 去除HTML实体
-      content = content.replace(/&[^\s;]+;/g, "")
-      // 换行符换成空格
-      content = content.replace(/\\n/g, ' ')
-      content = content.replace(/\n/g, ' ')
-      // 多个连续空格换成单个空格
-      content = content.replace(/[\s]{2,}/g, ' ')
-      temp_post.content = content.trim()
+      const { content, anchors } = buildSearchIndex(post.content)
+      temp_post.content = content
+      if (anchors.length > 0) {
+        temp_post.anchors = anchors
+      }
     }
     if (post.tags && post.tags.length > 0) {
       var tags = []
@@ -64,10 +56,12 @@ hexo.extend.generator.register('search_json_generator', function (locals) {
     return temp_post
   }
 
+  // 循环外编译一次 skip_search 正则，避免每个 post/page 重复 new RegExp
+  const skipSearchPatterns = (cfg.skip_search || []).map(pattern => new RegExp('^' + pattern.replace(/\*/g, '.*') + '$'));
+
   function matchAndExit(path, patterns) {
     for (let pattern of patterns) {
-        const regexPattern = new RegExp('^' + pattern.replace(/\*/g, '.*') + '$');
-        if (path.match(regexPattern)) {
+        if (path.match(pattern)) {
             // console.log("Matched pattern:", pattern);
             return true;
         }
@@ -79,7 +73,7 @@ hexo.extend.generator.register('search_json_generator', function (locals) {
     posts.each(function(post) {
       var layout_list = ["post"]
       if (!layout_list.includes(post.layout)) return
-      if (cfg.skip_search && matchAndExit(post.path, cfg.skip_search)) return
+      if (cfg.skip_search && matchAndExit(post.path, skipSearchPatterns)) return
       if (post.indexing == false) return
       let temp_post = generateJson(post)
       res.push(temp_post)
@@ -89,7 +83,7 @@ hexo.extend.generator.register('search_json_generator', function (locals) {
     pages.each(function(page) {
       var layout_list = ["page", "wiki"]
       if (!layout_list.includes(page.layout)) return
-      if (cfg.skip_search && matchAndExit(page.path, cfg.skip_search)) return
+      if (cfg.skip_search && matchAndExit(page.path, skipSearchPatterns)) return
       if (page.indexing == false) return
       let temp_post = generateJson(page)
       res.push(temp_post)

package/scripts/generators/stellar-icons.js

@@ -0,0 +1,47 @@
+/* global hexo */
+'use strict';
+
+// 构建期生成客户端图标白名单文件：避免把 SVG 图标数据内联进每个页面的 defines。
+// 与 layout/_partial/scripts/defines.ejs 中旧的白名单保持一致（客户端通过 ctx.icons 读取）。
+hexo.extend.generator.register('stellar_icons', function () {
+  const icons = (this.theme.config && this.theme.config.icons) || {};
+  const keys = ['weibo:comment', 'default:loading-spinner', 'default:warning', 'weibo:repeat', 'weibo:like'];
+  const out = {};
+  // 去除 SVG 注释（避免 <!-- / </script> 解析风险），再转义 <
+  for (const k of keys) {
+    out[k] = ((icons[k]) || '').replace(/<!--[\s\S]*?-->/g, '');
+  }
+  const json = JSON.stringify(out).replace(/</g, '\\u003c');
+  return {
+    path: 'js/stellar-icons.js',
+    data: 'window.stellarIcons = ' + json + ';\nif (typeof ctx !== "undefined" && ctx) { ctx.icons = window.stellarIcons; }\n'
+  };
+});
+
+// 构建期生成按命名空间拆分的图标数据文件（js/icons/{ns}.json）：
+// 供客户端加载器 /js/icons.js 对非首屏图标占位符（svg.icon[data-icon]）做异步原位替换。
+// 数据源为合并后的 theme.config.icons（主题 _data/icons.yml + 站点 source/_data/icons.yml 覆盖），
+// 仅收集内联 SVG 值（URL 值由服务端直接输出 <img>，无需下发）。
+hexo.extend.generator.register('stellar_icon_sets', function () {
+  const icons = (this.theme.config && this.theme.config.icons) || {};
+  const sets = {};
+  for (const key of Object.keys(icons)) {
+    const value = icons[key];
+    if (typeof value !== 'string' || !value.trim().startsWith('<svg')) {
+      continue;
+    }
+    const ns = key.split(':')[0];
+    if (ns.length === 0) {
+      continue;
+    }
+    if (!sets[ns]) {
+      sets[ns] = {};
+    }
+    // 去除 SVG 注释，避免注释内容在注入 HTML 时引发解析问题
+    sets[ns][key] = value.replace(/<!--[\s\S]*?-->/g, '');
+  }
+  return Object.keys(sets).map((ns) => ({
+    path: `js/icons/${ns}.json`,
+    data: JSON.stringify({ [ns]: sets[ns] })
+  }));
+});

package/scripts/helpers/ai_label.js

@@ -0,0 +1,29 @@
+/* global hexo */
+'use strict';
+
+const { buildAiLabel, resolveAiKey } = require('../lib/ai_label');
+
+// 文章 AI 成分标签：front-matter 用 ai_label: manual / reviewed / polished / generated 标记，
+// 未设置时取配置 article.ai_label.default（为空则不渲染）；
+// 文案由多语言系统提供（languages/*.yml 的 meta.ai_label.*，缺失时不渲染），
+// 颜色与可选图标由配置 article.ai_label 提供（默认在主题 _config.yml，站点可覆盖）。
+hexo.extend.helper.register('ai_label', function(value, extraClass, noColor) {
+  const article = hexo.theme.config.article;
+  const labelConfig = article && article.ai_label;
+  const key = resolveAiKey(value, labelConfig);
+  if (key && (!labelConfig || !labelConfig[key])) {
+    console.warn('[ai_label] 未知的 ai_label 值: ' + key);
+  }
+  if (!key) {
+    return '';
+  }
+  const def = labelConfig && labelConfig[key];
+  const iconHtml = (def && def.icon) ? hexo.utils.icon(def.icon) : '';
+  const __ = (this && typeof this.__ === 'function') ? this.__ : hexo.theme.i18n.__(hexo.config.language);
+  const i18nKey = 'meta.ai_label.' + key;
+  const text = __(i18nKey);
+  if (!text || text === i18nKey) {
+    return '';
+  }
+  return buildAiLabel(key, labelConfig, text, extraClass, iconHtml, noColor);
+});

package/scripts/helpers/icon.js

@@ -1,5 +1,5 @@
 'use strict';
 
-hexo.extend.helper.register('icon', function(key, args) {
-  return hexo.utils.icon(key, args)
+hexo.extend.helper.register('icon', function(key, args, inline) {
+  return hexo.utils.icon(key, args, inline)
 })