From 9538068d0b5e41ee36c36a35488bb47e89402593 Mon Sep 17 00:00:00 2001
From: Garfield Lee <Garfield550@users.noreply.github.com>
Date: Tue, 24 Mar 2026 10:15:57 +0800
Subject: [PATCH] fix(docs): Try Live leads to 404 in VitePress SPA router
 (#1461)

- Add `target?: string` field to `ButtonItem` interface
- Set `target: '_self'` on all locales' Try Live button configs (EN, ZH, JA)
- Bind `:target="item.target"` on the `<a>` element in HomeButton.vue

VitePress intercepts clicks on anchor tags without an explicit `target`
attribute and routes them through Vue Router, which causes a 404 for the
external https://airi.moeru.ai/ link. Setting `target="_self"` makes
the browser skip the router and perform a native navigation.

Co-authored-by-agent: GitHub Copilot <copilot@github.com>
---
 docs/.vitepress/components/HomeButton.vue | 1 +
 docs/.vitepress/config.ts                 | 4 +++-
 docs/.vitepress/theme/config.ts           | 1 +
 3 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/docs/.vitepress/components/HomeButton.vue b/docs/.vitepress/components/HomeButton.vue
index 64c5b337b..1f9f0b360 100644
--- a/docs/.vitepress/components/HomeButton.vue
+++ b/docs/.vitepress/components/HomeButton.vue
@@ -8,6 +8,7 @@ defineProps<{
 
 <template>
   <a
+    :target="item.target"
     :href="item.link"
     :class="[
       'rounded-xl px-3 py-2 lg:px-5 lg:py-3 font-extrabold outline-none backdrop-blur-md active:scale-95 focus:outline-none text-nowrap text-sm md:text-base',
diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts
index fd62aad8f..fdf1ee1ce 100644
--- a/docs/.vitepress/config.ts
+++ b/docs/.vitepress/config.ts
@@ -213,6 +213,7 @@ export default defineConfig<ThemeConfig>({
               text: 'Try Live',
               link: webLive,
               primary: true,
+              target: '_self',
             },
             {
               text: 'Download',
@@ -353,6 +354,7 @@ export default defineConfig<ThemeConfig>({
               text: '网页版',
               link: webLive,
               primary: true,
+              target: '_self',
             },
             {
               text: '下载',
@@ -493,6 +495,7 @@ export default defineConfig<ThemeConfig>({
               text: 'ライブ版を試す',
               link: webLive,
               primary: true,
+              target: '_self',
             },
             {
               text: 'ダウンロード',
@@ -513,7 +516,6 @@ export default defineConfig<ThemeConfig>({
       { icon: 'discord', link: discord },
       { icon: 'github', link: github },
     ],
-
     search: {
       provider: 'local',
     },
diff --git a/docs/.vitepress/theme/config.ts b/docs/.vitepress/theme/config.ts
index c54c1dfbd..a5d0c8d3e 100644
--- a/docs/.vitepress/theme/config.ts
+++ b/docs/.vitepress/theme/config.ts
@@ -12,6 +12,7 @@ export interface ButtonItem {
   text?: string
   link?: string
   primary?: boolean
+  target?: string
 }
 
 export type ThemeConfig = DefaultTheme.Config & ExtraThemeConfig