vitepress-allyouneed 0.3.0-beta.2 → 0.3.1

package/CHANGELOG.md

@@ -2,9 +2,25 @@
 
 本项目遵循 [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
+## [0.3.1] - 2026-05-20
+
 ### Fixed
-- **build-mode base 双重 prefix bug**:`
+- **空目录假 URL 导致 MIME 404**
+
+## [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
 

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",
     "---",
@@ -2938,8 +2939,12 @@ function toPerFolderSidebar(root, opts, options, index) {
       /* isTopLevel */
       true
     )) {
-      const firstUrl = child.dirIndex && !child.dirIndexEmpty ? child.dirIndex.url : findFirstPageUrl(child, opts) ?? `/${key}/`;
-      rootItems.push({ text: labelText, link: firstUrl });
+      const firstUrl = child.dirIndex && !child.dirIndexEmpty ? child.dirIndex.url : findFirstPageUrl(child, opts);
+      if (firstUrl) {
+        rootItems.push({ text: labelText, link: firstUrl });
+      } else {
+        rootItems.push({ text: labelText });
+      }
     } else {
       rootItems.push({ text: labelText });
     }
@@ -2994,10 +2999,12 @@ function generateNav(index, options, autoOptions = {}) {
     }
     const text = computeGroupText(child.path, child.dirIndex, opts);
     let link;
-    if (child.dirIndex) {
+    if (child.dirIndex && !child.dirIndexEmpty) {
       link = stripBase(child.dirIndex.url, base);
     } else {
-      link = `/${key}/`;
+      const first = findFirstPageUrl(child, opts);
+      if (!first) continue;
+      link = first;
     }
     const escapedPrefix = `/${key}/`.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
     out.push({ text, link, activeMatch: "^" + escapedPrefix });