vitepress-allyouneed 0.3.0-beta.1 → 0.3.0

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 本项目遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/);版本号遵循 [SemVer](https://semver.org/lang/zh-CN/)。
 
+## [0.3.0] - 2026-05-20
+
+正式版。汇集 v0.3 全部新功能(Obsidian 语法 6 模块、sidebar 自动生成全套、DocHeader banner、i18n 集成、`_sidebar.md` 覆盖等),并修两个 deploy 关键 bug。
+
+### Fixed(0.3.0-beta.0 → 0.3.0)
+- **build-mode base 双重 prefix → 404**:`entry.url` 之前**包含 base**(`/<base>/foo`),VitePress render 时**再** prepend base → `/<base>/<base>/foo` → GitHub Pages 等子路径部署全部 404。现 `computeUrl` 始终输出**不带 base 的 site-root 相对 URL**(`/foo`),VitePress 统一 prepend。影响 wikilink `<a href>`、sidebar/nav link、per-folder Record key、`_perspectives_/` fallback 等所有内部 URL。
+- **i18n nav 注入丢失**:VitePress i18n 下 `themeConfig.locales[lang].themeConfig.nav` 覆盖顶层 nav,Perspectives 下拉在 EN locale 消失。wrapper 现在给**所有 locale 的 nav** 都注入。
+- **跨 locale nav 链接 404**:EN locale 写 `link: '/test/'` 被解释为 locale-relative `/en/test/`。example 配置已修正(EN nav 只列已翻译 page)。
+- **Perspectives 视图页 sidebar 显示扁平 fallback 列表**(用户反馈不够有用)→ 视图页自动 frontmatter `sidebar: false`,只剩中间 graph/stats/tags 组件全屏展示。
+
+### Added(0.3.0-beta.0 → 0.3.0)
+- 11 篇 EN 翻译文档(`en/guide/{overview, docs×6, advanced×4}`)
+- VitePress 原生 i18n 集成:wrapper 自动识别 `themeConfig.locales`,给每个 non-root locale 用 `includePrefix` 生成独立 sidebar
+- `sidebarAuto.includePrefix` / `excludePrefixes` 公开选项
+
 ## [0.3.0-beta.1] - 2026-05-20
 
 ### Fixed

package/dist/index.cjs

@@ -570,7 +570,7 @@ function computeUrl(rel, options) {
   const pathPart = isIndex ? noExt.replace(/(^|\/)(index|README)$/i, "$1") : noExt;
   const segments = pathPart.split("/").filter(Boolean);
   if (segments.length === 0) {
-    return options.base;
+    return "/";
   }
   const last = segments[segments.length - 1];
   if (!isIndex) {
@@ -578,7 +578,7 @@ function computeUrl(rel, options) {
   } else if (!options.cleanUrls) {
     segments.push("index.html");
   }
-  return buildUrl(options.base, segments);
+  return buildUrl("/", segments);
 }
 function pushToArrayMap(m, k, v) {
   const arr = m.get(k);
@@ -2067,6 +2067,7 @@ function renderTemplate(v) {
     "---",
     `title: ${v.title}`,
     "layout: doc",
+    "sidebar: false",
     "aside: false",
     "outline: false",
     "---",
@@ -2426,12 +2427,15 @@ function injectViewsSidebar(sidebar, options) {
         }
       }
     }
-    const base = options.base.endsWith("/") ? options.base : options.base + "/";
     const prefix = options.views.urlPrefix ? options.views.urlPrefix.replace(/^\/+|\/+$/g, "") : "";
     if (prefix) {
-      const persPath = `${base}${prefix}/`;
+      const persPath = `/${prefix}/`;
       if (!sidebar[persPath]) {
-        sidebar[persPath] = buildPerspectivesFallbackSidebar(sidebar, group, base);
+        sidebar[persPath] = buildPerspectivesFallbackSidebar(
+          sidebar,
+          group,
+          options.base.endsWith("/") ? options.base : options.base + "/"
+        );
       }
     }
     return sidebar;
@@ -2439,40 +2443,32 @@ function injectViewsSidebar(sidebar, options) {
   return [group];
 }
 function buildPerspectivesFallbackSidebar(allSidebars, group, base) {
-  const out = [{ text: "Home", link: base }];
+  const out = [{ text: "Home", link: "/" }];
   const topPaths = Object.keys(allSidebars).filter(
     (p) => p !== base && !p.endsWith("/_perspectives_/")
   );
   for (const p of topPaths) {
     const seg = p.replace(/^\/|\/$/g, "").split("/").filter(Boolean).pop() ?? p;
     const text = seg.charAt(0).toUpperCase() + seg.slice(1);
-    out.push({ text, link: p });
+    const b = base.endsWith("/") ? base : base + "/";
+    const stripped = b !== "/" && p.startsWith(b) ? "/" + p.slice(b.length) : p;
+    out.push({ text, link: stripped });
   }
   out.push(group);
   return out;
 }
 function buildViewsGroup(options) {
   const { enabled, names, sidebarText, urlPrefix } = options.views;
-  const base = options.base.endsWith("/") ? options.base.slice(0, -1) : options.base;
   const prefixSeg = urlPrefix ? `/${urlPrefix}` : "";
   const items = [];
   if (enabled.graph) {
-    items.push({
-      text: sidebarText.graph,
-      link: `${base}${prefixSeg}/${names.graph}`
-    });
+    items.push({ text: sidebarText.graph, link: `${prefixSeg}/${names.graph}` });
   }
   if (enabled.stats) {
-    items.push({
-      text: sidebarText.stats,
-      link: `${base}${prefixSeg}/${names.stats}`
-    });
+    items.push({ text: sidebarText.stats, link: `${prefixSeg}/${names.stats}` });
   }
   if (enabled.tags) {
-    items.push({
-      text: sidebarText.tags,
-      link: `${base}${prefixSeg}/${names.tags}`
-    });
+    items.push({ text: sidebarText.tags, link: `${prefixSeg}/${names.tags}` });
   }
   if (items.length === 0) return null;
   return {
@@ -2698,13 +2694,34 @@ function generateSidebar(index, options, autoOptions = {}) {
   }
   const root = buildTree2(visible);
   const layout = autoOptions.layout ?? "tree";
+  let result;
   if (layout === "per-folder") {
-    return toPerFolderSidebar(root, opts, options, index);
+    result = toPerFolderSidebar(root, opts, options, index);
+  } else if (layout === "flat") {
+    result = toFlatSidebar(root, opts);
+  } else {
+    result = toTreeSidebar(root, opts, index, options);
   }
-  if (layout === "flat") {
-    return toFlatSidebar(root, opts);
+  stripBaseFromConfig(result, options.base);
+  return result;
+}
+function stripBaseFromConfig(cfg, base) {
+  if (Array.isArray(cfg)) {
+    stripBaseFromItems(cfg, base);
+  } else {
+    for (const k of Object.keys(cfg)) {
+      stripBaseFromItems(cfg[k], base);
+    }
+  }
+}
+function stripBaseFromItems(items, base) {
+  const b = base.endsWith("/") ? base : base + "/";
+  for (const it of items) {
+    if (it.link && b !== "/" && it.link.startsWith(b)) {
+      it.link = "/" + it.link.slice(b.length);
+    }
+    if (it.items) stripBaseFromItems(it.items, base);
   }
-  return toTreeSidebar(root, opts, index, options);
 }
 function buildTree2(files) {
   const root = newNode("");
@@ -2905,7 +2922,6 @@ function walkDirs(node, out) {
 }
 function toPerFolderSidebar(root, opts, options, index) {
   const out = {};
-  const base = options.base.endsWith("/") ? options.base : options.base + "/";
   const rootItems = [];
   const sortedRootFiles = [...root.files].sort((a, b) => compareEntries(a, b, opts));
   for (const f of sortedRootFiles) {
@@ -2923,13 +2939,13 @@ function toPerFolderSidebar(root, opts, options, index) {
       /* isTopLevel */
       true
     )) {
-      const firstUrl = child.dirIndex && !child.dirIndexEmpty ? child.dirIndex.url : findFirstPageUrl(child, opts) ?? `${base}${key}/`;
+      const firstUrl = child.dirIndex && !child.dirIndexEmpty ? child.dirIndex.url : findFirstPageUrl(child, opts) ?? `/${key}/`;
       rootItems.push({ text: labelText, link: firstUrl });
     } else {
       rootItems.push({ text: labelText });
     }
   }
-  if (rootItems.length > 0) out[base] = rootItems;
+  if (rootItems.length > 0) out["/"] = rootItems;
   for (const key of topKeys) {
     const child = root.children.get(key);
     const items = renderNode(
@@ -2956,7 +2972,7 @@ function toPerFolderSidebar(root, opts, options, index) {
       });
     }
     sidebar.push(...items);
-    out[`${base}${key}/`] = sidebar;
+    out[`/${key}/`] = sidebar;
   }
   return out;
 }
@@ -2970,7 +2986,7 @@ function generateNav(index, options, autoOptions = {}) {
   }
   const root = buildTree2(visible);
   const base = options.base.endsWith("/") ? options.base : options.base + "/";
-  const out = [{ text: opts.homeNavText, link: base }];
+  const out = [{ text: opts.homeNavText, link: "/" }];
   const topKeys = [...root.children.keys()].sort();
   for (const key of topKeys) {
     const child = root.children.get(key);
@@ -2978,16 +2994,22 @@ function generateNav(index, options, autoOptions = {}) {
       continue;
     }
     const text = computeGroupText(child.path, child.dirIndex, opts);
-    const link = child.dirIndex?.url ?? `${base}${key}/`;
-    const escapedPrefix = `${base}${key}/`.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-    out.push({
-      text,
-      link,
-      activeMatch: "^" + escapedPrefix
-    });
+    let link;
+    if (child.dirIndex) {
+      link = stripBase(child.dirIndex.url, base);
+    } else {
+      link = `/${key}/`;
+    }
+    const escapedPrefix = `/${key}/`.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    out.push({ text, link, activeMatch: "^" + escapedPrefix });
   }
   return out;
 }
+function stripBase(url, base) {
+  const b = base.endsWith("/") ? base : base + "/";
+  if (b === "/" || !url.startsWith(b)) return url;
+  return "/" + url.slice(b.length);
+}
 function compareEntries(a, b, opts) {
   if (opts.sortBy === "title") {
     return opts.formatItemTitle(a).localeCompare(opts.formatItemTitle(b));