@intlayer/docs 8.1.7 → 8.1.8

package/docs/vi/intlayer_with_nextjs_page_router.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-07
 updatedAt: 2025-12-30
-title: Next.js Page Router i18n - Cách dịch ứng dụng Next.js của bạn – hướng dẫn 2026
+title: Next.js Page Router i18n - Cách dịch ứng dụng Next.js năm 2026
 description: Khám phá cách làm cho trang web Next.js sử dụng Page Router của bạn đa ngôn ngữ. Theo dõi tài liệu để quốc tế hóa (i18n) và dịch nó.
 keywords:
   - Quốc tế hóa

package/docs/vi/intlayer_with_nuxt.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-06-18
 updatedAt: 2025-12-07
-title: Nuxt i18n - Cách dịch ứng dụng Nuxt của bạn – hướng dẫn 2026
+title: Nuxt i18n - Cách dịch ứng dụng Nuxt năm 2026
 description: Khám phá cách làm cho trang web Nuxt và Vue của bạn đa ngôn ngữ. Theo dõi tài liệu để quốc tế hóa (i18n) và dịch nó.
 keywords:
   - Quốc tế hóa

package/docs/vi/intlayer_with_react_native+expo.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2025-06-18
 updatedAt: 2025-12-30
-title: React Native và Expo i18n - Cách dịch ứng dụng React Native của bạn – hướng dẫn 2026
-description: Khám phá cách làm cho trang web React Native và Expo của bạn đa ngôn ngữ. Theo dõi tài liệu để quốc tế hóa (i18n) và dịch nó.
+title: Expo + React Native i18n - Cách dịch ứng dụng React Native năm 2026
+description: Khám phá cách làm cho trang web Expo và React Native của bạn đa ngôn ngữ. Theo dõi tài liệu để quốc tế hóa (i18n) và dịch nó.
 keywords:
   - Quốc tế hóa
   - Tài liệu
@@ -27,7 +27,7 @@ history:
     changes: Khởi tạo lịch sử
 ---
 
-# Dịch trang web React Native và Expo của bạn bằng Intlayer | Quốc tế hóa (i18n)
+# Dịch ứng dụng Expo và React Native của bạn | Quốc tế hóa (i18n)
 
 ## Mục lục
 
@@ -478,6 +478,8 @@ module.exports = HomeScreen;
 
 > Khi sử dụng `content.someKey` trong các props dạng chuỗi (ví dụ, `title` của một nút hoặc `children` của một component `Text`), **hãy gọi `content.someKey.value`** để lấy chuỗi thực tế.
 
+> Nếu ứng dụng của bạn đã tồn tại, bạn có thể sử dụng [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/compiler.md) kết hợp với [lệnh extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/extract.md) để chuyển đổi hàng nghìn component chỉ trong một giây.
+
 ---
 
 ## (Tùy chọn) Bước 5: Thay đổi Ngôn ngữ Ứng dụng

package/docs/vi/intlayer_with_react_router_v7.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-09-04
 updatedAt: 2025-12-30
-title: React Router v7 i18n - Cách dịch ứng dụng React Router v7 của bạn – hướng dẫn 2026
+title: React Router v7 i18n - Cách dịch ứng dụng React Router v7 năm 2026
 description: Tìm hiểu cách thêm quốc tế hóa (i18n) vào ứng dụng React Router v7 của bạn bằng Intlayer. Theo dõi hướng dẫn toàn diện này để làm cho ứng dụng của bạn đa ngôn ngữ với định tuyến nhận biết locale.
 keywords:
   - Quốc tế hóa
@@ -111,7 +111,7 @@ bunx intlayer init
 <Tabs defaultTab="video">
   <Tab label="Video" value="video">
   
-<iframe title="How to translate your React Router v7 app using Intlayer" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/dS9L7uJeak4?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
+<iframe title="How to translate an React Router v7 app using Intlayer" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/dS9L7uJeak4?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
 
   </Tab>
   <Tab label="Code" value="code">
