create-lumfall 1.0.0 → 1.1.1

package/templates/document/app/pages/docs/markdown/highlight.js

@@ -1,30 +0,0 @@
-// highlight.js 按需注册：只打包文档站实际用到的语言，控制 vendor 体积。
-import hljs from "highlight.js/lib/core";
-import javascript from "highlight.js/lib/languages/javascript";
-import typescript from "highlight.js/lib/languages/typescript";
-import xml from "highlight.js/lib/languages/xml";
-import css from "highlight.js/lib/languages/css";
-import less from "highlight.js/lib/languages/less";
-import json from "highlight.js/lib/languages/json";
-import bash from "highlight.js/lib/languages/bash";
-import yaml from "highlight.js/lib/languages/yaml";
-import markdown from "highlight.js/lib/languages/markdown";
-import plaintext from "highlight.js/lib/languages/plaintext";
-
-[
-  ["javascript", javascript],
-  ["typescript", typescript],
-  ["xml", xml],
-  ["css", css],
-  ["less", less],
-  ["json", json],
-  ["bash", bash],
-  ["yaml", yaml],
-  ["markdown", markdown],
-  ["plaintext", plaintext],
-].forEach(([name, language]) => hljs.registerLanguage(name, language));
-
-// highlight.js 11 不内置 vue 语法，用 xml 规则近似高亮 .vue / 模板块
-hljs.registerAliases(["vue", "html"], { languageName: "xml" });
-
-export default hljs;

package/templates/document/app/pages/docs/markdown/index.js

@@ -1,129 +0,0 @@
-// markdown-it 渲染器：标题锚点 + TOC 收集、代码块外壳（语言标签 + 复制按钮）、
-// 外链新窗口打开、文档内 .md 相对链接转站内路由、::: tip/warning/danger 提示块。
-import MarkdownIt from "markdown-it";
-import MarkdownItContainer from "markdown-it-container";
-import hljs from "./highlight";
-import { slugify, resolveDocHref } from "../utils";
-
-const md = new MarkdownIt({
-  html: true,
-  linkify: true,
-  breaks: false,
-  typographer: false,
-});
-
-// ::: <type> [自定义标题] 提示块（tip / info / warning / danger）
-const CONTAINER_DEFAULT_TITLES = {
-  tip: "提示",
-  info: "说明",
-  warning: "注意",
-  danger: "危险",
-};
-
-Object.keys(CONTAINER_DEFAULT_TITLES).forEach((type) => {
-  md.use(MarkdownItContainer, type, {
-    render(tokens, idx) {
-      if (tokens[idx].nesting === 1) {
-        const info = tokens[idx].info.trim().slice(type.length).trim();
-        const title = info || CONTAINER_DEFAULT_TITLES[type];
-        return (
-          `<div class="doc-container doc-container-${type}">` +
-          `<p class="doc-container-title">${md.utils.escapeHtml(title)}</p>`
-        );
-      }
-      return "</div>";
-    },
-  });
-});
-
-// 代码块：highlight.js 高亮（未识别语言则原样转义），外层加语言标签与复制按钮
-md.renderer.rules.fence = (tokens, idx) => {
-  const token = tokens[idx];
-  const lang = (token.info || "").trim().split(/\s+/)[0];
-
-  let codeHtml;
-  if (lang && hljs.getLanguage(lang)) {
-    try {
-      codeHtml = hljs.highlight(token.content, {
-        language: lang,
-        ignoreIllegals: true,
-      }).value;
-    } catch (e) {
-      codeHtml = md.utils.escapeHtml(token.content);
-    }
-  } else {
-    codeHtml = md.utils.escapeHtml(token.content);
-  }
-
-  const langLabel = md.utils.escapeHtml(lang || "text");
-  return (
-    `<div class="doc-code-block">` +
-    `<div class="doc-code-bar"><span class="doc-code-lang">${langLabel}</span>` +
-    `<button class="doc-code-copy" type="button">复制</button></div>` +
-    `<pre><code class="hljs">${codeHtml}</code></pre></div>\n`
-  );
-};
-
-// 标题开标签：生成唯一 id（供 TOC / 锚点 / 搜索跳转），并收集 h2/h3 进 TOC
-md.renderer.rules.heading_open = (tokens, idx, options, env, self) => {
-  const token = tokens[idx];
-  const level = Number(token.tag.slice(1));
-  const inline = tokens[idx + 1];
-  const text = (inline ? inline.content : "").trim();
-
-  const base = slugify(text) || `heading-${idx}`;
-  const count = env.slugCount[base] || 0;
-  env.slugCount[base] = count + 1;
-  const id = count ? `${base}-${count + 1}` : base;
-
-  token.attrSet("id", id);
-  env.currentHeadingId = id;
-  if (level >= 2 && level <= 3) {
-    env.toc.push({ level, text, id });
-  }
-  return self.renderToken(tokens, idx, options);
-};
-
-// 标题闭标签：在标题内部追加悬停可见的 # 锚点链接
-md.renderer.rules.heading_close = (tokens, idx, options, env, self) => {
-  const id = env.currentHeadingId || "";
-  const anchor = id
-    ? `<a class="doc-header-anchor" href="#${id}" aria-hidden="true">#</a>`
-    : "";
-  return anchor + self.renderToken(tokens, idx, options);
-};
-
-// 链接开标签：外链新窗口；文档内相对 .md 链接（./xx.md、../xx.md）转站内路由
-const defaultLinkOpen =
-  md.renderer.rules.link_open ||
-  ((tokens, idx, options, env, self) => self.renderToken(tokens, idx, options));
-
-md.renderer.rules.link_open = (tokens, idx, options, env, self) => {
-  const token = tokens[idx];
-  const href = token.attrGet("href") || "";
-
-  if (/^https?:\/\//i.test(href)) {
-    token.attrSet("target", "_blank");
-    token.attrSet("rel", "noopener noreferrer");
-  } else if (!href.startsWith("#") && env.docPath) {
-    const resolved = resolveDocHref(env.docPath, href);
-    if (resolved) {
-      token.attrSet("href", resolved.path + resolved.hash);
-    }
-  }
-  return defaultLinkOpen(tokens, idx, options, env, self);
-};
-
-/**
- * 渲染 markdown
- * @param {string} source markdown 原文
- * @param {string} docPath 当前文档路径（相对 docs/），用于解析相对链接
- * @returns {{ html: string, toc: Array<{level:number, text:string, id:string}> }}
- */
-export function renderMarkdown(source, docPath) {
-  const env = { toc: [], slugCount: {}, docPath };
-  const html = md.render(source, env);
-  return { html, toc: env.toc };
-}
-
-export default md;

