feat: add i18n support with language switcher (zh/en) for all pages

Author: zhushanwen321

package-lock.json

@@ -10,14 +10,15 @@
   },
   "dependencies": {
     "vue": "^3.5.13",
+    "vue-i18n": "^9.14.4",
     "vue-router": "^4.5.0"
   },
   "devDependencies": {
+    "@tailwindcss/typography": "^0.5.16",
     "@vitejs/plugin-vue": "^5.2.3",
     "autoprefixer": "^10.4.21",
     "postcss": "^8.5.3",
     "tailwindcss": "^3.4.17",
-    "@tailwindcss/typography": "^0.5.16",
     "typescript": "~5.7.3",
     "vite": "^6.3.2",
     "vue-tsc": "^2.2.8"

package.json

@@ -1,9 +1,11 @@
 <script setup lang="ts">
 import { computed } from 'vue'
 import { useRoute } from 'vue-router'
+import { useI18n } from 'vue-i18n'
 import { getPrevNext, llmSimpleRouterSidebar } from '../config/sidebar'
 
 const route = useRoute()
+const { t } = useI18n()
 const navigation = computed(() => getPrevNext(llmSimpleRouterSidebar, route.path))
 </script>
 
@@ -14,9 +16,9 @@ const navigation = computed(() => getPrevNext(llmSimpleRouterSidebar, route.path
       :to="navigation.prev.path"
       class="group flex flex-col items-start rounded-lg border border-white/10 px-4 py-3 transition-colors hover:border-white/20 hover:bg-white/5"
     >
-      <span class="text-xs text-gray-500">上一页</span>
+      <span class="text-xs text-gray-500">{{ t('footer.prev') }}</span>
       <span class="text-sm text-gray-300 group-hover:text-white transition-colors">
-        {{ navigation.prev.title }}
+        {{ t(navigation.prev.titleKey) }}
       </span>
     </router-link>
     <div v-else />
@@ -26,9 +28,9 @@ const navigation = computed(() => getPrevNext(llmSimpleRouterSidebar, route.path
       :to="navigation.next.path"
       class="group flex flex-col items-end rounded-lg border border-white/10 px-4 py-3 transition-colors hover:border-white/20 hover:bg-white/5"
     >
-      <span class="text-xs text-gray-500">下一页</span>
+      <span class="text-xs text-gray-500">{{ t('footer.next') }}</span>
       <span class="text-sm text-gray-300 group-hover:text-white transition-colors">
-        {{ navigation.next.title }}
+        {{ t(navigation.next.titleKey) }}
       </span>
     </router-link>
     <div v-else />

src/components/DocFooter.vue

@@ -1,27 +1,26 @@
 <script setup lang="ts">
-import { ref } from 'vue'
+import { ref, watch } from 'vue'
 import { useRoute } from 'vue-router'
+import { useI18n } from 'vue-i18n'
 
 const route = useRoute()
+const { t, locale } = useI18n()
 const mobileOpen = ref(false)
 const projectDropdownOpen = ref(false)
 
 const projects = [
   { name: 'LLM Simple Router', path: '/project/llm-simple-router/' },
 ]
 
-function toggleMobile() {
-  mobileOpen.value = !mobileOpen.value
-}
+watch(locale, (val) => { localStorage.setItem('locale', val) })
 
-function isActive(path: string): boolean {
-  return route.path.startsWith(path)
-}
+function toggleMobile() { mobileOpen.value = !mobileOpen.value }
+function isActive(path: string): boolean { return route.path.startsWith(path) }
+function toggleLocale() { locale.value = locale.value === 'zh' ? 'en' : 'zh' }
 </script>
 
 <template>
   <nav class="fixed top-0 left-0 right-0 z-50 flex h-14 items-center border-b border-white/10 bg-surface/80 backdrop-blur-md">
-    <!-- 左侧 Logo 区域：w-64 与 SideBar 对齐 -->
     <router-link to="/" class="flex h-14 w-64 shrink-0 items-center px-6 group">
       <svg width="134" height="30" viewBox="0 0 134 30" fill="none" class="transition-opacity group-hover:opacity-80">
         <text x="0"  y="24" font-family="monospace" font-size="20" font-weight="bold" fill="#60a5fa">Z</text>
@@ -38,11 +37,10 @@ function isActive(path: string): boolean {
       </svg>
     </router-link>
 
-    <!-- 右侧：导航菜单 + 图标（从 SideBar 分割线位置开始） -->
     <div class="hidden flex-1 items-center justify-between pr-6 md:flex">
       <div class="flex items-center gap-1">
         <router-link to="/about" class="rounded-md px-3 py-1.5 text-sm text-gray-400 hover:bg-white/5 hover:text-gray-200 transition-colors">
-          个人介绍
+          {{ t('nav.about') }}
         </router-link>
 
         <div class="relative" @mouseleave="projectDropdownOpen = false">
@@ -51,33 +49,31 @@ function isActive(path: string): boolean {
             :class="isActive('/project') ? 'text-gray-200 bg-white/5' : 'text-gray-400 hover:bg-white/5 hover:text-gray-200'"
             @mouseenter="projectDropdownOpen = true"
           >
-            项目介绍
-            <svg class="h-3.5 w-3.5" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2">
-              <path stroke-linecap="round" stroke-linejoin="round" d="M19 9l-7 7-7-7" />
-            </svg>
+            {{ t('nav.projects') }}
+            <svg class="h-3.5 w-3.5" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path stroke-linecap="round" stroke-linejoin="round" d="M19 9l-7 7-7-7" /></svg>
           </button>
           <div v-show="projectDropdownOpen" class="absolute left-0 top-[calc(100%-4px)] z-10" @mouseenter="projectDropdownOpen = true">
             <div class="h-1 w-full" />
             <div class="w-56 rounded-lg border border-white/10 bg-surface-50 py-1 shadow-xl">
-              <router-link
-                v-for="project in projects"
-                :key="project.path"
-                :to="project.path"
-                class="block px-4 py-2 text-sm text-gray-300 hover:bg-white/5 hover:text-white transition-colors"
-                @click="projectDropdownOpen = false"
-              >
-                {{ project.name }}
-              </router-link>
+              <router-link v-for="p in projects" :key="p.path" :to="p.path" class="block px-4 py-2 text-sm text-gray-300 hover:bg-white/5 hover:text-white transition-colors" @click="projectDropdownOpen = false">{{ p.name }}</router-link>
             </div>
           </div>
         </div>
 
         <router-link to="/social" class="rounded-md px-3 py-1.5 text-sm text-gray-400 hover:bg-white/5 hover:text-gray-200 transition-colors">
-          社交平台
+          {{ t('nav.social') }}
         </router-link>
       </div>
 
-      <div class="flex items-center gap-3">
+      <div class="flex items-center gap-2">
+        <!-- Language switcher -->
+        <button @click="toggleLocale" class="flex items-center gap-1 rounded-md px-2 py-1 text-xs font-medium text-gray-400 hover:text-gray-200 hover:bg-white/5 transition-colors" title="Switch Language">
+          <svg class="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2">
+            <path stroke-linecap="round" stroke-linejoin="round" d="M3 5h12M9 3v2m1.048 9.5A18.022 18.022 0 016.412 9m6.088 9h7M11 21l5-10 5 10M12.751 5C11.783 10.77 8.07 15.61 3 18.129" />
+          </svg>
+          <span>{{ locale === 'zh' ? 'EN' : '中文' }}</span>
+        </button>
+
         <a href="https://github.com/zhushanwen321" target="_blank" rel="noopener" class="text-gray-500 hover:text-gray-300 transition-colors" aria-label="GitHub">
           <svg class="h-5 w-5" fill="currentColor" viewBox="0 0 24 24"><path d="M12 0c-6.626 0-12 5.373-12 12 0 5.302 3.438 9.8 8.207 11.387.599.111.793-.261.793-.577v-2.234c-3.338.726-4.033-1.416-4.033-1.416-.546-1.387-1.333-1.756-1.333-1.756-1.089-.745.083-.729.083-.729 1.205.084 1.839 1.237 1.839 1.237 1.07 1.834 2.807 1.304 3.492.997.107-.775.418-1.305.762-1.604-2.665-.305-5.467-1.334-5.467-5.931 0-1.311.469-2.381 1.236-3.221-.124-.303-.535-1.524.117-3.176 0 0 1.008-.322 3.301 1.23.957-.266 1.983-.399 3.003-.404 1.02.005 2.047.138 3.006.404 2.291-1.552 3.297-1.23 3.297-1.23.653 1.653.242 2.874.118 3.176.77.84 1.235 1.911 1.235 3.221 0 4.609-2.807 5.624-5.479 5.921.43.372.823 1.102.823 2.222v3.293c0 .319.192.694.801.576 4.765-1.589 8.199-6.086 8.199-11.386 0-6.627-5.373-12-12-12z"/></svg>
         </a>
@@ -88,22 +84,25 @@ function isActive(path: string): boolean {
     </div>
 
     <!-- Mobile hamburger -->
-    <div class="flex flex-1 items-center justify-end pr-6 md:hidden">
+    <div class="flex flex-1 items-center justify-end gap-2 pr-4 md:hidden">
+      <button @click="toggleLocale" class="text-xs text-gray-400 hover:text-gray-200 px-1.5 py-1">
+        {{ locale === 'zh' ? 'EN' : '中文' }}
+      </button>
       <button class="text-gray-400 hover:text-gray-200 transition-colors" @click="toggleMobile" aria-label="Toggle menu">
         <svg v-if="!mobileOpen" class="h-6 w-6" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path stroke-linecap="round" stroke-linejoin="round" d="M4 6h16M4 12h16M4 18h16" /></svg>
         <svg v-else class="h-6 w-6" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path stroke-linecap="round" stroke-linejoin="round" d="M6 18L18 6M6 6l12 12" /></svg>
       </button>
     </div>
 
     <!-- Mobile menu -->
-    <div v-show="mobileOpen" class="absolute left-0 right-0 top-14 border-t border-white/10 md:hidden">
+    <div v-show="mobileOpen" class="absolute left-0 right-0 top-14 border-t border-white/10 md:hidden bg-surface">
       <div class="space-y-1 px-4 py-3">
-        <router-link to="/about" class="block rounded-md px-3 py-2 text-sm text-gray-300 hover:bg-white/5" @click="mobileOpen = false">个人介绍</router-link>
+        <router-link to="/about" class="block rounded-md px-3 py-2 text-sm text-gray-300 hover:bg-white/5" @click="mobileOpen = false">{{ t('nav.about') }}</router-link>
         <div class="pl-3">
-          <p class="px-3 py-1 text-xs font-semibold uppercase tracking-wider text-gray-500">项目介绍</p>
-          <router-link v-for="project in projects" :key="project.path" :to="project.path" class="block rounded-md px-3 py-2 text-sm text-gray-300 hover:bg-white/5" @click="mobileOpen = false">{{ project.name }}</router-link>
+          <p class="px-3 py-1 text-xs font-semibold uppercase tracking-wider text-gray-500">{{ t('nav.projects') }}</p>
+          <router-link v-for="p in projects" :key="p.path" :to="p.path" class="block rounded-md px-3 py-2 text-sm text-gray-300 hover:bg-white/5" @click="mobileOpen = false">{{ p.name }}</router-link>
         </div>
-        <router-link to="/social" class="block rounded-md px-3 py-2 text-sm text-gray-300 hover:bg-white/5" @click="mobileOpen = false">社交平台</router-link>
+        <router-link to="/social" class="block rounded-md px-3 py-2 text-sm text-gray-300 hover:bg-white/5" @click="mobileOpen = false">{{ t('nav.social') }}</router-link>
       </div>
     </div>
   </nav>

src/components/NavBar.vue

@@ -1,27 +1,28 @@
 <script setup lang="ts">
 import { ref, watch } from 'vue'
 import { useRoute } from 'vue-router'
+import { useI18n } from 'vue-i18n'
 import { llmSimpleRouterSidebar } from '../config/sidebar'
 
 const route = useRoute()
+const { t } = useI18n()
 const sidebar = llmSimpleRouterSidebar
 const expandedGroups = ref<Record<string, boolean>>({})
 
-// 自动展开包含当前路由的分组
 watch(
   () => route.path,
-  (_path) => {
+  () => {
     for (const group of sidebar) {
       if (group.items.some((item) => isActive(item.path))) {
-        expandedGroups.value[group.title] = true
+        expandedGroups.value[group.titleKey] = true
       }
     }
   },
   { immediate: true },
 )
 
-function toggleGroup(title: string) {
-  expandedGroups.value[title] = !expandedGroups.value[title]
+function toggleGroup(titleKey: string) {
+  expandedGroups.value[titleKey] = !expandedGroups.value[titleKey]
 }
 
 function isActive(path: string): boolean {
@@ -35,25 +36,21 @@ function isActive(path: string): boolean {
 <template>
   <aside class="fixed left-0 top-14 z-40 h-[calc(100vh-3.5rem)] w-64 border-r border-white/10 bg-surface-50 overflow-y-auto">
     <nav class="p-4">
-      <div
-        v-for="group in sidebar"
-        :key="group.title"
-        class="mb-3"
-      >
+      <div v-for="group in sidebar" :key="group.titleKey" class="mb-3">
         <button
           class="flex w-full items-center justify-between rounded-md px-2 py-1.5 text-xs font-semibold uppercase tracking-wider text-gray-500 hover:text-gray-300 transition-colors"
-          @click="toggleGroup(group.title)"
+          @click="toggleGroup(group.titleKey)"
         >
-          {{ group.title }}
+          {{ t(group.titleKey) }}
           <svg
             class="h-3.5 w-3.5 transition-transform"
-            :class="{ 'rotate-90': !expandedGroups[group.title] }"
+            :class="{ 'rotate-90': !expandedGroups[group.titleKey] }"
             fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"
           >
             <path stroke-linecap="round" stroke-linejoin="round" d="M9 5l7 7-7 7" />
           </svg>
         </button>
-        <div v-show="expandedGroups[group.title] !== false">
+        <div v-show="expandedGroups[group.titleKey] !== false">
           <router-link
             v-for="item in group.items"
             :key="item.path"
@@ -67,7 +64,7 @@ function isActive(path: string): boolean {
               class="absolute left-0 top-1/2 -translate-y-1/2 w-0.5 h-4 rounded-r transition-colors"
               :class="isActive(item.path) ? 'bg-accent' : 'bg-transparent'"
             />
-            {{ item.title }}
+            {{ t(item.titleKey) }}
           </router-link>
         </div>
       </div>

src/components/SideBar.vue

@@ -0,0 +1,50 @@
+import { useI18n } from 'vue-i18n'
+import { computed } from 'vue'
+
+/** 可用的语言列表 */
+export const availableLocales = [
+  { code: 'zh', label: '中文' },
+  { code: 'en', label: 'English' },
+] as const
+
+export type LocaleCode = (typeof availableLocales)[number]['code']
+
+/** 获取当前语言 */
+export function useLocale() {
+  const { locale, t } = useI18n()
+  const current = computed(() => availableLocales.find((l) => l.code === locale.value)!)
+  const other = computed(() => availableLocales.find((l) => l.code !== locale.value)!)
+
+  function switchLocale() {
+    locale.value = other.value.code
+  }
+
+  return { locale, current, other, switchLocale, t }
+}
+
+/** SideBar keys 常量 */
+export const SIDEBAR_KEYS = {
+  quickStart: 'sidebar.quickStart',
+  overview: 'sidebar.overview',
+  startRouter: 'sidebar.startRouter',
+  features: 'sidebar.features',
+  autoRetry: 'sidebar.autoRetry',
+  providers: 'sidebar.providers',
+  modelMapping: 'sidebar.modelMapping',
+  concurrency: 'sidebar.concurrency',
+  failover: 'sidebar.failover',
+  monitor: 'sidebar.monitor',
+  multiKey: 'sidebar.multiKey',
+  config: 'sidebar.config',
+  claudeCode: 'sidebar.claudeCode',
+  env: 'sidebar.env',
+  docker: 'sidebar.docker',
+  architecture: 'sidebar.architecture',
+  systemContext: 'sidebar.systemContext',
+  requestPipeline: 'sidebar.requestPipeline',
+  logging: 'sidebar.logging',
+  pipeline: 'sidebar.pipeline',
+  metrics: 'sidebar.metrics',
+  ttftTps: 'sidebar.ttftTps',
+  tokens: 'sidebar.tokens',
+} as const