@@ -413,6 +413,8 @@ export default function Page() {
 
 > Để tìm hiểu thêm về hook `useIntlayer`, hãy tham khảo [tài liệu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/react-intlayer/useIntlayer.md).
 
+> Nếu ứng dụng của bạn đã tồn tại, bạn có thể sử dụng [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/compiler.md) kết hợp với [lệnh extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/extract.md) để chuyển đổi hàng nghìn component chỉ trong một giây.
+
 ### Bước 9: Tạo Thành Phần Chuyển Đổi Ngôn Ngữ
 
 Tạo một thành phần cho phép người dùng thay đổi ngôn ngữ:

package/docs/vi/intlayer_with_react_router_v7_fs_routes.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-09-04
 updatedAt: 2025-12-30
-title: React Router v7 i18n - Cách dịch ứng dụng React Router v7 của bạn – hướng dẫn 2026
+title: React Router v7 i18n - Cách dịch ứng dụng React Router v7 năm 2026
 description: Tìm hiểu cách thêm quốc tế hóa (i18n) vào ứng dụng React Router v7 của bạn bằng Intlayer. Theo dõi hướng dẫn toàn diện này để làm cho ứng dụng của bạn đa ngôn ngữ với định tuyến nhận biết locale.
 keywords:
   - Quốc tế hóa
@@ -110,7 +110,7 @@ bunx intlayer init
 <Tabs defaultTab="video">
   <Tab label="Video" value="video">
   
-<iframe title="How to translate your React Router v7 (File-System Routes) app using Intlayer" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/dS9L7uJeak4?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
+<iframe title="How to translate an React Router v7 (File-System Routes) app using Intlayer" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/dS9L7uJeak4?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
 
   </Tab>
   <Tab label="Code" value="code">
@@ -358,6 +358,8 @@ export default function Page() {
 
 > Để tìm hiểu thêm về hook `useIntlayer`, hãy tham khảo [tài liệu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/react-intlayer/useIntlayer.md).
 
+> Nếu ứng dụng của bạn đã tồn tại, bạn có thể sử dụng [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/compiler.md) kết hợp với [lệnh extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/extract.md) để chuyển đổi hàng nghìn component chỉ trong một giây.
+
 ### Bước 9: Tạo Thành Phần Chuyển Đổi Ngôn Ngữ
 
 Tạo một thành phần cho phép người dùng thay đổi ngôn ngữ:

package/docs/vi/intlayer_with_svelte_kit.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-11-20
 updatedAt: 2025-12-30
-title: SvelteKit i18n - Cách dịch ứng dụng SvelteKit của bạn – hướng dẫn 2026
+title: SvelteKit i18n - Cách dịch ứng dụng SvelteKit năm 2026
 description: Khám phá cách làm cho trang web SvelteKit của bạn đa ngôn ngữ. Theo dõi tài liệu để quốc tế hóa (i18n) và dịch nó bằng cách sử dụng Server-Side Rendering (SSR).
 keywords:
   - Quốc tế hóa

package/docs/vi/intlayer_with_tanstack.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-09-09
 updatedAt: 2025-12-30
-title: Tanstack Start i18n - Cách dịch ứng dụng Tanstack Start của bạn – hướng dẫn 2026
+title: Tanstack Start i18n - Cách dịch ứng dụng Tanstack Start năm 2026
 description: Tìm hiểu cách thêm quốc tế hóa (i18n) vào ứng dụng Tanstack Start của bạn bằng cách sử dụng Intlayer. Theo dõi hướng dẫn toàn diện này để làm cho ứng dụng của bạn đa ngôn ngữ với định tuyến nhận biết locale.
 keywords:
   - Quốc tế hóa

package/docs/vi/intlayer_with_vite+preact.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
 updatedAt: 2025-12-30
-title: Vite và Preact i18n - Cách dịch ứng dụng Preact của bạn – hướng dẫn 2026
+title: Vite + Preact i18n - Cách dịch ứng dụng Preact năm 2026
 description: Khám phá cách làm cho trang web Vite và Preact của bạn đa ngôn ngữ. Theo dõi tài liệu để quốc tế hóa (i18n) và dịch nó.
 keywords:
   - Quốc tế hóa
@@ -594,6 +594,8 @@ module.exports = App;
 
 > Để tìm hiểu thêm về hook `useIntlayer`, hãy tham khảo [tài liệu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/react-intlayer/useIntlayer.md) (API tương tự cho `preact-intlayer`).
 
+> Nếu ứng dụng của bạn đã tồn tại, bạn có thể sử dụng [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/compiler.md) kết hợp với [lệnh extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/extract.md) để chuyển đổi hàng nghìn component chỉ trong một giây.
+
 ### (Tùy chọn) Bước 6: Thay đổi ngôn ngữ của nội dung
 
 Để thay đổi ngôn ngữ của nội dung, bạn có thể sử dụng hàm `setLocale` được cung cấp bởi hook `useLocale`. Hàm này cho phép bạn thiết lập locale của ứng dụng và cập nhật nội dung tương ứng.

package/docs/vi/intlayer_with_vite+react.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-03-07
 updatedAt: 2025-12-30
-title: Vite và React i18n - Cách dịch ứng dụng React của bạn – hướng dẫn 2026
+title: Vite + React i18n - Cách dịch ứng dụng React năm 2026
 description: Tìm hiểu cách thêm quốc tế hóa (i18n) vào ứng dụng Vite và React của bạn bằng cách sử dụng Intlayer. Theo dõi hướng dẫn này để làm cho ứng dụng của bạn đa ngôn ngữ.
 keywords:
   - Quốc tế hóa
@@ -610,6 +610,8 @@ module.exports = App;
 
 > Để tìm hiểu thêm về hook `useIntlayer`, hãy tham khảo [tài liệu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/packages/react-intlayer/useIntlayer.md).
 
+> Nếu ứng dụng của bạn đã tồn tại, bạn có thể sử dụng [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/compiler.md) kết hợp với [lệnh extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/extract.md) để chuyển đổi hàng nghìn component chỉ trong một giây.
+
 ### (Tùy chọn) Bước 6: Thay đổi ngôn ngữ cho nội dung của bạn
 
 Để thay đổi ngôn ngữ cho nội dung của bạn, bạn có thể sử dụng hàm `setLocale` được cung cấp bởi hook `useLocale`. Hàm này cho phép bạn thiết lập locale của ứng dụng và cập nhật nội dung tương ứng.

package/docs/vi/intlayer_with_vite+react_compiler.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-03-07
 updatedAt: 2025-12-30
-title: Vite và React i18n - Chuyển đổi ứng dụng hiện có thành ứng dụng đa ngôn ngữ (hướng dẫn i18n 2026)
+title: Vite + React i18n - Chuyển đổi ứng dụng hiện có thành ứng dụng đa ngôn ngữ năm 2026
 description: Khám phá cách làm cho ứng dụng Vite và React hiện tại của bạn trở nên đa ngôn ngữ bằng cách sử dụng Intlayer Compiler. Làm theo tài liệu để quốc tế hóa (i18n) và dịch nó bằng AI.
 keywords:
   - Quốc tế hóa
@@ -13,10 +13,9 @@ keywords:
   - AI
 slugs:
   - doc
-  - moi-truong
-  - vite-va-react
-  - trinh-bien-dich
-  - AI
+  - environment
+  - vite-and-react
+  - compiler
 applicationTemplate: https://github.com/aymericzip/intlayer-vite-react-template
 youtubeVideo: https://www.youtube.com/watch?v=dS9L7uJeak4
 history:
@@ -125,9 +124,26 @@ const config: IntlayerConfig = {
     defaultLocale: Locales.ENGLISH,
   },
   compiler: {
-    enabled: true, // Có thể được đặt thành 'build-only' để giới hạn tác động đến chế độ phát triển
-    outputDir: "i18n",
-    dictionaryKeyPrefix: "", // Không có tiền tố comp-
+    /**
+     * Cho biết liệu trình biên dịch có nên được bật hay không.
+     */
+    enabled: true,
+
+    /**
+     * Thư mục đầu ra cho các từ điển đã được tối ưu hóa.
+     */
+    outputDir: "compiler",
+
+    /**
+     * Tiền tố khóa từ điển
+     */
+    dictionaryKeyPrefix: "", // Xóa tiền tố cơ bản
+
+    /**
+     * Cho biết liệu các thành phần có nên được lưu lại sau khi được biến đổi hay không.
+     * Bằng cách này, trình biên dịch có thể được chạy một lần để biến đổi ứng dụng, sau đó nó có thể được gỡ bỏ.
+     */
+    saveComponents: false,
   },
   ai: {
     provider: "openai",

package/docs/vi/intlayer_with_vite+solid.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
 updatedAt: 2025-12-30
-title: Vite và Solid i18n - Cách dịch ứng dụng Solid của bạn – hướng dẫn 2026
+title: Vite + Solid i18n - Cách dịch ứng dụng Solid năm 2026
 description: Khám phá cách làm cho trang web Vite và Solid của bạn đa ngôn ngữ. Theo dõi tài liệu để quốc tế hóa (i18n) và dịch nó.
 keywords:
   - Quốc tế hóa

package/docs/vi/intlayer_with_vite+svelte.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
 updatedAt: 2025-12-30
-title: Vite và Svelte i18n - Cách dịch ứng dụng Svelte của bạn – hướng dẫn 2026
+title: Vite + Svelte i18n - Cách dịch ứng dụng Svelte năm 2026
 description: Khám phá cách làm cho trang web Vite và Svelte của bạn đa ngôn ngữ. Theo dõi tài liệu để quốc tế hóa (i18n) và dịch nó.
 keywords:
   - Quốc tế hóa
@@ -235,6 +235,8 @@ module.exports = appContent;
 <h1><svelte:component this={$content.title} /></h1>
 <!-- Để hiển thị nội dung dưới dạng chuỗi -->
 <div aria-label={$content.title.value}></div>
+
+> Nếu ứng dụng của bạn đã tồn tại, bạn có thể sử dụng [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/compiler.md) kết hợp với [lệnh extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/extract.md) để chuyển đổi hàng nghìn component chỉ trong một giây.
 ```
 
 ### (Tùy chọn) Bước 6: Thay đổi ngôn ngữ của nội dung

package/docs/vi/intlayer_with_vite+vue.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
 updatedAt: 2025-12-30
-title: Vite và Vue i18n - Cách dịch ứng dụng Vue của bạn – hướng dẫn 2026
+title: Vite + Vue i18n - Cách dịch ứng dụng Vue năm 2026
 description: Khám phá cách làm cho trang web Vite và Vue của bạn đa ngôn ngữ. Theo dõi tài liệu để quốc tế hóa (i18n) và dịch nó.
 keywords:
   - Quốc tế hóa
@@ -515,6 +515,8 @@ Intlayer cung cấp các API khác nhau để truy cập nội dung của bạn:
   - Sử dụng `const content = useIntlayer("myContent");` và `{{ content.myContent }}` / `<content.myContent />`.
   - Hoặc sử dụng `const { myContent } = useIntlayer("myContent");` và `{{ myContent}}` / `<myContent/>` để phân rã nội dung.
 
+> Nếu ứng dụng của bạn đã tồn tại, bạn có thể sử dụng [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/compiler.md) kết hợp với [lệnh extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/extract.md) để chuyển đổi hàng nghìn component chỉ trong một giây.
+
 ### (Tùy chọn) Bước 6: Thay đổi ngôn ngữ của nội dung
 
 Để thay đổi ngôn ngữ của nội dung, bạn có thể sử dụng hàm `setLocale` được cung cấp bởi composable `useLocale`. Hàm này cho phép bạn thiết lập locale của ứng dụng và cập nhật nội dung tương ứng.

package/docs/vi/introduction.md

@@ -165,7 +165,7 @@ Tổ chức nội dung đa ngôn ngữ gần với mã nguồn của bạn để
 - **[Liệt kê](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/enumeration.md)**  
   Quản lý dễ dàng các tập dữ liệu lặp lại hoặc cố định trên nhiều ngôn ngữ khác nhau.
 
-- **[Điều kiện](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/conditional.md)**  
+- **[Điều kiện](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/condition.md)**  
   Tìm hiểu cách sử dụng logic điều kiện trong Intlayer để tạo nội dung động.
 
 - **[Chèn giá trị](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/insertion.md)**  
@@ -177,7 +177,7 @@ Tổ chức nội dung đa ngôn ngữ gần với mã nguồn của bạn để
 - **[Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/markdown.md)**  
   Tìm hiểu cách sử dụng Markdown trong Intlayer để tạo nội dung phong phú.
 
-- **[Nhúng tệp](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/file_embeddings.md)**  
+- **[Nhúng tệp](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/file.md)**  
   Khám phá cách nhúng các tệp bên ngoài vào Intlayer để sử dụng trong trình soạn thảo nội dung.
 
 - **[Lồng nhau](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/nesting.md)**  

package/docs/vi/packages/intlayer/getCanonicalPath.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2026-01-22
 updatedAt: 2026-01-22
-title: Hàm getCanonicalPath — Tài liệu | intlayer
+title: Hàm getCanonicalPath. Tài liệu | intlayer
 description: Xem cách sử dụng hàm getCanonicalPath cho package intlayer
 keywords:
   - getCanonicalPath

package/docs/vi/packages/next-intlayer/intlayerMiddleware.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-01-21
-updatedAt: 2026-01-21
+updatedAt: 2026-02-25
 title: Tài liệu intlayerMiddleware | next-intlayer
 description: Xem cách sử dụng hàm intlayerMiddleware cho gói next-intlayer
 keywords:
@@ -17,26 +17,45 @@ slugs:
   - next-intlayer
   - intlayerMiddleware
 history:
+  - version: 8.1.7
+    date: 2026-02-25
+    changes: Đổi tên intlayerMiddleware thành intlayerProxy
   - version: 8.0.0
     date: 2026-01-21
     changes: Khởi tạo tài liệu
 ---
 
-# Tài liệu intlayerMiddleware
+# Tài liệu intlayerProxy (intlayerMiddleware)
 
-Hàm `intlayerMiddleware` là một middleware của Next.js xử lý định tuyến dựa trên locale và các chuyển hướng. Nó tự động phát hiện locale ưa thích của người dùng và chuyển hướng họ đến đường dẫn đã được địa phương hóa tương ứng nếu cần.
+Hàm `intlayerProxy` ( `intlayerMiddleware` cho nextjs < 16) là một middleware của Next.js xử lý định tuyến dựa trên locale và các chuyển hướng. Nó tự động phát hiện locale ưa thích của người dùng và chuyển hướng họ đến đường dẫn đã được địa phương hóa tương ứng nếu cần.
 
 ## Cách sử dụng
 
-```ts
-// middleware.ts
-export { intlayerMiddleware as middleware } from "next-intlayer";
+<Tabs>
+ <Tab value="nextjs >=16">
+
+```ts fileName="proxy.ts"
+export { intlayerProxy as proxy } from "next-intlayer/proxy";
 
 export const config = {
   matcher: ["/((?!api|_next/static|_next/image|favicon.ico).*)"],
 };
 ```
 
+ </Tab>
+ <Tab value="nextjs <=15">
+
+```ts fileName="middleware.ts"
+export { intlayerMiddleware as middleware } from "next-intlayer/middleware";
+
+export const config = {
+  matcher: ["/((?!api|_next/static|_next/image|favicon.ico).*)"],
+};
+```
+
+ </Tab>
+</Tabs>
+
 ## Mô tả
 
 Middleware thực hiện các tác vụ sau:
@@ -48,3 +67,7 @@ Middleware thực hiện các tác vụ sau:
 ## Tham số
 
 Hàm nhận đối tượng chuẩn Next.js `NextRequest` làm tham số khi được sử dụng trực tiếp, hoặc có thể được export như ví dụ ở trên.
+
+## Cấu hình
+
+Để cấu hình middleware, bạn có thể thiết lập tùy chọn `routing` trong tệp `intlayer.config.ts`. Xem [cấu hình](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/configuration.md) để biết thêm chi tiết.

package/docs/vi/readme.md

@@ -214,7 +214,7 @@ Khám phá tài liệu toàn diện của chúng tôi để bắt đầu với I
 <details>
 <summary style="font-size:16px; font-weight:bold;">📰 Blog</summary>
 <ul>
-  <li><a href="https://github.com/aymericzip/intlayer/blob/main/docs/blog/en/what_is_internationalization.md" rel=''>i18n là gì</a></li>
+  <li><a href="https://github.com/aymericzip/intlayer/blob/main/docs/blog/vi/what_is_internationalization.md" rel=''>i18n là gì</a></li>
   <li><a href="https://intlayer.org/blog/SEO-and-i18n" rel=''>i18n và SEO</a></li>
   <li><a href="https://intlayer.org/blog/intlayer-with-next-i18next" rel=''>Intlayer và i18next</a></li>
   <li><a href="https://intlayer.org/blog/intlayer-with-react-i18next" rel=''>Intlayer và react-intl</a></li>

package/docs/vi/releases/v8.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-09-22
 updatedAt: 2026-01-26
-title: Intlayer v8 — Có gì mới?
+title: Intlayer v8. Có gì mới?
 description: Khám phá những điểm mới trong Intlayer v8. Cải tiến chính về trải nghiệm nhà phát triển, xác thực theo schema và quản lý từ điển.
 keywords:
   - Intlayer
@@ -19,7 +19,7 @@ slugs:
   - v8
 ---
 
-# Intlayer v8 — Có gì mới?
+# Intlayer v8. Có gì mới?
 
 Chào mừng đến với Intlayer v8! Bản phát hành này tập trung vào nâng cao trải nghiệm nhà phát triển với phát hiện nội dung tự động, đảm bảo tính toàn vẹn dữ liệu bằng xác thực theo schema và cung cấp nhiều khả năng kiểm soát hơn đối với quản lý từ điển.
 

package/docs/zh/agent_skills.md

@@ -18,6 +18,8 @@ history:
     changes: 初始化历史
 ---
 
+# 代理技能
+
 ## `intlayer init skills` 命令
 
 `intlayer init skills` 命令是在项目中设置代理技能的最简单方法。它会检测您的环境并为您喜欢的平台安装必要的配置文件。

package/docs/zh/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2025-09-09
+updatedAt: 2026-02-25
 title: Intlayer 编译器 | 用于 i18n 的自动内容提取
 description: 使用 Intlayer 编译器自动化您的国际化流程。直接从组件中提取内容，实现 Vite、Next.js 等框架中更快速、更高效的 i18n。
 keywords:
@@ -20,6 +20,9 @@ slugs:
   - doc
   - compiler
 history:
+  - version: 8.1.7
+    date: 2026-02-25
+    changes: 更新编译器选项
   - version: 7.3.1
     date: 2025-11-27
     changes: 发布编译器
@@ -144,6 +147,55 @@ See complete tutorial: [Intlayer Compiler with Next.js](https://github.com/aymer
 
  </Tab>
 
+### 自定义配置
+
+要自定义编译器的行为，您可以更新项目根目录中的 `intlayer.config.ts` 文件。
+
+```ts fileName="intlayer.config.ts"
+import { type IntlayerConfig, Locales } from "intlayer";
+
+const config: IntlayerConfig = {
+  compiler: {
+    /**
+     * 指示是否应启用编译器。
+     * 设置为 'build-only' 可在开发期间跳过编译器并加快启动速度。
+     */
+    enabled: true,
+
+    /**
+     * 遍历要优化的代码的模式。
+     */
+    transformPattern: [
+      "**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}",
+      "!**/node_modules/**",
+    ],
+
+    /**
+     * 要从优化中排除的模式。
+     */
+    excludePattern: ["**/node_modules/**"],
+
+    /**
+     * 优化后字典的输出目录。
+     */
+    outputDir: "i18n",
+
+    /**
+     * 字典键前缀
+     */
+    dictionaryKeyPrefix: "", // 移除基本前缀
+
+    /**
+     * 指示是否应在转换后保存组件。
+     * 这样，编译器只需运行一次即可转换应用程序，然后可以将其移除。
+     */
+    saveComponents: false,
+  },
+};
+
+export default config;
+```
+
 ### 填充缺失的翻译
 
 Intlayer 提供了一个 CLI 工具来帮助您填充缺失的翻译。您可以使用 `intlayer` 命令来测试并从代码中填充缺失的翻译。

package/docs/zh/component_i18n.md

@@ -78,7 +78,7 @@ export default componentContent;
 
 ## 2) 获取您的内容
 
-### 情况 A — React 应用 (Vite/SPA)
+### 情况 A. React 应用 (Vite/SPA)
 
 默认方法：使用 `useIntlayer` 通过键来获取内容。这使组件保持简洁且类型安全。
 
@@ -129,7 +129,7 @@ export function ComponentWithDictionary() {
 }
 ```
 
-### 方案 B — Next.js（App 路由）
+### 方案 B. Next.js（App 路由）
 
 优先使用服务器组件以确保数据安全和性能。在服务器文件中使用来自 `next-intlayer/server` 的 `useIntlayer`，在客户端组件中使用来自 `next-intlayer` 的 `useIntlayer`。
 

package/docs/zh/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-02-12
+updatedAt: 2026-02-25
 title: 配置
 description: 了解如何为您的应用程序配置 Intlayer。了解各种设置和选项，以根据您的需求自定义 Intlayer。
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.1.7
+    date: 2026-02-25
+    changes: 更新编译器选项
   - version: 8.0.6
     date: 2026-02-12
     changes: Add support for Open Router, Alibaba, Amazon, Google Vertex Bedrock, Fireworks, Groq, Hugging Face, and Together.ai providers
@@ -440,6 +443,17 @@ const config: IntlayerConfig = {
      * Output directory for the optimized dictionaries.
      */
     outputDir: "compiler",
+
+    /**
+     * Dictionary key prefix
+     */
+    dictionaryKeyPrefix: "", // Remove base prefix
+
+    /**
+     * Indicates if the components should be saved after being transformed.
+     * That way, the compiler can be run only once to transform the app, and then it can be removed.
+     */
+    saveComponents: false,
   },
 
   /**
@@ -979,6 +993,13 @@ Intlayer 支持多个 AI 提供商，以增强灵活性和选择。目前支持
   - _注意_: 实时模式将使用实时同步 API 来获取字典。如果 API 调用失败，字典将以 "dynamic" 模式动态导入。
   - _注意_: 此选项不会影响 `getIntlayer`、`getDictionary`、`useDictionary`、`useDictionaryAsync` 和 `useDictionaryDynamic` 函数。
 
+- **outputFormat**：
+  - _类型_： `'esm' | 'cjs'`
+  - _默认值_： `'esm'`
+  - _描述_： 控制字典的输出格式。
+  - _示例_： `'cjs'`
+  - _注意_： 字典的输出格式。
+
 - **traversePattern**:
   - _类型_: `string[]`
   - _默认值_: `['**\/*.{js,ts,mjs,cjs,jsx,tsx}', '!**\/node_modules/**']`
@@ -987,3 +1008,49 @@ Intlayer 支持多个 AI 提供商，以增强灵活性和选择。目前支持
   - _注意_：使用此选项限制优化范围到相关代码文件，以提升构建性能。
   - _注意_：如果禁用 `optimize`，此选项将被忽略。
   - _注意_：使用 glob 模式。
+
+---
+
+### 编译器配置
+
+控制 Intlayer 编译器的设置，该编译器直接从您的组件中提取字典。
+
+#### 属性
+
+- **enabled**:
+  - _类型_：`boolean | 'build-only'`
+  - _默认值_：`true`
+  - _描述_：指示是否应启用编译器以提取字典。
+  - _示例_：`'build-only'`
+  - _注意_：设置为 `'build-only'` 将在开发模式下跳过编译器，以加快启动速度。它仅在构建命令时运行。
+
+- **dictionaryKeyPrefix**:
+  - _类型_：`string`
+  - _默认值_：`'comp-'`
+  - _描述_：提取的字典键的前缀。
+  - _示例_：`'my-key-'`
+  - _注意_：提取字典时，键是根据文件名生成的。此前缀会添加到生成的键中，以防止冲突。
+
+- **saveComponents**:
+  - _类型_：`boolean`
+  - _默认值_：`false`
+  - _描述_：指示是否应在转换后保存组件。
+  - _注意_：如果为 true，编译器将用转换后的文件替换原始文件。这样，编译器只需运行一次来转换应用，然后即可移除。
+
+- **transformPattern**:
+  - _类型_：`string | string[]`
+  - _默认值_：`['**/*.{ts,tsx,jsx,js,cjs,mjs,svelte,vue}', '!**/node_modules/**']`
+  - _描述_：定义在优化过程中应遍历哪些文件的模式。
+  - _示例_：`['src/**/*.{ts,tsx}', '!**/node_modules/**']`
+  - _注意_：使用此选项限制优化范围到相关代码文件，以提升构建性能。
+
+- **excludePattern**:
+  - _类型_：`string | string[]`
+  - _默认值_：`['**/node_modules/**']`
+  - _描述_：定义在优化过程中应排除哪些文件的模式。
+  - _示例_：`['**/node_modules/**', '!**/node_modules/react/**']`
+
+- **outputDir**:
+  - _类型_：`string`
+  - _默认值_： `'compiler'`
+  - _描述_：存储提取字典的目录，相对于您的项目基准路径。

package/docs/zh/dictionary/content_file.md

@@ -512,7 +512,7 @@ export default aboutPageMetaContent;
 
 - `'local'`: 字典仅在本地管理。它不会被推送到远程 CMS。用于应保留在代码库中的内容。
 - `'remote'`: 字典仅在远程管理。推送到 CMS 后，它将与本地文件分离。在内容加载时，远程字典将从 CMS 拉取。带有 `remote` 位置的 `.content` 文件在初始推送后将被忽略。
-- `'hybrid'`: 字典在本地和远程同时管理。推送到 CMS 后，它将保持同步—本地文件的更改会推送到 CMS，远程更改可以拉回本地文件。
+- `'hybrid'`: 字典在本地和远程同时管理。推送到 CMS 后，它将保持同步, 本地文件的更改会推送到 CMS，远程更改可以拉回本地文件。
 - `string`（例如 `'plugin'`）：字典由插件或自定义源管理。当您尝试推送时，系统会询问您要执行的操作。
 
 **示例：**

package/docs/zh/index.md

@@ -64,7 +64,7 @@ Intlayer 提供了一种灵活且现代化的应用翻译方案。我们的文
 - **[枚举](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/enumeration.md)**  
   轻松管理跨多种语言的重复或固定数据集。
 
-- **[条件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/conditional.md)**  
+- **[条件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/condition.md)**  
   学习如何在 Intlayer 中使用条件逻辑来创建动态内容。
 
 - **[插入](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/insertion.md)**  
@@ -76,7 +76,7 @@ Intlayer 提供了一种灵活且现代化的应用翻译方案。我们的文
 - **[枚举](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/enumeration.md)**  
   轻松管理跨多语言的重复或固定数据集。
 
-- **[条件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/conditional.md)**  
+- **[条件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/condition.md)**  
   学习如何在 Intlayer 中使用条件逻辑来创建动态内容。
 
 - **[插入](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/insertion.md)**  
@@ -88,7 +88,7 @@ Intlayer 提供了一种灵活且现代化的应用翻译方案。我们的文
 - **[Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/markdown.md)**  
   学习如何在 Intlayer 中使用 Markdown 创建丰富内容。
 
-- **[文件嵌入](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/file_embeddings.md)**  
+- **[文件嵌入](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/file.md)**  
   了解如何在 Intlayer 中嵌入外部文件，以便在内容编辑器中使用。
 
 - **[嵌套](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/nesting.md)**  

package/docs/zh/intlayer_CMS.md

@@ -443,7 +443,7 @@ module.exports = config;
 
 Live Sync 服务器包裹您的应用程序，并在更新内容到达时自动应用。
 
-为了接收来自 CMS 的变更通知，Live Sync 服务器会与后端保持 SSE 连接。当 CMS 中的内容发生变化时，后端会将更新转发给 Live Sync 服务器，服务器会写入新的字典。您的应用将在下一次导航或浏览器刷新时反映更新——无需重新构建。
+为了接收来自 CMS 的变更通知，Live Sync 服务器会与后端保持 SSE 连接。当 CMS 中的内容发生变化时，后端会将更新转发给 Live Sync 服务器，服务器会写入新的字典。您的应用将在下一次导航或浏览器刷新时反映更新, 无需重新构建。
 
 流程图（CMS/后端 -> Live Sync 服务器 -> 应用服务器 -> 前端）：