vitepress-allyouneed 0.3.0-beta.0 → 0.3.0-beta.2

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-beta.2] - 2026-05-20
+### Fixed
+- **build-mode base 双重 prefix bug**:`
+
+## [0.3.0-beta.1] - 2026-05-20
+
+### Fixed
+- **i18n nav 注入丢失**
+- **跨 locale nav 链接 404**
+
+### Added
+- 11 篇 EN 翻译 — `en/guide/{overview, docs×6, advanced×4}`
+- VitePress 原生 i18n 集成:wrapper 自动识别 `themeConfig.locales`,给每个 non-root locale 自动用 `includePrefix` 生成对应 sidebar;root locale 自动用 `excludePrefixes` 排除其它 locale 子树。
+- `sidebarAuto.includePrefix` / `excludePrefixes` 公开选项 — 手动控制 i18n sidebar 范围。
+
 ## [0.3.0-beta.0] - Unreleased
 
 v0.3 把"接管 Obsidian 仓库"从能跑变成好用。补齐了 13 种 callouts、Pandoc footnotes、`==高亮==`、`%%注释%%`、`^block-ref`、`![[audio|video|pdf]]` 媒体嵌入;sidebar 不再需要手写(三种 layout + nav 自动生成 + `_sidebar.md` 手动覆盖);文档顶部加了 banner-style `DocHeader`(cover/dates/tags/word-count);Perspectives 视图组挪到 nav 下拉,不再污染各 tab sidebar;补全 11 篇用户文档 + 完整 frontmatter 字段表。

package/dist/index.cjs

@@ -2426,12 +2426,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 +2442,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 {
@@ -2665,7 +2660,9 @@ function resolveSidebarAutoOptions(user = {}) {
     stripNumericPrefix: strip,
     groupOrder: user.groupOrder ?? [],
     maxDepth: user.maxDepth,
-    groupLink: user.groupLink ?? "all"
+    groupLink: user.groupLink ?? "all",
+    includePrefix: user.includePrefix,
+    excludePrefixes: user.excludePrefixes ?? []
   };
 }
 function defaultItemTitle(entry, strip) {
@@ -2696,13 +2693,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);
+  }
+  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);
+    }
   }
-  if (layout === "flat") {
-    return toFlatSidebar(root, opts);
+}
+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("");
@@ -2903,7 +2921,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) {
@@ -2921,13 +2938,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(
@@ -2954,7 +2971,7 @@ function toPerFolderSidebar(root, opts, options, index) {
       });
     }
     sidebar.push(...items);
-    out[`${base}${key}/`] = sidebar;
+    out[`/${key}/`] = sidebar;
   }
   return out;
 }
@@ -2968,7 +2985,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);
@@ -2976,16 +2993,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));
@@ -3018,6 +3041,18 @@ function resolveGroupCollapsed(dirIndex, opts) {
 function shouldExclude(entry, opts, viewsPrefix) {
   if (entry.frontmatter[opts.hiddenKey] === true) return true;
   if (viewsPrefix && entry.relativePath.startsWith(viewsPrefix + "/")) return true;
+  if (opts.includePrefix) {
+    const ip = opts.includePrefix.replace(/^\/+|\/+$/g, "");
+    if (!entry.relativePath.startsWith(ip + "/") && entry.relativePath !== ip) {
+      return true;
+    }
+  }
+  for (const ex of opts.excludePrefixes) {
+    const xp = ex.replace(/^\/+|\/+$/g, "");
+    if (entry.relativePath.startsWith(xp + "/") || entry.relativePath === xp) {
+      return true;
+    }
+  }
   const segs = entry.relativePath.split("/");
   for (const seg of segs.slice(0, -1)) {
     if (seg.startsWith("_")) return true;
@@ -3400,11 +3435,29 @@ function defineConfigWithAllYouNeed(config, pluginOptions = {}) {
           logDeadLinks(report, resolvedForWrapper.deadLink);
         } catch {
         }
-        themeConfig.sidebar = generateSidebar(
-          index,
-          resolvedForWrapper,
-          sidebarAuto
-        );
+        const localesObj = config.locales;
+        const localeKeys = localesObj ? Object.keys(localesObj).filter((k) => k !== "root") : [];
+        themeConfig.sidebar = generateSidebar(index, resolvedForWrapper, {
+          ...sidebarAuto,
+          excludePrefixes: [
+            ...sidebarAuto.excludePrefixes ?? [],
+            ...localeKeys
+            // 根 sidebar 排除掉所有 locale 子树
+          ]
+        });
+        if (localesObj) {
+          for (const lang of localeKeys) {
+            const localeCfg = localesObj[lang];
+            if (!localeCfg.themeConfig) localeCfg.themeConfig = {};
+            if (localeCfg.themeConfig.sidebar === void 0) {
+              localeCfg.themeConfig.sidebar = generateSidebar(
+                index,
+                resolvedForWrapper,
+                { ...sidebarAuto, includePrefix: lang }
+              );
+            }
+          }
+        }
         if (sidebarAuto.autoNav && themeConfig.nav === void 0) {
           themeConfig.nav = generateNav(
             index,
@@ -3429,6 +3482,19 @@ function defineConfigWithAllYouNeed(config, pluginOptions = {}) {
       themeConfig.nav,
       resolvedForWrapper
     );
+    const localesForNav = config.locales;
+    if (localesForNav) {
+      for (const lang of Object.keys(localesForNav)) {
+        const lc = localesForNav[lang];
+        if (!lc.themeConfig) continue;
+        if (lc.themeConfig.nav !== void 0) {
+          lc.themeConfig.nav = injectViewsNav(
+            lc.themeConfig.nav,
+            resolvedForWrapper
+          );
+        }
+      }
+    }
   }
   return {
     ...config,