hexo-theme-stellar 1.40.0 → 1.41.0

package/scripts/helpers/json_ld.js

@@ -6,6 +6,7 @@
 'use strict';
 
 const util = require('hexo-util');
+const { postImages, postDescription } = require('../lib/seo');
 
 hexo.extend.helper.register('json_ld', function(args) {
   const page = this.page;
@@ -37,6 +38,13 @@ hexo.extend.helper.register('json_ld', function(args) {
   }
 
   if (this.is_post()) {
+    const images = postImages({
+      cover: page.cover,
+      banner: page.banner,
+      photos: page.photos,
+      content: page.content,
+      defaultCover: this.theme.default && this.theme.default.cover
+    });
     schema = {
       '@context': 'https://schema.org',
       '@type': 'BlogPosting',
@@ -45,7 +53,7 @@ hexo.extend.helper.register('json_ld', function(args) {
       dateCreated: page.date.format(),
       dateModified: page.updated.format(),
       datePublished: page.date.format(),
-      description: this.strip_html(page.excerpt),
+      description: postDescription({ excerpt: page.excerpt, content: page.content }),
       headline: page.title,
       mainEntityOfPage: {
         '@type': 'WebPage',
@@ -59,18 +67,7 @@ hexo.extend.helper.register('json_ld', function(args) {
       schema.keywords = page.tags.map((tag) => tag.name).join(', ');
     }
 
-    let images = [];
-    if (page.photos && page.photos.length > 0) {
-      images = images.concat(page.photos);
-    }
-
-    if (page.cover?.length > 0) {
-      images = images.unshift(page.cover);
-    } else if (page.banner?.length > 0) {
-      images = images.unshift(page.banner);
-    }
-
-    schema.thumbnailUrl = page.cover || page.banner;
+    schema.thumbnailUrl = images[0] || undefined;
     schema.image = images;
 
   } else if (isPage || this.is_home()) {

package/scripts/helpers/related_posts.js

@@ -27,16 +27,9 @@ hexo.extend.helper.register('popular_posts_wrapper', function(args){
     <section class='body'>
     `;
 
-  const posts = this.site.posts;
-  const root = this.config.root;
-
   function listItem(obj){
     var el = '';
     el += '<a class="item" href="' + esc(obj.path) + '" title="' + esc(obj.title) + '">';
-    var p = posts.filter(p => root + p.path == obj.path)
-    if (p && p.length > 0) {
-      p = p.data[0];
-    }
     el += '<span class="title">' + esc(obj.title) + '</span>';
     if (obj.excerpt && obj.excerpt.length > 0) {
       el += '<span class="excerpt">' + esc(util.truncate(util.stripHTML(obj.excerpt), {length: 120})) + '</span>';

package/scripts/helpers/seo.js

@@ -0,0 +1,9 @@
+/* global hexo */
+'use strict';
+
+const { firstContentImage } = require('../lib/seo');
+
+// 正文首图地址：供 og:image 与结构化数据兜底使用（模板内直接调用）。
+hexo.extend.helper.register('first_content_image', function(content) {
+  return firstContentImage(content);
+});

package/scripts/lib/ai_label.js

@@ -0,0 +1,55 @@
+'use strict';
+
+const { escapeHTML } = require('hexo-util');
+
+// 文章 AI 成分标签（ai_label）：颜色规范化 + 标签 HTML 生成。
+// 文案由调用方传入（多语言系统提供），经 HTML 转义后输出；
+// 文字使用配置色（无背景），缺 # 自动补全；可选 iconHtml 渲染在文案前；
+// noColor 时输出不带内联样式（继承默认文字色，用于 banner 含图片场景）；
+// 样式由调用方通过 extraClass 传入上下文类。
+
+function normalizeColor(color) {
+  if (color == null) {
+    return '';
+  }
+  let text = String(color).trim();
+  if (!text) {
+    return '';
+  }
+  if (!text.startsWith('#')) {
+    text = '#' + text;
+  }
+  return text;
+}
+
+// 解析实际生效的标签键：文章设置 ai_label 时优先使用，否则取配置 default（为空则不渲染）
+function resolveAiKey(value, labelConfig) {
+  if (value && typeof value === 'string') {
+    return value;
+  }
+  return (labelConfig && labelConfig.default) || '';
+}
+
+function buildAiLabel(value, labelConfig, text, extraClass, iconHtml, noColor) {
+  if (!value || typeof value !== 'string' || !labelConfig || typeof labelConfig !== 'object') {
+    return '';
+  }
+  const def = labelConfig[value];
+  if (!def || typeof def !== 'object' || !text) {
+    return '';
+  }
+  const cls = ['ai-label'];
+  if (extraClass) {
+    cls.unshift(extraClass);
+  }
+  const safeText = escapeHTML(String(text));
+  const color = normalizeColor(def.color);
+  const icon = iconHtml || '';
+  const className = cls.join(' ');
+  if (!noColor && color) {
+    return `<span class="${className}" style="color:${color}">${icon}${safeText}</span>`;
+  }
+  return `<span class="${className}">${icon}${safeText}</span>`;
+}
+
+module.exports = { buildAiLabel, normalizeColor, resolveAiKey };

package/scripts/lib/doc_tree.js

@@ -0,0 +1,267 @@
+/**
+ * doc_tree.js v2 | https://github.com/xaoxuu/hexo-theme-stellar/
+ *
+ * Wiki 文档树构建（纯函数，供 events/lib/doc_tree.js 调用与单测覆盖）。
+ * 与旧实现的输出语义保持一致，仅把重复的 filter/some 遍历改为单遍 Map 索引：
+ * - 页面按 wiki 分组一次（O(W+P) 替代 O(W*P)）；
+ * - 项目内按 path_key 分组一次，首页解析与 sections 组装改走索引查询；
+ * - all_tags / relatedItems 用 Set/Map 去重，输出顺序不变。
+ */
+
+'use strict';
+
+const { normalize_path } = require('./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(data) {
+  var wiki = { tree: {} };
+  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;
+}
+
+/**
+ * 构建 wiki 文档树。
+ * @param {Object} options
+ * @param {Object} options.data 站点 _data（含 wiki/ 前缀的 YAML 数据）
+ * @param {Array|Object} options.pages 站点 pages（warehouse Query 或数组）
+ * @param {Array} options.shelf 上架项目 id 列表
+ * @param {Object} options.siteTree 主题配置 site_tree（取 index_wiki.base_dir）
+ */
+function buildWikiTree({ data, pages, shelf, siteTree }) {
+  // wiki 配置
+  var wiki = getWikiObject(data);
+  // wiki 所有页面
+  const wiki_pages = pages.filter(p => (p.wiki != null)).map(p => new WikiPage(p));
+
+  // 单遍分组：wiki id → WikiPage[]（保持 wiki_pages 原始顺序）
+  const pagesByWiki = new Map();
+  for (const wp of wiki_pages) {
+    let arr = pagesByWiki.get(wp.wiki);
+    if (arr == null) {
+      arr = [];
+      pagesByWiki.set(wp.wiki, arr);
+    }
+    arr.push(wp);
+  }
+
+  // 上架的项目列表
+  wiki.shelf = shelf || [];
+
+  // 按 tree 键序过滤出有页面的项目（等价于旧实现 wiki_pages.some 判定）
+  const wiki_list = Object.keys(wiki.tree).filter(id => pagesByWiki.has(id));
+
+  // 数据整合：项目标签
+  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 = pagesByWiki.get(id) || [];
+
+    // 单遍 path_key 索引：同一 path_key 可能对应多个页面，保持数组与顺序
+    const pagesByPathKey = new Map();
+    for (const p of sub_pages) {
+      let arr = pagesByPathKey.get(p.path_key);
+      if (arr == null) {
+        arr = [];
+        pagesByPathKey.set(p.path_key, arr);
+      }
+      arr.push(p);
+    }
+
+    // 首页
+    // 未特别指定首页时，获取TOC第一页作为首页
+    var homepage = item.homepage;
+    if (homepage == null && item.tree != null) {
+      for (let tid of Object.keys(item.tree)) {
+        const sec = item.tree[tid];
+        for (let key of sec) {
+          const hs = pagesByPathKey.get(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) {
+      // 根据配置设置顺序
+      const assignedPathKeys = new Set();
+      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);
+          const matched = pagesByPathKey.get(pagePathKey) || [];
+          sec.pages = sec.pages.concat(matched);
+          if (matched.length > 0) {
+            assignedPathKeys.add(pagePathKey);
+          }
+        }
+        sections.push(sec);
+      }
+      // 未被任何 section 收录的页面归入 '...' 分组（顺序同 sub_pages 过滤结果）
+      others = sub_pages.filter(p => !assignedPathKeys.has(p.path_key));
+      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 = [];
+    // 与旧实现 items.includes(tag_name) 判定等价（项目 id 恰等于标签名时的去重行为）
+    var itemsSet = new Set();
+    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 && itemsSet.has(tag_name) === false) {
+        itemsSet.add(item.id);
+        items.push(item.id);
+      }
+    }
+    all_tags[tag_name] = {
+      name: tag_name,
+      path: (siteTree.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;
+  return wiki;
+}
+
+module.exports = {
+  buildWikiTree,
+  WikiPage
+};

package/scripts/lib/notebooks.js

@@ -0,0 +1,181 @@
+/**
+ * notebooks.js v1
+ *
+ * 笔记本系统构建（纯函数部分，供 events/lib/notebooks.js 调用与单测覆盖）。
+ * 把「每个笔记本全量 filter 一遍全部页面」改为单遍分组（O(NB+P) 替代 O(NB*P)），
+ * 标签树与 noteMap 构建逻辑和元素顺序不变。
+ */
+
+'use strict';
+
+const { normalize_path } = require('./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);
+}
+
+/**
+ * 单遍按 notebook id 分组页面。
+ * 等价的旧逻辑：对每个笔记本执行 allPages.filter(p => p.notebook === notebook.id)。
+ * @param {Array} pages 页面数组（warehouse Query 的 .data）
+ * @returns {Map<string, Array>}
+ */
+function groupPagesByNotebook(pages) {
+  const pagesByNotebook = new Map();
+  for (const page of pages) {
+    if (page.notebook == null) {
+      continue;
+    }
+    let arr = pagesByNotebook.get(page.notebook);
+    if (arr == null) {
+      arr = [];
+      pagesByNotebook.set(page.notebook, arr);
+    }
+    arr.push(page);
+  }
+  return pagesByNotebook;
+}
+
+function prepareNotebook(id, info, ctx, pages) {
+  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.
+  for (const page of pages) {
+    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 pagesByNotebook = groupPagesByNotebook(ctx.locals.get('pages').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, pagesByNotebook.get(id) || []));
+  }
+  list.sort((a, b) => a.sort - b.sort);
+  for (const info of list) {
+    notebooks.tree[info.id] = info;
+  }
+
+  return notebooks;
+}
+
+module.exports = {
+  groupPagesByNotebook,
+  NotePage,
+  getNotebooksObject
+};

package/scripts/lib/search_index.js

@@ -0,0 +1,82 @@
+'use strict';
+
+/**
+ * 本地搜索索引正文构建：从渲染后 HTML 提取搜索正文与章节锚点。
+ *
+ * - 返回的 content 与 scripts/generators/search.js 原有全文归一化结果逐字节一致；
+ * - anchors 每项 { id, text, offset }，offset 指向标题文本在 content 中的起始位置，
+ *   与客户端 content.indexOf() 的偏移严格对齐。
+ */
+
+const { stripHTML } = require('hexo-util');
+
+// 标题标签切分：捕获 level / 开始标签属性 / 内部 HTML
+const HEADING_RE = /<h([1-6])\b([^>]*)>([\s\S]*?)<\/h\1>/gi;
+const HEADING_ID_RE = /id="([^"]*)"/;
+
+// 全局预清理：与 scripts/generators/search.js 原有顺序保持一致（先于 stripHTML）
+function preClean(html) {
+  return String(html || '')
+    .replace(/<span class="line">\d+<\/span>/g, '')
+    .replace(/<iframe[\s|\S]+iframe>/g, '')
+    .replace(/<hr>/g, '')
+    .replace(/<br>/g, '');
+}
+
+// 单段清洗：stripHTML 之后移除实体、换行转空格、空白折叠（不做全文 trim）
+function cleanChunk(chunk) {
+  return stripHTML(chunk)
+    .replace(/&[^\s;]+;/g, '')
+    .replace(/\\n/g, ' ')
+    .replace(/\n/g, ' ')
+    .replace(/[\s]{2,}/g, ' ');
+}
+
+// 跨段拼接：上一段以空白结尾且本段以空白开头时，合并为单个空白，
+// 与整段式 [\s]{2,} 折叠在边界上的结果一致
+function mergeChunk(buffer, chunk) {
+  if (buffer && /\s$/.test(buffer) && /^\s/.test(chunk)) {
+    return chunk.replace(/^\s+/, '');
+  }
+  return chunk;
+}
+
+/**
+ * 构建搜索索引条目：{ content, anchors }
+ * @param {string} html 渲染后的页面 HTML
+ */
+function buildSearchIndex(html) {
+  const parts = preClean(html).split(HEADING_RE);
+  let content = '';
+  const anchors = [];
+  for (let i = 0; i < parts.length; i += 4) {
+    const before = parts[i] || '';
+    const level = parts[i + 1];
+    const attrs = parts[i + 2] || '';
+    const inner = parts[i + 3] || '';
+    content += mergeChunk(content, cleanChunk(before));
+    if (!level) {
+      continue;
+    }
+    const rawText = cleanChunk(inner);
+    const text = rawText.trim();
+    const merged = mergeChunk(content, rawText);
+    const appended = merged.slice(content.length);
+    const offset = content.length + (appended.length - appended.trimStart().length);
+    const match = attrs.match(HEADING_ID_RE);
+    if (match && text.length > 0) {
+      anchors.push({ id: match[1], text, offset });
+    }
+    content += merged;
+  }
+  const trimmed = content.trim();
+  const shift = content.length - content.trimStart().length;
+  if (shift > 0) {
+    for (const anchor of anchors) {
+      anchor.offset -= shift;
+    }
+  }
+  return { content: trimmed, anchors };
+}
+
+module.exports = { buildSearchIndex };