hexo-text-pipeline 0.2.0 → 0.3.0

package/README.md

@@ -175,7 +175,7 @@ text_pipeline:
 
 ## Development
 
-Zero runtime dependencies, Node >= 16.
+The only runtime dependency is `hexo-util` (ships with Hexo itself; npm dedupes to the copy your site already has, zero extra install cost). Node >= 16.
 
 ```bash
 npm test   # node --test

package/README.zh-CN.md

@@ -175,7 +175,7 @@ text_pipeline:
 
 ## 开发
 
-零运行时依赖，Node >= 16。
+唯一运行时依赖是 `hexo-util`（Hexo 本体自带，npm 会直接复用站点已有的那份，零额外安装成本）。Node >= 16。
 
 ```bash
 npm test   # node --test

package/lib/presets/obsidian/converters/mermaid/index.js

@@ -1,5 +1,7 @@
 'use strict';
 
+const { escapeHTML } = require('hexo-util');
+
 const DEFAULT_SCRIPT_SRC = 'https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.min.js';
 const DEFAULT_CLASS = 'mermaid';
 
@@ -11,10 +13,6 @@ const DEFAULT_CLASS = 'mermaid';
  * 前端脚本默认按需注入（页面没有 .mermaid 元素时不加载 CDN）：
  * converters.mermaid 子配置：class / inject_script / script_src / theme。
  */
-function escapeHtml(text) {
-  return text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
-}
-
 function transformMermaidBlocks(content, className) {
   const lines = content.split('\n');
   const out = [];
@@ -42,7 +40,7 @@ function transformMermaidBlocks(content, className) {
         body.push(lines[j]);
       }
       if (closed) {
-        out.push('<pre class="' + className + '">' + escapeHtml(body.join('\n')) + '</pre>');
+        out.push('<pre class="' + className + '">' + escapeHTML(body.join('\n')) + '</pre>');
         i = j;
         continue;
       }

package/lib/presets/obsidian/converters/wikilink/index.js

@@ -1,5 +1,6 @@
 'use strict';
 
+const { slugize } = require('hexo-util');
 const { replaceOutsideCode } = require('../../../../core/markdown-guard');
 const { normalizeBase } = require('../../../../core/config');
 const { getPostIndex, resolvePostByTarget, buildPostHref } = require('../../post-index');
@@ -11,6 +12,8 @@ const { getPostIndex, resolvePostByTarget, buildPostHref } = require('../../post
  * - ![[...]] 是嵌入，归 embed node 管，这里用 lookbehind 跳过
  * - #^block-id 块引用锚点在渲染后的 HTML 里不存在，丢弃锚点只留文章链接
  * - [[#标题]]（无 target 的同页链接）改写为页内锚点
+ * - 锚点用 hexo-util 的 slugize 生成——与 hexo-renderer-marked 给标题生成 id
+ *   的是同一个函数（含 marked.modifyAnchors 配置），保证页内跳转不断
  */
 function parseWikiLink(raw) {
   const firstPipe = raw.indexOf('|');
@@ -24,7 +27,14 @@ function parseWikiLink(raw) {
   return { target, anchor, alias };
 }
 
-function createWikiLinkReplacer(index, domainPrefix) {
+// 与 hexo-renderer-marked 的标题 id 同源：slugize + modifyAnchors（1 小写 / 2 大写）。
+// slug 再过 encodeURIComponent 保证 markdown 链接语法安全（中文等百分号编码后，
+// 浏览器解码 fragment 仍命中原 id）。
+function anchorToHash(anchor, anchorTransform) {
+  return '#' + encodeURIComponent(slugize(anchor, { transform: anchorTransform }));
+}
+
+function createWikiLinkReplacer(index, domainPrefix, anchorTransform) {
   return function replaceWikiLinks(segment) {
     return segment.replace(/(?<!!)\[\[([^\]]+)\]\]/g, (full, inner) => {
       const parsed = parseWikiLink(inner);
@@ -32,7 +42,7 @@ function createWikiLinkReplacer(index, domainPrefix) {
       // 同页链接 [[#标题]]：没有 target，只有锚点
       if (!parsed.target) {
         if (!parsed.anchor || parsed.anchor.startsWith('^')) return full;
-        return '[' + (parsed.alias || parsed.anchor) + '](#' + encodeURIComponent(parsed.anchor) + ')';
+        return '[' + (parsed.alias || parsed.anchor) + '](' + anchorToHash(parsed.anchor, anchorTransform) + ')';
       }
 
       const post = resolvePostByTarget(index, parsed.target);
@@ -42,7 +52,8 @@ function createWikiLinkReplacer(index, domainPrefix) {
       if (!href) return full;
 
       // 块引用锚点（#^id）在 HTML 里没有对应元素，降级为文章链接
-      const anchor = parsed.anchor && !parsed.anchor.startsWith('^') ? '#' + encodeURIComponent(parsed.anchor) : '';
+      const anchor =
+        parsed.anchor && !parsed.anchor.startsWith('^') ? anchorToHash(parsed.anchor, anchorTransform) : '';
       const text = parsed.alias || parsed.target;
 
       return '[' + text + '](' + href + anchor + ')';
@@ -58,7 +69,12 @@ module.exports = {
   },
   convert(content, ctx) {
     const index = getPostIndex(ctx.hexo);
-    const replacer = createWikiLinkReplacer(index, normalizeBase(ctx.presetConfig.domain_prefix));
+    const marked = (ctx.hexo.config && ctx.hexo.config.marked) || {};
+    const replacer = createWikiLinkReplacer(
+      index,
+      normalizeBase(ctx.presetConfig.domain_prefix),
+      marked.modifyAnchors
+    );
     return replaceOutsideCode(content, replacer);
   },
   _internal: { parseWikiLink, createWikiLinkReplacer }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hexo-text-pipeline",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "A general-purpose hooks bus for Hexo's render pipeline: hang your own scripts/commands on any text stage (text in, text out, edit-and-use), with a checker system as the safety net. Ships an Obsidian Flavored Markdown preset.",
   "main": "index.js",
   "files": [
@@ -37,5 +37,8 @@
   },
   "engines": {
     "node": ">=16"
+  },
+  "dependencies": {
+    "hexo-util": "^2.7.0 || ^3.0.0 || ^4.0.0"
   }
 }