@intlayer/docs 9.0.0-canary.3 → 9.0.0-canary.5

package/docs/vi/packages/svelte-intlayer/usePathname.md

@@ -0,0 +1,103 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Tài liệu hàm usePathname | svelte-intlayer
+description: Tìm hiểu cách sử dụng hàm usePathname từ gói svelte-intlayer
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Quốc tế hóa
+  - Tài liệu
+  - Svelte
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - svelte-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Thêm tiện ích usePathname"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "Khởi tạo lịch sử"
+author: aymericzip
+---
+
+# Tích hợp Svelte: Tài liệu `usePathname`
+
+Hàm `usePathname` trả về pathname của trình duyệt hiện tại với phần locale đã bị loại bỏ, dưới dạng một Svelte `Readable<string>` store. Nó hữu ích cho việc xây dựng điều hướng nhận biết locale — ví dụ, xác định mục điều hướng nào đang hoạt động — mà không cần phải loại bỏ tiền tố locale theo cách thủ công.
+
+## Import `usePathname` trong Svelte
+
+```typescript
+import { usePathname } from "svelte-intlayer";
+```
+
+## Tổng quan
+
+`usePathname` tạo ra một Svelte readable store được khởi tạo từ `window.location.pathname`, loại bỏ tiền tố locale thông qua `getPathWithoutLocale`, và phát ra một giá trị mới mỗi khi trình duyệt kích hoạt sự kiện `popstate` (điều hướng quay lại/tiến lên). Đăng ký theo dõi (subscribe) bằng cú pháp `$` trong các component.
+
+## Sử dụng
+
+```svelte fileName="src/components/NavItem.svelte"
+<script lang="ts">
+  import { usePathname } from "svelte-intlayer";
+
+  export let href: string;
+  export let label: string;
+
+  const pathname = usePathname();
+</script>
+
+<a {href} aria-current={$pathname === href ? "page" : undefined}>
+  {label}
+</a>
+```
+
+## Giá trị trả về
+
+| Kiểu dữ liệu       | Mô tả                                                                      |
+| ------------------ | -------------------------------------------------------------------------- |
+| `Readable<string>` | Svelte readable store chứa pathname hiện tại không bao gồm tiền tố locale. |
+
+## Hành vi
+
+- **Loại bỏ locale**: Xóa bỏ phần locale ở đầu pathname (ví dụ: `/vi/dashboard` → `/dashboard`).
+- **Phản ứng (Reactive)**: Phát ra giá trị mới trên mỗi sự kiện `popstate` (điều hướng quay lại / tiến lên của trình duyệt).
+- **An toàn cho SSR**: Trả về `""` khi `window` không có sẵn.
+- **Dọn dẹp**: `popstate` listener được loại bỏ tự động khi subscriber cuối cùng hủy đăng ký.
+
+## Ví dụ
+
+```svelte fileName="src/components/Sidebar.svelte"
+<script lang="ts">
+  import { usePathname } from "svelte-intlayer";
+
+  const links = [
+    { href: "/dashboard", label: "Bảng điều khiển" },
+    { href: "/settings", label: "Cài đặt" },
+  ];
+
+  const pathname = usePathname();
+</script>
+
+<nav>
+  {#each links as link}
+    <a
+      href={link.href}
+      style:font-weight={$pathname === link.href ? "bold" : "normal"}
+    >
+      {link.label}
+    </a>
+  {/each}
+</nav>
+```
+
+## Các tài liệu liên quan
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/svelte-intlayer/useLocale.md) — locale hiện tại + bộ chuyển đổi locale
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/intlayer/getPathWithoutLocale.md) — tiện ích nền tảng được sử dụng bởi hook này

package/docs/vi/packages/vue-intlayer/exports.md

@@ -14,6 +14,9 @@ slugs:
   - vue-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Thêm tiện ích usePathname"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Hợp nhất tài liệu cho tất cả các exports"
