feat(navigation): localize nav labels and header routes for all locales

Replace the labelEn field with a translations record covering all ten
docs locales. Update StarlightHeader to resolve locale via parseDocsLocale
and build home/blog links with buildDocsRoutePath. Add a test asserting
every locale receives localized nav links.

Co-Authored-By: Hagicode <noreply@hagicode.com>
Signed-off-by: newbe36524 <newbe36524@qq.com>

Author: newbe36524

src/components/StarlightHeader.astro

@@ -14,19 +14,19 @@ import { getLocalizedNavLinks } from '@/config/navigation';
 import InstallButton from './InstallButton';
 import DocsContentLayoutToggle from './DocsContentLayoutToggle.astro';
 import type { SidebarEntry } from '@astrojs/starlight/sidebar';
-import { resolveDocsLocale, toInstallButtonLocale } from '@/lib/i18n';
+import { buildDocsRoutePath, resolveDocsLocale, parseDocsLocale, toInstallButtonLocale } from '@/lib/i18n';
 
 /**
  * 获取当前语言区域
  */
-const localeFromPath = Astro.url.pathname.startsWith('/en/') ? 'en' : 'root';
+const localeFromPath = parseDocsLocale(Astro.url.pathname.split('/').filter(Boolean)[0] ?? null);
 const docsLocale = resolveDocsLocale(
 	Astro.currentLocale,
 	Astro.locals?.starlightRoute?.locale,
 	localeFromPath
 );
 const installButtonLocale = toInstallButtonLocale(docsLocale);
-const homeHref = docsLocale === 'en' ? '/en/' : '/';
+const homeHref = buildDocsRoutePath(docsLocale, '/');
 const localizedNavLinks = getLocalizedNavLinks(docsLocale);
 
 /**

src/components/StarlightHeader.navigation.test.tsx

@@ -1,6 +1,7 @@
 import { describe, expect, it } from 'vitest';
 import { getLink } from '@shared/links';
 import { getLocalizedNavLinks } from '@/config/navigation';
+import { DOCS_LOCALE_METADATA, buildDocsRoutePath } from '@/lib/i18n';
 
 describe('docs navigation support entry', () => {
   it('localizes the unified support label while keeping the canonical about link', () => {
@@ -45,4 +46,18 @@ describe('docs navigation support entry', () => {
       displayLabel: 'Builder',
     });
   });
+
+  it('provides localized header labels for every supported docs locale', () => {
+    const locales = DOCS_LOCALE_METADATA.map((locale) => locale.code);
+
+    for (const locale of locales) {
+      const localizedLinks = getLocalizedNavLinks(locale);
+
+      expect(localizedLinks).toHaveLength(4);
+      expect(localizedLinks.every((link) => link.displayLabel.trim().length > 0)).toBe(true);
+      expect(localizedLinks.find((link) => link.linkKey === 'blog')?.href).toBe(
+        buildDocsRoutePath(locale, '/blog/'),
+      );
+    }
+  });
 });

src/config/navigation.ts

@@ -5,7 +5,7 @@
  * 支持中英文双语显示
  */
 import { getLink, getLinkTarget, getLinkRel, type PublicLinkKey } from '@shared/links';
-import { resolveDocsLocale, type DocsLocale } from '@/lib/i18n';
+import { buildDocsRoutePath, resolveDocsLocale, type DocsLocale } from '@/lib/i18n';
 
 /**
  * 导航链接接口
@@ -15,8 +15,8 @@ export interface NavLink {
   /** 链接显示文本 */
   label: string;
 
-  /** 英文版显示文本 */
-  labelEn?: string;
+  /** 非默认语言显示文本 */
+  translations?: Partial<Record<Exclude<DocsLocale, 'root'>, string>>;
 
   /** 链接地址 (支持相对路径和绝对 URL) */
   href: string;
@@ -44,24 +44,64 @@ export interface LocalizedNavLink extends NavLink {
 export const navLinks: NavLink[] = [
   {
     label: "首页",
-    labelEn: "Home",
+    translations: {
+      en: 'Home',
+      'zh-Hant': '首頁',
+      'ja-JP': 'ホーム',
+      'ko-KR': '홈',
+      'de-DE': 'Startseite',
+      'fr-FR': 'Accueil',
+      'es-ES': 'Inicio',
+      'pt-BR': 'Início',
+      'ru-RU': 'Главная',
+    },
     href: getLink('website'),
     linkKey: 'website',
   },
   {
     label: "部署生成器",
-    labelEn: "Builder",
+    translations: {
+      en: 'Builder',
+      'zh-Hant': '部署產生器',
+      'ja-JP': 'デプロイビルダー',
+      'ko-KR': '배포 빌더',
+      'de-DE': 'Deployment-Builder',
+      'fr-FR': 'Générateur de déploiement',
+      'es-ES': 'Generador de despliegue',
+      'pt-BR': 'Gerador de implantação',
+      'ru-RU': 'Генератор развертывания',
+    },
     href: 'https://builder.hagicode.com/',
   },
   {
     label: "博客",
-    labelEn: "Blog",
+    translations: {
+      en: 'Blog',
+      'zh-Hant': '部落格',
+      'ja-JP': 'ブログ',
+      'ko-KR': '블로그',
+      'de-DE': 'Blog',
+      'fr-FR': 'Blog',
+      'es-ES': 'Blog',
+      'pt-BR': 'Blog',
+      'ru-RU': 'Блог',
+    },
     href: getLink('blog'),
     linkKey: 'blog',
   },
   {
     label: "获取技术支持",
-    labelEn: "Get Support",
+    translations: {
+      en: 'Get Support',
+      'zh-Hant': '獲取技術支援',
+      'ja-JP': 'サポート',
+      'ko-KR': '기술 지원',
+      'de-DE': 'Support',
+      'fr-FR': 'Assistance',
+      'es-ES': 'Soporte',
+      'pt-BR': 'Suporte',
+      'ru-RU': 'Поддержка',
+    },
     href: getLink('about'),
     icon: "comment",
     linkKey: 'about',
@@ -72,16 +112,16 @@ export const navLinks: NavLink[] = [
  * 按 locale 解析导航显示文案，缺失时回退到中文标签。
  */
 export function getNavLinkLabel(link: NavLink, locale: DocsLocale): string {
-  if (locale === 'en' && link.labelEn) {
-    return link.labelEn;
+  if (locale !== 'root' && link.translations?.[locale]) {
+    return link.translations[locale];
   }
 
   if (link.label) {
     return link.label;
   }
 
-  if (link.labelEn) {
-    return link.labelEn;
+  if (link.translations?.en) {
+    return link.translations.en;
   }
 
   // Keep navigation labels non-empty even when upstream config is incomplete.
@@ -97,7 +137,7 @@ export function getLocalizedNavLinks(localeInput?: string | null): LocalizedNavL
     ...link,
     href:
       link.linkKey === 'blog'
-        ? (locale === 'en' ? '/en/blog/' : '/blog/')
+        ? buildDocsRoutePath(locale, '/blog/')
         : link.href,
     displayLabel: getNavLinkLabel(link, locale),
   }));