From 8baaff7778bbe3326c56e2c0554ac42e2cddc5e4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=9B=A8=E8=90=BD?=
 <53731501+qyl27@users.noreply.github.com>
Date: Tue, 24 Mar 2026 12:55:15 +0800
Subject: [PATCH] chore(docs): added comment for target field (#1465)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---------

Signed-off-by: 秋雨落 <i@rain.cx>
Co-authored-by-agent: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
---
 docs/.vitepress/theme/config.ts | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/docs/.vitepress/theme/config.ts b/docs/.vitepress/theme/config.ts
index a5d0c8d3e..18bcd6133 100644
--- a/docs/.vitepress/theme/config.ts
+++ b/docs/.vitepress/theme/config.ts
@@ -8,10 +8,22 @@ interface HomePageConfig {
   buttons: ButtonItem[]
 }
 
-export interface ButtonItem {
+export interface ButtonItem extends Link {
+  primary?: boolean
+}
+
+export interface Link {
   text?: string
   link?: string
-  primary?: boolean
+
+  /**
+   * VitePress intercepts `<a>` tag clicks for SPA navigation, which can cause routing errors for external links.<br/>
+   * Adding a `target` attribute allows the browser to handle the navigation natively, avoiding this problem.
+   *
+   * See:<br/>
+   * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/a#target<br/>
+   * https://stackoverflow.com/questions/79348337/redirect-main-title-link-in-vitepress-to-my-personal-website/79386388#79386388
+   */
   target?: string
 }