@@ -52,16 +55,17 @@ Import:
 import "vue-intlayer";
 ```
 
-| Composable             | Mô tả                                                                                                                | Tài liệu liên quan                                                                                                    |
-| ---------------------- | -------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
-| `useIntlayer`          | Dựa trên `useDictionary`, nhưng chèn một phiên bản tối ưu hóa của dictionary từ khai báo được sinh ra.               | -                                                                                                                     |
-| `useDictionary`        | Xử lý các object trông giống dictionary (key, content). Nó xử lý các bản dịch `t()`, enumerations, v.v.              | -                                                                                                                     |
-| `useDictionaryAsync`   | Tương tự `useDictionary`, nhưng xử lý các từ điển bất đồng bộ.                                                       | -                                                                                                                     |
-| `useDictionaryDynamic` | Tương tự `useDictionary`, nhưng xử lý các từ điển động.                                                              | -                                                                                                                     |
-| `useLocale`            | Trả về locale hiện tại và một hàm để thiết lập nó.                                                                   | -                                                                                                                     |
-| `useRewriteURL`        | Composable phía client để quản lý rewrite URL. Tự động cập nhật URL nếu tồn tại quy tắc rewrite đã được bản địa hóa. | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/vue-intlayer/useRewriteURL.md) |
-| `useIntl`              | Trả về đối tượng Intl cho locale hiện tại.                                                                           | -                                                                                                                     |
-| `useLoadDynamic`       | Composable để tải các từ điển động.                                                                                  | -                                                                                                                     |
+| Composable             | Mô tả                                                                                                                                        | Tài liệu liên quan                                                                                                    |
+| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`          | Dựa trên `useDictionary`, nhưng chèn một phiên bản tối ưu hóa của dictionary từ khai báo được sinh ra.                                       | -                                                                                                                     |
+| `useDictionary`        | Xử lý các object trông giống dictionary (key, content). Nó xử lý các bản dịch `t()`, enumerations, v.v.                                      | -                                                                                                                     |
+| `useDictionaryAsync`   | Tương tự `useDictionary`, nhưng xử lý các từ điển bất đồng bộ.                                                                               | -                                                                                                                     |
+| `useDictionaryDynamic` | Tương tự `useDictionary`, nhưng xử lý các từ điển động.                                                                                      | -                                                                                                                     |
+| `useLocale`            | Trả về locale hiện tại và một hàm để thiết lập nó.                                                                                           | -                                                                                                                     |
+| `usePathname`          | Trả về pathname hiện tại dưới dạng `ComputedRef<string>` với phân đoạn locale đã bị xóa. Có tính phản ứng (reactive) với sự kiện `popstate`. | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/vue-intlayer/usePathname.md)     |
+| `useRewriteURL`        | Composable phía client để quản lý rewrite URL. Tự động cập nhật URL nếu tồn tại quy tắc rewrite đã được bản địa hóa.                         | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/vue-intlayer/useRewriteURL.md) |
+| `useIntl`              | Trả về đối tượng Intl cho locale hiện tại.                                                                                                   | -                                                                                                                     |
+| `useLoadDynamic`       | Composable để tải các từ điển động.                                                                                                          | -                                                                                                                     |
 
 ### Hàm
 

package/docs/vi/packages/vue-intlayer/usePathname.md

