From fe65d548beab2490013b56539d01da4e24ebdff8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=99=86=E4=BC=AF=E8=A8=80?= <maoxuner@126.com>
Date: Sun, 19 Jul 2026 01:17:22 +0800
Subject: [PATCH 1/3] =?UTF-8?q?docs:=20=E4=BF=AE=E5=A4=8D=E8=8B=B1?=
 =?UTF-8?q?=E6=96=87=E8=AF=AD=E8=A8=80=E6=96=87=E4=BB=B6=E8=B7=AF=E5=BE=84?=
 =?UTF-8?q?=E9=94=99=E8=AF=AF?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

closed #8158
---
 docs/src/en/guide/in-depth/locale.md | 8 +++-----
 docs/src/guide/in-depth/locale.md    | 8 +++-----
 2 files changed, 6 insertions(+), 10 deletions(-)

diff --git a/docs/src/en/guide/in-depth/locale.md b/docs/src/en/guide/in-depth/locale.md
index 549bc83f..b46716d9 100644
--- a/docs/src/en/guide/in-depth/locale.md
+++ b/docs/src/en/guide/in-depth/locale.md
@@ -60,25 +60,23 @@ To add new translation texts, simply find `src/locales/langs/` in the correspond
 
 **src/locales/langs/zh-CN/\*.json**
 
-````ts
 ```json
 {
   "about": {
     "desc": "Vben Admin 是一个现代的管理模版。"
   }
 }
-````
+```
 
-**src/locales/langs/en-US.ts**
+**src/locales/langs/en-US/\*.json**
 
-````ts
 ```json
 {
   "about": {
     "desc": "Vben Admin is a modern management template."
   }
 }
-````
+```
 
 ## Using Translation Texts
 
diff --git a/docs/src/guide/in-depth/locale.md b/docs/src/guide/in-depth/locale.md
index e4a4a659..8c4b7ac0 100644
--- a/docs/src/guide/in-depth/locale.md
+++ b/docs/src/guide/in-depth/locale.md
@@ -60,25 +60,23 @@ updateLocale('en-US');
 
 **src/locales/langs/zh-CN/\*.json**
 
-````ts
 ```json
 {
   "about": {
     "desc": "Vben Admin 是一个现代的管理模版。"
   }
 }
-````
+```
 
-**src/locales/langs/en-US.ts**
+**src/locales/langs/en-US/\*.json**
 
-````ts
 ```json
 {
   "about": {
     "desc": "Vben Admin is a modern management template."
   }
 }
-````
+```
 
 ## 使用翻译文本
 

From 41c20a43aff4d0b3c795c358241fd1a588e45996 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=99=86=E4=BC=AF=E8=A8=80?= <maoxuner@126.com>
Date: Sun, 19 Jul 2026 01:22:00 +0800
Subject: [PATCH 2/3] =?UTF-8?q?docs:=20=E6=9B=B4=E6=AD=A3=E8=AF=AD?=
 =?UTF-8?q?=E8=A8=80=E4=BD=BF=E7=94=A8=E7=A4=BA=E4=BE=8B,=E7=A1=AE?=
 =?UTF-8?q?=E4=BF=9D=E5=8F=AF=E7=94=A8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

使用可用的语言配置
修复computed变量使用语法错误

closed #8159
---
 docs/src/en/guide/in-depth/locale.md | 6 +++---
 docs/src/guide/in-depth/locale.md    | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/src/en/guide/in-depth/locale.md b/docs/src/en/guide/in-depth/locale.md
index b46716d9..ee46901a 100644
--- a/docs/src/en/guide/in-depth/locale.md
+++ b/docs/src/en/guide/in-depth/locale.md
@@ -89,11 +89,11 @@ With `@vben/locales`, you can easily use translation texts:
 import { computed } from 'vue';
 import { $t } from '@vben/locales';
 