package/templates/document/app/pages/docs/search.js

@@ -1,142 +0,0 @@
-// 站内搜索：对全部文档做轻量内存索引（标题 / 小节标题 / 正文），
-// 返回带高亮摘要的结果。文档规模在几百页以内时体验足够，无需后端参与。
-import { getAllDocs } from "./content";
-import { slugify, escapeHtml } from "./utils";
-
-let index = null;
-
-/** 懒构建索引：文档内容在构建时已打进 bundle，这里只做文本预处理 */
-function buildIndex() {
-  if (index) {
-    return index;
-  }
-
-  const all = getAllDocs();
-  index = Object.entries(all).map(([docPath, source]) => {
-    // 去掉代码块再提取文本，避免把代码当正文搜索
-    const withoutCode = String(source).replace(/```[\s\S]*?```/g, " ");
-
-    const headings = [];
-    const headingRe = /^(#{2,3})\s+(.+?)\s*#*\s*$/gm;
-    let match;
-    while ((match = headingRe.exec(withoutCode))) {
-      headings.push({
-        level: match[1].length,
-        text: match[2].replace(/[#*`]/g, "").trim(),
-      });
-    }
-
-    const text = withoutCode
-      .replace(/<[^>]+>/g, " ")
-      .replace(/[#>*`~[\]()!_|:-]/g, " ")
-      .replace(/\s+/g, " ")
-      .trim()
-      .toLowerCase();
-
-    return { docPath, headings, text };
-  });
-
-  return index;
-}
-
-function buildTitleMap(sidebar) {
-  const map = {};
-  (sidebar || []).forEach((group) => {
-    (group.items || []).forEach((item) => {
-      map[item.path.replace(/^\/view\/docs\//, "")] = item.text;
-    });
-  });
-  return map;
-}
-
-/** 把关键词片段包上 <mark>，先转义再替换，保证安全 */
-function highlight(text, keyword) {
-  if (!keyword) {
-    return escapeHtml(text);
-  }
-  const escaped = escapeHtml(text);
-  const pattern = keyword
-    .split(/\s+/)
-    .filter(Boolean)
-    .map((term) => term.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"))
-    .join("|");
-  if (!pattern) {
-    return escaped;
-  }
-  return escaped.replace(new RegExp(`(${pattern})`, "gi"), "<mark>$1</mark>");
-}
-
-/**
- * 搜索文档
- * @param {string} keyword 关键词，支持空格分词
- * @param {object} docsConfig 文档站配置（取侧边栏标题）
- * @returns {Array<{docPath, title, titleHtml, heading, anchor, snippet}>}
- */
-export function searchDocs(keyword, docsConfig) {
-  const terms = String(keyword || "")
-    .trim()
-    .toLowerCase()
-    .split(/\s+/)
-    .filter(Boolean);
-  if (!terms.length) {
-    return [];
-  }
-
-  const titleMap = buildTitleMap(docsConfig.sidebar);
-  const results = [];
-
-  buildIndex().forEach(({ docPath, headings, text }) => {
-    const title = titleMap[docPath] || docPath;
-    const titleLower = title.toLowerCase();
-
-    let score = 0;
-    let matchedHeading = null;
-
-    terms.forEach((term) => {
-      if (titleLower.includes(term)) {
-        score += 100;
-      }
-      // 中文场景：标题无空格分词，按整串 contains；正文按出现次数计分
-      const occurrences = text.split(term).length - 1;
-      score += occurrences;
-
-      if (!matchedHeading) {
-        const heading = headings.find((h) => h.text.toLowerCase().includes(term));
-        if (heading) {
-          matchedHeading = heading;
-          score += 30;
-        }
-      }
-    });
-
-    if (score <= 0) {
-      return;
-    }
-
-    // 摘要：取第一个命中的关键词前后各 70 字符
-    let snippet = "";
-    const firstTerm = terms[0];
-    const pos = text.indexOf(firstTerm);
-    if (pos >= 0) {
-      const start = Math.max(0, pos - 70);
-      const end = Math.min(text.length, pos + firstTerm.length + 70);
-      snippet = `${start > 0 ? "…" : ""}${text.slice(start, end).trim()}${
-        end < text.length ? "…" : ""
-      }`;
-    } else {
-      snippet = text.slice(0, 140);
-    }
-
-    results.push({
-      docPath,
-      title,
-      titleHtml: highlight(title, keyword),
-      heading: matchedHeading ? matchedHeading.text : "",
-      anchor: matchedHeading ? slugify(matchedHeading.text) : "",
-      snippet: highlight(snippet, keyword),
-      score,
-    });
-  });
-
-  return results.sort((a, b) => b.score - a.score).slice(0, 10);
-}