@@ -0,0 +1,109 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Tài liệu hàm usePathname | vue-intlayer
+description: Tìm hiểu cách sử dụng hàm usePathname từ gói vue-intlayer
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Đa ngôn ngữ (Internationalization)
+  - Tài liệu
+  - Vue
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - vue-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Thêm tiện ích usePathname"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "Khởi tạo lịch sử"
+author: aymericzip
+---
+
+# Tích hợp Vue: Tài liệu `usePathname`
+
+Hàm `usePathname` trả về pathname của trình duyệt hiện tại đã được loại bỏ phân đoạn locale, dưới dạng một `ComputedRef<string>` của Vue. Điều này rất hữu ích khi xây dựng điều hướng nhận biết locale — ví dụ: để xác định mục điều hướng nào đang hoạt động — mà không cần phải cắt bỏ tiền tố locale một cách thủ công.
+
+## Nhập (Import) `usePathname` trong Vue
+
+```typescript
+import { usePathname } from "vue-intlayer";
+```
+
+## Tổng quan
+
+`usePathname` tạo một computed ref trong Vue. Nó đọc `window.location.pathname`, loại bỏ tiền tố locale thông qua `getPathWithoutLocale` và cập nhật giá trị của nó mỗi khi trình duyệt kích hoạt sự kiện `popstate` (điều hướng quay lại/tiến tới). Giá trị này có thể được sử dụng trực tiếp trong các template Vue hoặc các hàm setup của bạn.
+
+## Cách sử dụng
+
+```vue fileName="src/components/NavItem.vue"
+<script setup lang="ts">
+import { usePathname } from "vue-intlayer";
+
+const props = defineProps<{
+  href: string;
+  label: string;
+}>();
+
+const pathname = usePathname();
+</script>
+
+<template>
+  <a :href="href" :aria-current="pathname === href ? 'page' : undefined">
+    {{ label }}
+  </a>
+</template>
+```
+
+## Giá trị trả về
+
+| Kiểu                  | Mô tả                                                                                  |
+| --------------------- | -------------------------------------------------------------------------------------- |
+| `ComputedRef<string>` | Vue Computed Ref chứa pathname hiện tại của trình duyệt nhưng không có tiền tố locale. |
+
+## Hành vi
+
+- **Loại bỏ Locale**: Cắt bỏ phân đoạn locale ở đầu URL (ví dụ: `/vi/dashboard` → `/dashboard`).
+- **Phản ứng (Reactive)**: Cập nhật giá trị vào mỗi sự kiện `popstate` (trình duyệt điều hướng quay lại / tiến lên).
+- **An toàn cho SSR**: Trả về `""` khi không có `window`.
+- **Dọn dẹp (Cleanup)**: Trình lắng nghe `popstate` được thêm vào ở phạm vi toàn cục (globally) khi khởi tạo và thường không yêu cầu dọn dẹp thủ công trên mỗi component, nhờ vào cách Vue quản lý vòng đời component.
+
+## Ví dụ
+
+```vue fileName="src/components/Sidebar.vue"
+<script setup lang="ts">
+import { usePathname } from "vue-intlayer";
+
+const links = [
+  { href: "/dashboard", label: "Bảng điều khiển" },
+  { href: "/settings", label: "Cài đặt" },
+];
+
+const pathname = usePathname();
+</script>
+
+<template>
+  <nav>
+    <a
+      v-for="link in links"
+      :key="link.href"
+      :href="link.href"
+      :style="{ fontWeight: pathname === link.href ? 'bold' : 'normal' }"
+    >
+      {{ link.label }}
+    </a>
+  </nav>
+</template>
+```
+
+## Liên quan
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/vue-intlayer/useLocale.md) — locale hiện tại + bộ chuyển đổi locale
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/intlayer/getPathWithoutLocale.md) — tiện ích cốt lõi mà hook này đang sử dụng

package/docs/vi/releases/v6.md

@@ -25,6 +25,10 @@ author: aymericzip
 
 Chào mừng đến với Intlayer v6! Phiên bản này tập trung vào hiệu suất, trải nghiệm nhà phát triển và độ tin cậy. Dưới đây là những điểm nổi bật, kèm theo ghi chú di chuyển và ví dụ có thể sao chép-dán.
 
+## Mục lục
+
+<TOC levels={[2]} maxDepth={1} />
+
 ## Những điểm nổi bật
 
 - Lệnh mới: `npx intlayer content test` để phát hiện các bản dịch còn thiếu

package/docs/vi/releases/v7.md

@@ -25,6 +25,10 @@ author: aymericzip
 
 Chào mừng đến với Intlayer v7! Phiên bản lớn này giới thiệu các cải tiến đáng kể về hiệu suất, an toàn kiểu và trải nghiệm nhà phát triển. Dưới đây là những điểm nổi bật, kèm theo ghi chú di chuyển và ví dụ thực tiễn.
 
+## Mục lục
+
+<TOC levels={[2]} maxDepth={1} />
+
 ## Những điểm nổi bật
 
 - Chiến lược lưu bộ nhớ đệm để xây dựng nhanh hơn
@@ -260,6 +264,126 @@ Gói Trình chỉnh sửa trực quan đã được tối ưu hóa để nhỏ h
 
 ---
 