-const items = computed(() => [{ title: $t('about.desc') }]);
+const items = computed(() => [{ title: $t('demos.title') }]);
 </script>
 <template>
-  <div>{{ $t('about.desc') }}</div>
-  <template v-for="item in items.value">
+  <div>{{ $t('demos.title') }}</div>
+  <template v-for="item in items">
     <div>{{ item.title }}</div>
   </template>
 </template>
diff --git a/docs/src/guide/in-depth/locale.md b/docs/src/guide/in-depth/locale.md
index 8c4b7ac0..29e7a7c5 100644
--- a/docs/src/guide/in-depth/locale.md
+++ b/docs/src/guide/in-depth/locale.md
@@ -89,11 +89,11 @@ updateLocale('en-US');
 import { computed } from 'vue';
 import { $t } from '@vben/locales';
 
-const items = computed(() => [{ title: $t('about.desc') }]);
+const items = computed(() => [{ title: $t('demos.title') }]);
 </script>
 <template>
-  <div>{{ $t('about.desc') }}</div>
-  <template v-for="item in items.value">
+  <div>{{ $t('demos.title') }}</div>
+  <template v-for="item in items">
     <div>{{ item.title }}</div>
   </template>
 </template>

From 930597c605c879d63e995af6e632962448e694be Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=99=86=E4=BC=AF=E8=A8=80?= <maoxuner@126.com>
Date: Sun, 19 Jul 2026 02:27:09 +0800
Subject: [PATCH 3/3] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=E6=96=B0?=
 =?UTF-8?q?=E5=A2=9E=E8=AF=AD=E8=A8=80=E5=8C=85=E7=9A=84=E8=AF=B4=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

closed #8160
---
 docs/src/en/guide/in-depth/locale.md | 4 ++--
 docs/src/guide/in-depth/locale.md    | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/src/en/guide/in-depth/locale.md b/docs/src/en/guide/in-depth/locale.md
index ee46901a..d186c1f6 100644
--- a/docs/src/en/guide/in-depth/locale.md
+++ b/docs/src/en/guide/in-depth/locale.md
@@ -103,8 +103,8 @@ const items = computed(() => [{ title: $t('demos.title') }]);
 
 If you need to add a new language pack, follow these steps:
 
-- Add the corresponding language pack file in the `packages/locales/langs` directory, for example, `zh-TW.json`, and translate the respective texts.
-- In the corresponding application, locate the `src/locales/langs` file and add the new language pack `zh-TW.json`.
+- Create the corresponding language pack folder and files under `packages/locales/langs` (e.g., `zh-TW/*.json`) and translate the texts accordingly.
+- In the corresponding application, find the `src/locales/langs` directory and create the same language pack folder and files (e.g., `zh-TW/*.json`).
 - Add the corresponding language in `packages/constants/src/core.ts`:
 
   ```ts
diff --git a/docs/src/guide/in-depth/locale.md b/docs/src/guide/in-depth/locale.md
index 29e7a7c5..6bba311f 100644
--- a/docs/src/guide/in-depth/locale.md
+++ b/docs/src/guide/in-depth/locale.md
@@ -103,8 +103,8 @@ const items = computed(() => [{ title: $t('demos.title') }]);
 
 如果你需要新增语言包，需要按照以下步骤进行：
 
-- 在 `packages/locales/langs` 目录下新增对应的语言包文件，例：`zh-TW.json`，并翻译对应的文本。
-- 在对应的应用内，找到 `src/locales/langs` 文件，新增对应的语言包 `zh-TW.json`
+- 在 `packages/locales/langs` 目录下新增对应的语言包文件夹和文件，例：`zh-TW/*.json`，并翻译对应的文本。
+- 在对应的应用内，找到 `src/locales/langs` 目录，新增对应的语言包文件夹和文件 `zh-TW/*.json`。
 - 在 `packages/constants/src/core.ts`内，新增对应的语言：
 
   ```ts