From 1a0e6d463a12916ffaa7d13fcf4b620ba889bc80 Mon Sep 17 00:00:00 2001
From: Wu Qing <3184394176@qq.com>
Date: Fri, 17 Apr 2026 13:52:16 +0800
Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E5=A4=8D:=20=E4=B8=AD=E6=96=87=20i18n?=
 =?UTF-8?q?=20=E7=9B=AE=E5=BD=95=E5=90=8D=E4=BB=8E=20zh-Hans=20=E6=94=B9?=
 =?UTF-8?q?=E4=B8=BA=20zh-CN=EF=BC=8C=E9=A6=96=E9=A1=B5=20SSR=20=E7=BF=BB?=
 =?UTF-8?q?=E8=AF=91=E7=8E=B0=E5=B7=B2=E7=94=9F=E6=95=88=20(#42)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Docusaurus 3.10 会把 locale id 'zh-Hans' 规范化为 BCP 47 的 'zh-CN' 来
读取 i18n/ 目录。之前手工创建的 i18n/zh-Hans/ 目录 Docusaurus 识别不到，
导致中文版 SSR 输出仍是英文字符串，只有 URL 路由 /zh-Hans/ 生效。

同时修复 index.tsx 中 <Translate id={labelId}> 动态 id 问题：
write-translations 工具要求静态字符串，已拆分为三个独立的 Translate 元素。
---
 docs-site/i18n/{zh-Hans => zh-CN}/code.json   |  0
 .../current.json                              |  0
 .../current/deployment/bare-metal.md          |  0
 .../current/deployment/configuration.md       |  0
 .../current/deployment/docker.md              |  0
 .../current/deployment/nginx.md               |  0
 .../current/development/contributing.md       |  0
 .../current/development/setup.md              |  0
 .../current/features/backup-types.md          |  0
 .../current/features/multi-node.md            |  0
 .../current/features/notifications.md         |  0
 .../current/features/sap-hana.md              |  0
 .../current/features/storage-backends.md      |  0
 .../current/getting-started/installation.md   |  0
 .../current/getting-started/quick-start.md    |  0
 .../current/intro.md                          |  0
 .../current/reference/api.md                  |  0
 .../current/reference/cli.md                  |  0
 .../docusaurus-theme-classic/footer.json      |  0
 .../docusaurus-theme-classic/navbar.json      |  0
 docs-site/src/pages/index.tsx                 | 36 +++++++++----------
 21 files changed, 18 insertions(+), 18 deletions(-)
 rename docs-site/i18n/{zh-Hans => zh-CN}/code.json (100%)
 rename docs-site/i18n/{zh-Hans => zh-CN}/docusaurus-plugin-content-docs/current.json (100%)
 rename docs-site/i18n/{zh-Hans => zh-CN}/docusaurus-plugin-content-docs/current/deployment/bare-metal.md (100%)
 rename docs-site/i18n/{zh-Hans => zh-CN}/docusaurus-plugin-content-docs/current/deployment/configuration.md (100%)
 rename docs-site/i18n/{zh-Hans => zh-CN}/docusaurus-plugin-content-docs/current/deployment/docker.md (100%)
 rename docs-site/i18n/{zh-Hans => zh-CN}/docusaurus-plugin-content-docs/current/deployment/nginx.md (100%)
 rename docs-site/i18n/{zh-Hans => zh-CN}/docusaurus-plugin-content-docs/current/development/contributing.md (100%)
 rename docs-site/i18n/{zh-Hans => zh-CN}/docusaurus-plugin-content-docs/current/development/setup.md (100%)
 rename docs-site/i18n/{zh-Hans => zh-CN}/docusaurus-plugin-content-docs/current/features/backup-types.md (100%)
 rename docs-site/i18n/{zh-Hans => zh-CN}/docusaurus-plugin-content-docs/current/features/multi-node.md (100%)
 rename docs-site/i18n/{zh-Hans => zh-CN}/docusaurus-plugin-content-docs/current/features/notifications.md (100%)
 rename docs-site/i18n/{zh-Hans => zh-CN}/docusaurus-plugin-content-docs/current/features/sap-hana.md (100%)
 rename docs-site/i18n/{zh-Hans => zh-CN}/docusaurus-plugin-content-docs/current/features/storage-backends.md (100%)
 rename docs-site/i18n/{zh-Hans => zh-CN}/docusaurus-plugin-content-docs/current/getting-started/installation.md (100%)
 rename docs-site/i18n/{zh-Hans => zh-CN}/docusaurus-plugin-content-docs/current/getting-started/quick-start.md (100%)
 rename docs-site/i18n/{zh-Hans => zh-CN}/docusaurus-plugin-content-docs/current/intro.md (100%)
 rename docs-site/i18n/{zh-Hans => zh-CN}/docusaurus-plugin-content-docs/current/reference/api.md (100%)
 rename docs-site/i18n/{zh-Hans => zh-CN}/docusaurus-plugin-content-docs/current/reference/cli.md (100%)
 rename docs-site/i18n/{zh-Hans => zh-CN}/docusaurus-theme-classic/footer.json (100%)
 rename docs-site/i18n/{zh-Hans => zh-CN}/docusaurus-theme-classic/navbar.json (100%)

diff --git a/docs-site/i18n/zh-Hans/code.json b/docs-site/i18n/zh-CN/code.json
similarity index 100%
rename from docs-site/i18n/zh-Hans/code.json
rename to docs-site/i18n/zh-CN/code.json
diff --git a/docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current.json b/docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current.json
similarity index 100%
rename from docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current.json
rename to docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current.json
diff --git a/docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/deployment/bare-metal.md b/docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/deployment/bare-metal.md
similarity index 100%
rename from docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/deployment/bare-metal.md
rename to docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/deployment/bare-metal.md
diff --git a/docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/deployment/configuration.md b/docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/deployment/configuration.md
similarity index 100%
rename from docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/deployment/configuration.md
rename to docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/deployment/configuration.md
diff --git a/docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/deployment/docker.md b/docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/deployment/docker.md
similarity index 100%
rename from docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/deployment/docker.md
rename to docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/deployment/docker.md
diff --git a/docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/deployment/nginx.md b/docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/deployment/nginx.md
similarity index 100%
rename from docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/deployment/nginx.md
rename to docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/deployment/nginx.md
diff --git a/docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/development/contributing.md b/docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/development/contributing.md
similarity index 100%
rename from docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/development/contributing.md
rename to docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/development/contributing.md
diff --git a/docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/development/setup.md b/docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/development/setup.md
similarity index 100%
rename from docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/development/setup.md
rename to docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/development/setup.md
diff --git a/docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/features/backup-types.md b/docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/backup-types.md
similarity index 100%
rename from docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/features/backup-types.md
rename to docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/backup-types.md
diff --git a/docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/features/multi-node.md b/docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/multi-node.md
similarity index 100%
rename from docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/features/multi-node.md
rename to docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/multi-node.md
diff --git a/docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/features/notifications.md b/docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/notifications.md
similarity index 100%
rename from docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/features/notifications.md
rename to docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/notifications.md
diff --git a/docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/features/sap-hana.md b/docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/sap-hana.md
similarity index 100%
rename from docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/features/sap-hana.md
rename to docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/sap-hana.md
diff --git a/docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/features/storage-backends.md b/docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/storage-backends.md
similarity index 100%
rename from docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/features/storage-backends.md
rename to docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/storage-backends.md
diff --git a/docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/installation.md b/docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/getting-started/installation.md
similarity index 100%
rename from docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/installation.md
rename to docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/getting-started/installation.md
diff --git a/docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/quick-start.md b/docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/getting-started/quick-start.md
similarity index 100%
rename from docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/quick-start.md
rename to docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/getting-started/quick-start.md
diff --git a/docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/intro.md b/docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/intro.md
similarity index 100%
rename from docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/intro.md
rename to docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/intro.md
diff --git a/docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/api.md b/docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/reference/api.md
similarity index 100%
rename from docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/api.md
rename to docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/reference/api.md
diff --git a/docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/cli.md b/docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/reference/cli.md
similarity index 100%
rename from docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/cli.md
rename to docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/reference/cli.md
diff --git a/docs-site/i18n/zh-Hans/docusaurus-theme-classic/footer.json b/docs-site/i18n/zh-CN/docusaurus-theme-classic/footer.json
similarity index 100%
rename from docs-site/i18n/zh-Hans/docusaurus-theme-classic/footer.json
rename to docs-site/i18n/zh-CN/docusaurus-theme-classic/footer.json
diff --git a/docs-site/i18n/zh-Hans/docusaurus-theme-classic/navbar.json b/docs-site/i18n/zh-CN/docusaurus-theme-classic/navbar.json
similarity index 100%
rename from docs-site/i18n/zh-Hans/docusaurus-theme-classic/navbar.json
rename to docs-site/i18n/zh-CN/docusaurus-theme-classic/navbar.json
diff --git a/docs-site/src/pages/index.tsx b/docs-site/src/pages/index.tsx
index 60c2c50..c7049e8 100644
--- a/docs-site/src/pages/index.tsx
+++ b/docs-site/src/pages/index.tsx
@@ -44,11 +44,26 @@ function HomepageHeader() {
             </Link>
           </div>
           <div className={styles.metrics}>
-            <MetricItem labelId="home.metric.backends" valueClass={styles.metricValue}>70+</MetricItem>
+            <div className={styles.metric}>
+              <div className={styles.metricValue}>70+</div>
+              <div className={styles.metricLabel}>
+                <Translate id="home.metric.backends">Storage backends</Translate>
+              </div>
+            </div>
             <div className={styles.metricDivider} />
-            <MetricItem labelId="home.metric.backupTypes" valueClass={styles.metricValue}>5</MetricItem>
+            <div className={styles.metric}>
+              <div className={styles.metricValue}>5</div>
+              <div className={styles.metricLabel}>
+                <Translate id="home.metric.backupTypes">Backup types</Translate>
+              </div>
+            </div>
             <div className={styles.metricDivider} />
-            <MetricItem labelId="home.metric.license" valueClass={styles.metricValue}>Apache 2.0</MetricItem>
+            <div className={styles.metric}>
+              <div className={styles.metricValue}>Apache 2.0</div>
+              <div className={styles.metricLabel}>
+                <Translate id="home.metric.license">License</Translate>
+              </div>
+            </div>
           </div>
         </div>
         <div className={styles.heroCode}>
@@ -81,21 +96,6 @@ function HomepageHeader() {
   );
 }
 
-function MetricItem({children, labelId, valueClass}: {children: ReactNode; labelId: string; valueClass: string}) {
-  return (
-    <div className={styles.metric}>
-      <div className={valueClass}>{children}</div>
-      <div className={styles.metricLabel}>
-        <Translate id={labelId}>
-          {labelId === 'home.metric.backends' ? 'Storage backends'
-            : labelId === 'home.metric.backupTypes' ? 'Backup types'
-            : 'License'}
-        </Translate>
-      </div>
-    </div>
-  );
-}
-
 export default function Home(): ReactNode {
   const {siteConfig} = useDocusaurusContext();
   return (