+## Định dạng Code Tự động: cấu hình formatCommand
+
+v7 giới thiệu tùy chọn `formatCommand` trong cấu hình editor, cho phép bạn tự động định dạng các tệp nội dung khi chúng được ghi bởi Intlayer. Điều này đảm bảo kiểu code và định dạng nhất quán trên các tệp khai báo nội dung của bạn.
+
+Nếu không được đặt, Intlayer sẽ cố gắng phát hiện lệnh định dạng tự động. Bằng cách cố gắng giải quyết các lệnh sau: prettier, biome, eslint.
+
+### Cấu hình
+
+Tùy chọn `formatCommand` chấp nhận một mẫu chuỗi trong đó `{{file}}` sẽ được thay thế bằng đường dẫn tệp thực tế:
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    formatCommand: 'bun x biome format "{{file}}" --write --log-level none',
+  },
+};
+```
+
+### Các formatter được hỗ trợ
+
+Bạn có thể sử dụng bất kỳ code formatter nào chấp nhận đường dẫn tệp làm đối số:
+
+**Sử dụng Biome:**
+
+```typescript
+formatCommand: 'bun x biome format "{{file}}" --write --log-level none';
+```
+
+**Sử dụng Prettier:**
+
+```typescript
+formatCommand: 'npx prettier --write "{{file}}" --log-level silent';
+```
+
+**Sử dụng ESLint:**
+
+```typescript
+formatCommand: 'npx eslint --fix "{{file}}" --quiet';
+```
+
+**Sử dụng built-in formatter của Bun:**
+
+```typescript
+formatCommand: 'bun format "{{file}}"';
+```
+
+### Lợi ích
+
+- **Định dạng nhất quán**: Tất cả các tệp nội dung được tự động định dạng theo các hướng dẫn kiểu dáng của dự án của bạn
+- **Trải nghiệm nhà phát triển**: Không cần phải định dạng tệp theo cách thủ công sau khi Intlayer ghi chúng
+- **Tính nhất quán của nhóm**: Đảm bảo tất cả các thành viên trong nhóm có cùng định dạng được áp dụng cho các tệp nội dung
+- **Tích hợp CI/CD**: Các tệp nội dung duy trì định dạng nhất quán trong các quy trình làm việc tự động
+
+### Cách hoạt động
+
+Khi Intlayer ghi hoặc cập nhật một tệp khai báo nội dung (`.content.ts`, `.content.js`, v.v.), nó tự động chạy lệnh định dạng được chỉ định trên tệp. Trình giữ chỗ `{{file}}` được thay thế bằng đường dẫn tệp thực tế và lệnh được thực thi trong thư mục cơ sở của dự án.
+
+---
+
+## Cấu hình Dictionary: Tổ chức và cấu trúc tốt hơn
+
+v7 giới thiệu một phần cấu hình `dictionary` mới được dành riêng cung cấp tổ chức tốt hơn cho các cài đặt liên quan đến dictionary và quản lý nội dung được cải thiện.
+
+### Cấu trúc cấu hình dictionary mới
+
+Thuộc tính `fill` đã được chuyển từ phần `content` sang phần `dictionary` mới, cung cấp sự tách biệt rõ ràng hơn về các mối quan tâm:
+
+**Cấu hình v6:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    autoFill: "./{{fileName}}.content.json",
+    contentDir: ["src"],
+  },
+};
+```
+
+**Cấu hình v7:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    contentDir: ["src"],
+  },
+  dictionary: {
+    fill: "./{{fileName}}.content.json",
+  },
+};
+```
+
+### Lợi ích của cấu trúc mới
+
+- **Tổ chức rõ ràng hơn**: Các cài đặt dành riêng cho từ điển hiện được nhóm lại với nhau
+- **Tách biệt mối quan tâm tốt hơn**: Khám phá nội dung và các hoạt động từ điển được tách biệt rõ ràng
+- **Khả năng bảo trì được cải thiện**: Dễ dàng hiểu và sửa đổi các cấu hình liên quan đến từ điển
+- **Khả năng mở rộng trong tương lai**: Phần từ điển có thể chứa các cài đặt dành riêng cho từ điển bổ sung
+- **Quản lý từ điển toàn diện**: Bao gồm các thuộc tính như `title`, `live`, `priority`, `tags`, `version` và `description` để tạo và quản lý các từ điển mới
+
+### Cách sử dụng cấu hình
+
+Cấu hình từ điển phục vụ hai mục đích chính:
+
+1. **Giá trị mặc định**: Xác định giá trị mặc định khi tạo các tệp khai báo nội dung
+2. **Hành vi dự phòng**: Cung cấp giá trị dự phòng khi các trường cụ thể không được xác định, cho phép bạn xác định hành vi hoạt động của từ điển một cách toàn cầu
+
+Phần từ điển bao gồm các thuộc tính toàn diện để quản lý từ điển:
+
+- **`fill`**: Hành vi tự động điền cho việc tạo nội dung
+- **`title`**: Tiêu đề mặc định cho các từ điển mới
+- **`live`**: Cấu hình đồng bộ hóa trực tiếp cho các bản cập nhật theo thời gian thực
+- **`priority`**: Cài đặt ưu tiên để phân giải từ điển
+- **`tags`**: Thẻ mặc định để tổ chức nội dung
+- **`version`**: Quản lý phiên bản cho các bản cập nhật từ điển
+- **`description`**: Mô tả mặc định cho nội dung mới
+
+Để biết thêm thông tin về các tệp khai báo nội dung và cách áp dụng các giá trị cấu hình, hãy xem [Tài liệu tệp nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md).
+
+---
+
 ## Lệnh fill: Hành vi cập nhật để quản lý nội dung tốt hơn
 
 Phiên bản v7 giới thiệu hành vi cải tiến cho lệnh `fill`, cung cấp quản lý nội dung linh hoạt và dễ dự đoán hơn:
@@ -407,6 +531,10 @@ Hệ thống tự động:
 - **`middleware.prefixDefault`**: Thay thế bằng `routing.mode`
 - **`middleware.noPrefix`**: Thay thế bằng `routing.mode`
 
+### Cấu hình mới
+
+- **`editor.formatCommand`**: Tùy chọn mới để tự động định dạng mã trong các tệp nội dung
+
 ### Bản đồ di chuyển
 
 #### Bản đồ cấu hình

package/docs/vi/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-14
+updatedAt: 2026-06-23
 title: Intlayer v9 Mới - Có gì mới?
 description: Khám phá các tính năng mới trong Intlayer v9. Giới thiệu các package tương thích drop-in cho các thư viện i18n phổ biến và hỗ trợ Collections, Variants, và Dynamic Records.
 keywords:
@@ -216,6 +216,42 @@ Tại build time, `@intlayer/swc` và `@intlayer/babel` sẽ quét các file c
 
 ---
 
+## Vite Plugin: Bundled Compiler & Proxy
+
+Plugin Vite `intlayer()` hiện đóng gói **compiler** và **locale-routing proxy** trực tiếp, vì vậy hầu hết các dự án chỉ cần một plugin duy nhất trong `vite.config.ts`:
+
+```ts fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+- **Compiler**: Kích hoạt tự động khi `compiler.enabled` được đặt và một đường dẫn `compiler.output` được cấu hình. Bạn không còn cần phải đăng ký `intlayerCompiler()` riêng biệt.
+- **Proxy**: Kích hoạt tự động dựa trên tùy chọn `routing.enableProxy` mới (`true` theo mặc định). Nó kết nối middleware phát hiện ngôn ngữ / chuyển hướng / ghi đè trong phát triển, xem trước và SSR sản xuất. Bạn không còn cần phải đăng ký `intlayerProxy()` riêng biệt.
+
+### Tùy chọn `routing.enableProxy`
+
+Một tùy chọn `routing.enableProxy` mới kiểm soát xem proxy định tuyến locale có được cắm vào hay không. Nó mặc định là `true`. Vô hiệu hóa nó khi bạn muốn xử lý định tuyến locale của riêng mình:
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  routing: {
+    enableProxy: false, // Mặc định: true
+  },
+};
+
+export default config;
+```
+
+Các plugin độc lập `intlayerCompiler()` và `intlayerProxy()` vẫn được xuất cho các cài đặt nâng cao. Đăng ký chúng cùng với `intlayer()` là an toàn — mỗi plugin loại bỏ chính nó và chỉ chạy một lần.
+
+---
+
 ## Lưu ý khi migration từ v8
 
 Nếu bạn đang nâng cấp từ v8, lưu ý rằng v9 không bao gồm các breaking change. Tuy nhiên, dưới đây là các thay đổi chính:

package/docs/zh/CI_CD.md

@@ -28,7 +28,7 @@ Intlayer 允许自动生成内容声明文件的翻译。根据您的工作流
 
 ## 使用 CMS
 
-使用 Intlayer，您可以采用一种工作流程，只在本地声明单一语言环境，而所有翻译内容则通过 CMS 远程管理。这使内容和翻译完全脱离代码库，为内容编辑者提供更大的灵活性，并支持热内容重载（无需重建应用即可应用更改）。
+使用 Intlayer，你可以采用一种工作流程，其中只需在本地声明单一语言环境，而所有翻译都通过 CMS 远程管理。这允许内容和翻译与代码库完全分离，为内容编辑提供更多灵活性，并支持 Live Sync（无需重新构建应用程序即可应用更改）。
 
 ### 示例配置
 

package/docs/zh/autoFill.md

@@ -28,6 +28,53 @@ history:
 author: aymericzip
 ---
 
+# 填充内容声明文件翻译
+
+**在 CI 中自动填充内容声明文件**是加快开发工作流程的一种方式。
+
+## 理解行为
+
+`fill` 命令包括两种模式：
+
+- **Complete**: 自动为每个区域设置填充所有缺失的内容，并编辑当前文件或指定的另一个文件。也就是说，完整模式将跳过已翻译内容的翻译。
+- **Review**: 自动为每个区域设置填充**所有**内容，并为特定文件或指定的另一个文件生成。
+
+fill 命令将处理您的所有区域内容声明文件。也就是说，它不会处理来自 CMS 的远程内容。CMS 包含其自己的翻译管理。
+如果您使用插件，如 `@intlayer/sync-json-plugin`，Intlayer 将把 JSON 文件转换为区域内容声明文件。也就是说，它们将由 `fill` 命令处理。
+
+新生成的文件包含一个 `filled` 指令作为字典元数据。此指令将由 Intlayer 用来判断文件是否已自动填充，以及如果存在则跳过此文件不再进行翻译。
+
+Intlayer 还将考虑以下自动填充指令：
+
+- 来自您的 `.content.{ts|js|json}` → `fill` 指令
+- 来自您的配置文件 `.intlayer.config.ts` → `dictionary.fill` 指令
+- 否则将默认设置为 `true`
+
+对于按区域设置的内容声明文件，`true` 指令将被替换为 `./{{fileName}}.fill.content.json`。这是因为按区域设置的内容声明文件无法接收额外的本地化内容。因此它将生成一个新文件，以不覆盖现有文件。
+
+## 默认行为
+
+默认情况下，`fill` 全局设置为 `true`，这意味着 Intlayer 将自动填充所有内容文件并编辑文件本身。这个行为可以通过以下几种方式自定义：
+
+### 全局配置选项
+
+1. **`fill: true` (默认)** - 自动填充所有语言并编辑当前文件
+2. **`fill: false`** - 禁用此内容文件的自动填充
+3. **`fill: "./relative/path/to/file"`** - 创建/更新指定的文件，不编辑当前文件，指向基于当前文件位置解析的相对路径
+4. **`fill: "/absolute/path/to/file"`** - 创建/更新指定的文件，不编辑当前文件，指向基于基目录位置解析的相对路径（配置文件 `.intlayer.config.ts` 中的 `baseDir` 字段）
+5. **`fill: "C:\\absolute\path\to\file"`** - 创建/更新指定的文件，不编辑当前文件，指向基于你的操作系统解析的绝对路径
+6. **`fill: { [key in Locales]?: string }`** - 为每个语言创建/更新指定的文件
+
+### v7 行为更改
+
+在 v7 中，`fill` 命令的行为已更新：
+
+- **`fill: true`** - 使用所有语言的已填充内容重写当前文件
+- **`fill: "path/to/file"`** - 填充指定文件而不修改当前文件
+- **`fill: false`** - 完全禁用自动填充
+
+使用路径选项写入另一个文件时，填充机制通过内容声明文件之间的 _主从_ 关系工作。主（master）文件作为真实来源，当它被更新时，Intlayer 将自动将这些更改应用到由路径指定的派生（填充）声明文件。
+
 # 自动填充内容声明文件翻译
 
 **自动填充内容声明文件** 是加快开发工作流程的一种方式。
@@ -88,6 +135,40 @@ Intlayer 将自动生成派生的声明文件，路径为 `src/components/exampl
 
 之后，这两个声明文件将合并为一个字典，可以通过标准的 `useIntlayer("example")` 钩子（React）或组合函数（Vue）访问。
 
+## 全局配置
+
+您可以在 `intlayer.config.ts` 文件中配置全局自动填充配置。
+
+```ts fileName="intlayer.config.ts"
+import { type IntlayerConfig, Locales } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+    requiredLocales: [Locales.ENGLISH, Locales.FRENCH],
+  },
+  dictionary: {
+    // 为所有字典自动生成缺失的翻译
+    fill: "./{{fileName}}Filled.content.ts",
+    //
+    // fill: "/messages/{{locale}}/{{key}}/{{fileName}}.content.json",
+    //
+    // fill: true, // 为所有字典自动生成缺失的翻译，如使用 "./{{fileName}}.content.json"
+    //
+    // fill: {
+    //   en: "./{{fileName}}.en.content.json",
+    //   fr: "./{{fileName}}.fr.content.json",
+    //   es: "./{{fileName}}.es.content.json",
+    // },
+  },
+};
+
+export default config;
+```
+
+您仍然可以使用内容文件中的 `fill` 字段按字典进行微调。Intlayer 将首先考虑每个字典的配置，然后回退到全局配置。
+
 ## 自动填充文件格式
 
 推荐的自动填充声明文件格式是 **JSON**，这有助于避免格式限制。然而，Intlayer 也支持 `.ts`、`.js`、`.mjs`、`.cjs` 及其他格式。

package/docs/zh/benchmark/solid.md

@@ -117,6 +117,28 @@ history:
 - **分层静态 (Scoped static)**: 保持代码有序（逻辑分离），无需复杂的额外网络请求。
 - **分层动态 (Scoped dynamic)**: _代码拆分_ 和性能的最佳方法。通过仅加载当前视图和活动语言所需的内容来最小化内存使用。
 
+### 我测量的内容：
+
+我在实际浏览器中为每个技术栈运行相同的多语言应用，然后记录了实际显示的内容和花费的时间。大小是在**正常 Web 压缩后**报告的，因为这更接近人们下载的内容，而不是原始源代码计数。
+
+- **国际化库大小**：在捆绑、树形摇晃和最小化后，i18n 库的大小是空组件中提供程序 + hooks/基元代码的大小。它不包括加载翻译文件。它回答了在您的内容进入之前库的成本。
+
+- **每页 JavaScript**：对于每个基准测试路由，浏览器在该访问中提取的脚本量，在套件中的页面之间平均（以及在报告汇总的语言之间）。沉重的页面是缓慢的页面。
+
+- **来自其他语言的泄漏**：这是同一页面但以另一种语言显示的内容，会被错误地加载到已审核页面中。此内容是不必要的，应该避免。（例如 `/fr/about` 页面内容在 `/en/about` 页面包中）
+
+- **来自其他路由的泄漏**：对于应用中的**其他屏幕**也是相同的概念：当您只打开一个页面时，它们的副本是否会随之而来。（例如 `/en/about` 页面内容在 `/en/contact` 页面包中）。高分数表示分割较弱或包过于宽泛。
+
+- **平均组件包大小**：常见的 UI 部分被**一次一个**测量，而不是隐藏在一个巨大的应用数字中。它显示国际化是否悄悄地增加了日常组件的大小。例如，如果您的组件重新渲染，它将从内存加载所有该数据。将一个巨大的 JSON 附加到任何组件就像连接一个大量未使用数据的仓库，这会减慢您组件的性能。
+
+- **语言切换响应性**：我使用应用自己的控件翻转语言，并计时直到页面明显切换需要多长时间，这是访问者会注意到的，而不是实验室微步骤。
+
+- **语言更改后的渲染工作**：一个更狭隘的后续：界面为新语言重新绘制需要花费多少工作量，一旦切换进行中。当"感知"时间和框架成本不同时很有用。
+
+- **初始页面加载时间**：从导航到浏览器认为页面对我测试的场景完全加载。适合比较冷启动。
+
+- **水合时间**：当应用公开它时，客户端花费多长时间将服务器 HTML 转换为您实际可以点击的内容。表格中的破折号表示该实现在此基准测试中没有提供可靠的水合数据。
+
 ## GitHub 星数
 
 GitHub 星数是项目受欢迎程度、社区信任和长期相关性的有力指标。虽然星数不是技术质量的直接衡量标准，但它们反映了有多少开发人员发现该项目有用、关注其进展并可能采用它。在评估项目价值时，星数有助于比较不同方案的吸引力，并提供对生态系统增长的见解。

package/docs/zh/benchmark/svelte.md

@@ -116,6 +116,28 @@ history:
 - **分层静态 (Scoped static)**: 保持代码有序（逻辑分离），无需复杂的额外网络请求。
 - **分层动态 (Scoped dynamic)**: _代码拆分_ 和性能的最佳方法。通过仅加载当前视图和活动语言所需的内容来最小化内存使用。
 
+### 我测量了什么:
+
+我在真实浏览器中为每个栈运行相同的多语言应用，然后记录了实际在网络上显示的内容以及花费的时间。大小报告是**在正常网络压缩后**的，因为这比原始源代码计数更接近人们实际下载的内容。
+
+- **国际化库大小**：在打包、tree-shaking 和 minification 之后，i18n 库的大小是空组件中提供程序 + 存储代码的大小。它不包括翻译文件的加载。它回答了库在你的内容进入之前有多昂贵的问题。
+
+- **每页 JavaScript**：对于每个基准测试路由，浏览器在该访问中拉取多少脚本，在套件中的页面之间平均（以及在报告汇总的区域设置之间）。页面重则加载慢。
+
+- **其他区域设置的泄漏**：同一页面的内容但以另一种语言形式，会被错误地加载到审核页面中。此内容是不必要的，应该避免。（例如 `/fr/about` 页面内容出现在 `/en/about` 页面包中）
+
+- **其他路由的泄漏**：对于**应用中的其他屏幕**也是同样的想法：当你只打开一个页面时，它们的副本是否会被带入。（例如 `/en/about` 页面内容出现在 `/en/contact` 页面包中）。高分数表示分割较弱或包范围过宽。
+
+- **平均组件包大小**：常见的 UI 组件**一次一个**地测量，而不是隐藏在一个巨大的应用数字中。它展示了国际化是否悄悄地膨胀了日常组件。例如，如果你的组件重新渲染，它会从内存中加载所有这些数据。将一个巨大的 JSON 附加到任何组件就像连接一个大的未使用数据存储，这会减慢你的组件性能。
+
+- **语言切换响应性**：我使用应用自身的控件翻转语言，并计时直到页面清晰地切换为止，这是访问者会注意到的，而不是实验室微步骤。
+
+- **语言更改后的渲染工作**：一个更窄的后续跟进：一旦切换进行中，界面为新语言重新绘制花费了多少工作量。在"感受"时间和框架成本不一致时很有用。
+
+- **初始页面加载时间**：从导航到浏览器认为我测试的场景中的页面完全加载。适合比较冷启动。
+
+- **Hydration 时间**：当应用暴露它时，客户端花费多长时间将服务器 HTML 转换为你实际可以点击的内容。表格中的破折号表示该实现在此基准测试中没有提供可靠的 hydration 数字。
+
 ## GitHub 星数
 
 GitHub 星数是项目受欢迎程度、社区信任和长期相关性的有力指标。虽然星数不是技术质量的直接衡量标准，但它们反映了有多少开发人员发现该项目有用、关注其进展并可能采用它。在评估项目价值时，星数有助于比较不同方案的吸引力，并提供对生态系统增长的见解。