@intlayer/docs 9.3.0 → 9.3.2

package/docs/zh-TW/eslint.md

@@ -0,0 +1,336 @@
+---
+createdAt: 2026-08-12
+updatedAt: 2026-08-12
+title: ESLint 外掛 | Intlayer 的 Lint 規則
+description: 使用 eslint-plugin-intlayer 捕捉硬編碼字串、Intlayer 編譯器無法最佳化的動態呼叫以及未使用的字典內容。支援 ESLint 與 oxlint，適用於 React、Vue、Svelte、Angular 與 Astro。
+keywords:
+  - Intlayer
+  - ESLint
+  - oxlint
+  - 程式碼檢查
+  - i18n
+  - 國際化
+  - no-raw-text
+  - 硬編碼字串
+  - 未使用的翻譯
+  - 死內容
+  - React
+  - Vue
+  - Svelte
+  - Angular
+slugs:
+  - doc
+  - eslint
+history:
+  - version: 9.3.1
+    date: 2026-08-12
+    changes: "初始化歷史"
+author: aymericzip
+---
+
+# ESLint x OXLint 外掛
+
+`eslint-plugin-intlayer` 能夠捕捉 TypeScript 無法發現的幾類 i18n 錯誤：
+
+1. **硬編碼文字**：從未寫入字典中的文字。
+2. **動態呼叫**：能夠通過型別檢查並正常執行，但 Intlayer 編譯器無法進行最佳化的呼叫。
+3. **死內容（Dead content）**：專案中沒有任何地方讀取的字典與欄位（需手動開啟）。
+
+未知的字典鍵、未知的欄位路徑與缺失的語系本身已是編譯錯誤，因此外掛不會重複回報它們。
+
+## 安裝
+
+```bash packageManager="npm"
+npm install --save-dev eslint-plugin-intlayer
+```
+
+```bash packageManager="pnpm"
+pnpm add --save-dev eslint-plugin-intlayer
+```
+
+```bash packageManager="yarn"
+yarn add --dev eslint-plugin-intlayer
+```
+
+需要 ESLint 9 或更高版本（Flat config）。
+
+## 使用方法
+
+此外掛可在 ESLint 與 [oxlint](https://oxc.rs) 中執行 — 擁有相同的規則與設定選項。
+
+<Tabs defaultTab="eslint">
+  <Tab label="ESLint" value="eslint">
+
+```javascript fileName="eslint.config.mjs" codeFormat="esm"
+import intlayer from "eslint-plugin-intlayer";
+
+export default [...intlayer.configs.recommended];
+```
+
+或者逐一啟用規則：
+
+```javascript fileName="eslint.config.mjs" codeFormat="esm"
+import intlayer from "eslint-plugin-intlayer";
+
+export default [
+  {
+    plugins: { intlayer },
+    rules: {
+      "intlayer/no-raw-text": "warn",
+      "intlayer/static-dictionary-key": "error",
+      "intlayer/no-dynamic-field-access": "error",
+      "intlayer/enforce-adapter-import": "warn",
+      "intlayer/no-unused-content": "warn",
+    },
+  },
+];
+```
+
+  </Tab>
+  <Tab label="oxlint" value="oxlint">
+
+```json fileName=".oxlintrc.json"
+{
+  "jsPlugins": ["eslint-plugin-intlayer"],
+  "rules": {
+    "intlayer/no-raw-text": "warn",
+    "intlayer/static-dictionary-key": "error",
+    "intlayer/no-dynamic-field-access": "error",
+    "intlayer/enforce-adapter-import": "warn"
+  }
+}
+```
+
+兩點注意事項：oxlint 對 JS 外掛的支援仍處於 Alpha 階段，且 oxlint 不支援自訂解析器 — 因此 `.vue`、`.svelte`、`.astro` 與 Angular 範本無法在此處進行 lint。請在 JS/TS/JSX 檔案上執行 oxlint，其餘檔案保留使用 ESLint。
+
+上面特意排除了 `no-unused-content`：它需要從規則上下文中取得工作目錄與被檢查檔案的路徑，而 Alpha 階段的 JS 外掛橋接層無法保證提供這些資訊。請在 ESLint 下執行該規則。
+
+  </Tab>
+</Tabs>
+
+### 預設設定
+
+| 設定            | `no-raw-text`           | `static-dictionary-key` | `no-dynamic-field-access` | `enforce-adapter-import` | `no-unused-content` |
+| --------------- | ----------------------- | ----------------------- | ------------------------- | ------------------------ | ------------------- |
+| `recommended`   | warn                    | error                   | error                     | off                      | off                 |
+| `strict`        | error (+ 非 JSX 字面量) | error                   | error                     | error                    | off                 |
+| `contract-only` | off                     | error                   | error                     | off                      | off                 |
+
+`recommended` 特意將 `no-raw-text` 設為 `warn`：將其指向現有程式碼庫會一次性暴露所有未翻譯的字串，這不應該在第一天就導致建置中斷。
+
+`enforce-adapter-import` 預設關閉 — 如果需要請明確啟用。
+
+`no-unused-content` 在所有設定中均預設關閉（包含 `strict`）。這是唯一一個需要讀取 Intlayer 設定並從磁碟遍歷來源檔案的規則，因此啟用它應當是一項經過深思熟慮的選擇，而非預設自動執行的行為。
+
+## 規則列表
+
+### `no-raw-text`
+
+回報未在字典中宣告的面向使用者文字。它使用與 `intlayer extract` 相同的偵測邏輯，因此品牌名稱、CSS 類別名稱與技術識別碼都會被忽略。
+
+```jsx
+// ✗ 回報錯誤
+<h1>Welcome to our documentation</h1>
+<input placeholder="Enter your email address" />
+
+// ✓ 正常
+const { title } = useIntlayer("home");
+<h1>{title}</h1>
+```
+
+內容宣告檔案（`*.content.ts`, …）會被略過。
+
+若要一次性修復整個檔案，執行 `npx intlayer extract`，讓編譯器自動將字串移入字典。
+
+**設定選項**
+
+```javascript fileName="eslint.config.mjs" codeFormat="esm"
+{
+  "intlayer/no-raw-text": [
+    "warn",
+    {
+      // 值為面向使用者文字的屬性列表。
+      // 預設值: title, placeholder, alt, aria-label, label
+      attributes: ["title", "placeholder", "alt", "aria-label", "label"],
+
+      // 內容絕非面向使用者文字的元素列表。
+      // 預設值: code, pre, script, style
+      ignoreElements: ["code", "pre", "script", "style"],
+
+      // 絕不回報的文字正規表示式。
+      ignorePatterns: ["^Powered by"],
+
+      // 是否同時回報標記語言之外的字串字面量。預設值: false
+      includeStringLiterals: false,
+    },
+  ],
+}
+```
+
+### `static-dictionary-key`
+
+要求字典鍵必須是字串字面量。
+
+編譯器只有在呼叫位置直接讀取到鍵時，才能預先載入字典。使用計算鍵會無訊息略過最佳化，轉而打包所有字典。
+
+```typescript
+// ✗ 回報錯誤
+useIntlayer(dictionaryKey);
+useIntlayer(`home-${suffix}`);
+getTranslations({ namespace: page });
+
+// ✗ 變數仍然不是字面量
+const key = "home";
+useIntlayer(key);
+
+// ✓ 正常
+useIntlayer("home");
+getTranslations({ namespace: "home" });
+```
+
+這適用於 `useIntlayer`、`getIntlayer` 以及所有相容介面卡（`useTranslation`、`useTranslations`、`formatMessage`、`<FormattedMessage id>`、`<Trans i18nKey>` 等）。
+
+### `no-dynamic-field-access`
+
+要求從字典中讀取的欄位必須是靜態已知的。
+
+編譯器會移除它未偵測到使用的欄位。動態計算存取對其不可見，因此該讀取在執行階段可能會回傳 `undefined`。
+
+```typescript
+// ✗ 回報錯誤
+const content = useIntlayer("home");
+content[fieldName];
+
+const t = useTranslations("home");
+t(messageKey);
+
+// ✓ 正常
+content.title;
+content["title"];
+content.items[0];
+t("hero.title");
+```
+
+### `enforce-adapter-import`
+
+優先使用 `@intlayer/*` 相容介面卡而非原始套件。原始套件僅在設定了打包工具別名時才會解析為 Intlayer；而介面卡始終生效。可透過 `--fix` 自動修復。
+
+```typescript
+// ✗ 回報錯誤
+import { useTranslation } from "react-i18next";
+import { getTranslations } from "next-intl/server";
+
+// ✓ 正常
+import { useTranslation } from "@intlayer/react-i18next";
+import { getTranslations } from "@intlayer/next-intl/server";
+```
+
+### `no-unused-content`
+
+**預設關閉。** 回報專案中沒有任何地方讀取的內容，以及在多個位置宣告的字典鍵。
+
+```typescript fileName="src/home.content.ts"
+export default {
+  key: "home", // ✗ 當專案中沒有任何呼叫端請求 "home" 時回報
+  content: {
+    title: t({ "zh-TW": "標題", en: "Title" }),
+
+    // ✗ 當沒有任何地方讀取 `hero` 時回報
+    hero: {
+      subtitle: t({ "zh-TW": "副標題", en: "Subtitle" }),
+    },
+  },
+};
+```
+
+與其他規則不同，此規則無法僅憑眼前的檔案給出判斷 — 欄位是否未使用僅相對於整個專案而言。在一次 lint 執行的首次內容宣告時，它會載入你的 Intlayer 設定，比對該設定宣告的來源檔案（`build.traversePattern`、`compiler.transformPattern`），並執行驅動 `@intlayer/lsp` 與 VS Code 擴充套件中「未使用」刪除線的同一套使用情況分析器。結果會快取 `cacheTtl` 毫秒，因此每次執行只會掃描一次，而不是每個檔案掃描一次。
+
+**設定選項**
+
+```javascript fileName="eslint.config.mjs" codeFormat="esm"
+{
+  "intlayer/no-unused-content": [
+    "warn",
+    {
+      // 回報沒有任何地方引用的字典鍵。預設值: true
+      reportUnusedDictionaries: true,
+
+      // 回報沒有任何地方讀取的內容欄位。預設值: true
+      reportUnusedFields: true,
+
+      // 回報在多處宣告的重複鍵。預設值: true
+      reportDuplicateKeys: true,
+
+      // 絕不回報的欄位路徑正規表示式。
+      ignoreFields: ["^meta"],
+
+      // 掃描起始的專案根目錄。預設值: ESLint 的工作目錄
+      baseDir: process.cwd(),
+
+      // 專案掃描結果重複使用時長（毫秒）。預設值: 30000
+      cacheTtl: 30000,
+    },
+  ],
+}
+```
+
+如果你在長期執行的編輯器服務中進行 lint 且希望更快看到修改結果，可以降低 `cacheTtl`；當單次 lint 執行跨越 monorepo 中的多個 Intlayer 專案時，請設定 `baseDir`。
+
+> **傾向於保持沉默。** 此處的誤報會導致翻譯被誤刪，因此當字典以分析器無法追蹤的方式被使用時，不會回報任何內容：內容物件被整體傳遞、從中繫結的翻譯函式（`const t = useTranslations("home")`）、透過直接匯入存取的宣告（`useDictionary(myDictionary)`）、來自另一個字典的 `nest()`、或者因 spread 展開而不詳盡的欄位列表。單一檔案元件（`.vue`、`.svelte`、`.astro`）計為使用了它們提及的字典中的所有欄位，因為它們的指令碼區塊在此處不會被解析。
+
+`reportDuplicateKeys` 讀取建置時寫入 `.intlayer/` 下的未合併字典，因此在專案至少建置過一次之前它會保持安靜。共享一個鍵的兩個宣告會被合併，這是一種合法的模式 — 該回報之所以存在，是因為在兩邊同時定義的欄位會無訊息保留兩個值中的一個。
+
+分析器從以 ESM 形式發布的 `@intlayer/lsp` 中載入。因此該規則需要能夠 `require()` ES 模組的 Node 版本 — Node 20.19+ 或 22.12+。在更低版本上，它不會回報錯誤中斷 lint 執行，而是什麼都不回報。
+
+## 框架支援
+
+每條規則均適用於所有 Intlayer 整合，包含 Vue、Svelte 與 Angular 範本內部。你只需告訴 ESLint 哪個解析器負責讀取對應的檔案類型即可。
+
+| 框架                      | 檔案              | 解析器                            |
+| ------------------------- | ----------------- | --------------------------------- |
+| React, Preact, Solid, Lit | `.jsx` `.tsx`     | `typescript-eslint`               |
+| Next.js                   | `.jsx` `.tsx`     | `typescript-eslint`               |
+| Vue, Nuxt                 | `.vue`            | `vue-eslint-parser`               |
+| Svelte, SvelteKit         | `.svelte`         | `svelte-eslint-parser`            |
+| Angular                   | `.ts`             | `typescript-eslint`               |
+| Angular 範本              | `.component.html` | `@angular-eslint/template-parser` |
+| Astro                     | `.astro`          | `astro-eslint-parser`             |
+
+```javascript fileName="eslint.config.mjs" codeFormat="esm"
+import intlayer from "eslint-plugin-intlayer";
+import tseslint from "typescript-eslint";
+import vueParser from "vue-eslint-parser";
+import svelteParser from "svelte-eslint-parser";
+import angularTemplateParser from "@angular-eslint/template-parser";
+
+export default [
+  ...intlayer.configs.recommended,
+
+  {
+    files: ["**/*.{ts,tsx,jsx}"],
+    languageOptions: { parser: tseslint.parser },
+  },
+  {
+    files: ["**/*.vue"],
+    languageOptions: {
+      parser: vueParser,
+      parserOptions: { parser: tseslint.parser },
+    },
+  },
+  {
+    files: ["**/*.svelte"],
+    languageOptions: {
+      parser: svelteParser,
+      parserOptions: { parser: tseslint.parser },
+    },
+  },
+  {
+    files: ["**/*.component.html"],
+    languageOptions: { parser: angularTemplateParser },
+  },
+];
+```
+
+請僅安裝專案所需的解析器。
+
+> **已知限制。** 在 Vue 與 Angular 範本中，類似於 `{{ content[key] }}` 的運算式不會被 `no-dynamic-field-access` 檢查。寫在 script 區塊中的動態讀取仍會被正常捕捉。

package/docs/zh-TW/interest_of_intlayer.md

@@ -188,7 +188,7 @@ export const ComponentExample = () => {
 這種方法允許你：
 
 1. **提高開發速度**
-   - 可以使用 VSCode 插件創建 `.content.{{ts|mjs|cjs|json}}` 文件
+   - 可以使用 VSCode 插件創建 `.content.{ts|js|mjs|cjs|json|tsx|jsx|md|mdx|yaml|yml}` 文件
    - IDE 中的 AI 自動補全工具（例如 GitHub Copilot）可以幫助你宣告內容，減少複製/粘貼
 
 2. **保持代码庫的整潔**
@@ -212,27 +212,27 @@ export const ComponentExample = () => {
 
 ## Intlayer 附加功能
 
-| 功能                                                                                                                      | 描述                                                                                                                                                                                                                                                                                                                                                      |
-| ------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true)                          | **跨框架支持**<br><br>Intlayer 兼容所有主流框架和庫，包括 Next.js, React, Vite, Vue.js, Nuxt, Preact, Express 等。                                                                                                                                                                                                                                        |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.jpg?raw=true)       | **JavaScript 驅動的內容管理**<br><br>利用 JavaScript 的靈活性來高效地定義和管理你的內容。<br><br> - [內容宣告](https://intlayer.org/doc/concept/content)                                                                                                                                                                                                  |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/compiler.jpg?raw=true" alt="Feature" width="700">  | **編譯器**<br><br>Intlayer 編譯器可自動从組件中提取內容并生成字典文件。<br><br> - [編譯器](https://intlayer.org/doc/compiler)                                                                                                                                                                                                                             |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true) | **單語言內容宣告文件**<br><br>在自動生成前，通過僅宣告一次你的內容來加速開發。<br><br> - [單語言內容宣告文件](https://intlayer.org/doc/concept/per-locale-file)                                                                                                                                                                                           |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)                      | **類型安全環境**<br><br>利用 TypeScript 確保你的內容定義和代码沒有錯誤，同時還能享受 IDE 的自動補全功能。<br><br> - [TypeScript 配置](https://intlayer.org/doc/environment/vite-and-react#configure-typescript)                                                                                                                                           |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true)                         | **簡易配置**<br><br>僅需極簡的配置即可快速啟動并運行。輕鬆調整國際化、路由、AI、構築以及內容處理的設置。<br><br> - [探索 Next.js 集成](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                       |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/content_retrieval.png?raw=true)                   | **簡化內容檢索**<br><br>無需為每一小段內容調用 `t` 函數。使用單一的 hook 即可直接檢索你的所有內容。<br><br> - [React 集成](https://intlayer.org/doc/environment/create-react-app)                                                                                                                                                                         |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/server_component.png?raw=true)                    | **一致的服務器組件實現**<br><br>完美適合 Next.js 服務器組件，客戶端和服務器組件使用相同的實現，無需跨每个服務器組件傳遞你的 `t` 函數。<br><br> - [服務器組件](https://intlayer.org/doc/environment/nextjs#step-7-utilize-content-in-your-code)                                                                                                            |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/file_tree.png?raw=true)                           | **有條理的代码庫**<br><br>保持代码庫更有條理：1 組件 = 在同一文件夾下的 1 個字典。靠近其各自組件的翻譯有助於提高可維護性和清晰度。<br><br> - [Intlayer 運行機制](https://intlayer.org/doc/concept/how-works-intlayer)                                                                                                                                     |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/url_routing.png?raw=true)                         | **增強的路由功能**<br><br>完全支持應用路由，無縫適應複雜的應用結構，適用於 Next.js, React, Vite, Vue.js 等。<br><br> - [探索 Next.js 集成](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                   |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/markdown.png?raw=true)                            | **Markdown 支持**<br><br>導入并解譯本地文件以及遠程 Markdown，以獲得隱私政策、文檔等多語言內容。解譯并在你的代码中使 Markdown 元數據可被訪問。<br><br> - [內容文件](https://intlayer.org/doc/concept/content/file)                                                                                                                                        |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.png?raw=true)                       | **免費的可視化編輯器與 CMS**<br><br>視覺編輯器和 CMS 免費向內容創作者開放，消除对第三方本地化平台的依賴。使用 Git 保持內容同步，或使用 CMS 徹底或部分外置管理它。<br><br> - [Intlayer 編輯器](https://intlayer.org/doc/concept/editor) <br> - [Intlayer CMS](https://intlayer.org/doc/concept/cms)                                                        |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/bundle.png?raw=true)                              | **構築時搖樹優化 (Tree-shakable) 內容**<br><br>構築時搖樹優化內容，減小最終包的體積。按組件載入內容，并从打包體積中排除 any 未使用的內容。支持懶載入以提高應用載入效率。<br><br> - [應用構築優化](https://intlayer.org/doc/concept/how-works-intlayer#app-build-optimization)                                                                             |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/static_rendering.png?raw=true)                    | **靜態渲染**<br><br>不阻碍靜態渲染（Static Rendering）。<br><br> - [Next.js 集成](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                            |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/AI_translation.png?raw=true)                      | **AI 驅動翻譯**<br><br>使用您自己的 AI 提供商/API 金鑰，點擊一下即可將您的網站翻譯成 231 種語言，得益於 Intlayer 先進的 AI 翻譯工具。<br><br> - [CI/CD 集成](https://intlayer.org/doc/concept/ci-cd) <br> - [Intlayer CLI](https://intlayer.org/doc/concept/cli) <br> - [自動填充](https://intlayer.org/doc/concept/auto-fill)                            |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/mcp.png?raw=true)                                 | **MCP 服務器集成**<br><br>提供用於 IDE 自動化的 MCP（Model Context Protocol）服務器，能夠直接在你的開發環境中實現無縫的內容管理和 i18n 工作流。<br><br> - [MCP 服務器](https://github.com/aymericzip/intlayer/blob/main/docs/zh-TW/mcp_server.md)                                                                                                         |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vscode_extension.png?raw=true)                    | **VSCode 插件**<br><br>Intlayer 提供 VSCode 插件協助管理你的內容和翻譯，構築你的字典，翻譯你的內容等。<br><br> - [VSCode 插件](https://intlayer.org/doc/vs-code-extension)                                                                                                                                                                                |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/interoperability.png?raw=true)                    | **互操作性**<br><br>允許與 react-i18next、next-i18next, next-intl 和 react-intl 互操作。<br><br> - [Intlayer 與 react-intl](https://intlayer.org/blog/intlayer-with-react-intl) <br> - [Intlayer 與 next-intl](https://intlayer.org/blog/intlayer-with-next-intl) <br> - [Intlayer 與 next-i18next](https://intlayer.org/blog/intlayer-with-next-i18next) |
-| 測試缺失翻譯 (CLI/CI)                                                                                                     | ✅ CLI: npx intlayer content test (对 CI 友好的審計)                                                                                                                                                                                                                                                                                                      |
+| 功能                                                                                                                      | 描述                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true)                          | **跨框架支持**<br><br>Intlayer 兼容所有主流框架和庫，包括 Next.js, React, Vite, Vue.js, Nuxt, Preact, Express 等。                                                                                                                                                                                                                                                                                                             |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.jpg?raw=true)       | **JavaScript 驅動的內容管理**<br><br>利用 JavaScript 的靈活性來高效地定義和管理你的內容。<br><br> - [內容宣告](https://intlayer.org/doc/concept/content)                                                                                                                                                                                                                                                                       |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/compiler.jpg?raw=true" alt="Feature" width="700">  | **編譯器**<br><br>Intlayer 編譯器可自動从組件中提取內容并生成字典文件。<br><br> - [編譯器](https://intlayer.org/doc/compiler)                                                                                                                                                                                                                                                                                                  |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true) | **單語言內容宣告文件**<br><br>在自動生成前，通過僅宣告一次你的內容來加速開發。<br><br> - [單語言內容宣告文件](https://intlayer.org/doc/concept/per-locale-file)                                                                                                                                                                                                                                                                |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)                      | **類型安全環境**<br><br>利用 TypeScript 確保你的內容定義和代码沒有錯誤，同時還能享受 IDE 的自動補全功能。<br><br> - [TypeScript 配置](https://intlayer.org/doc/environment/vite-and-react#configure-typescript)                                                                                                                                                                                                                |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true)                         | **簡易配置**<br><br>僅需極簡的配置即可快速啟動并運行。輕鬆調整國際化、路由、AI、構築以及內容處理的設置。<br><br> - [探索 Next.js 集成](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                                            |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/content_retrieval.png?raw=true)                   | **簡化內容檢索**<br><br>無需為每一小段內容調用 `t` 函數。使用單一的 hook 即可直接檢索你的所有內容。<br><br> - [React 集成](https://intlayer.org/doc/environment/create-react-app)                                                                                                                                                                                                                                              |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/server_component.png?raw=true)                    | **一致的服務器組件實現**<br><br>完美適合 Next.js 服務器組件，客戶端和服務器組件使用相同的實現，無需跨每个服務器組件傳遞你的 `t` 函數。<br><br> - [服務器組件](https://intlayer.org/doc/environment/nextjs#step-7-utilize-content-in-your-code)                                                                                                                                                                                 |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/file_tree.png?raw=true)                           | **有條理的代码庫**<br><br>保持代码庫更有條理：1 組件 = 在同一文件夾下的 1 個字典。靠近其各自組件的翻譯有助於提高可維護性和清晰度。<br><br> - [Intlayer 運行機制](https://intlayer.org/doc/concept/how-works-intlayer)                                                                                                                                                                                                          |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/url_routing.png?raw=true)                         | **增強的路由功能**<br><br>完全支持應用路由，無縫適應複雜的應用結構，適用於 Next.js, React, Vite, Vue.js 等。<br><br> - [探索 Next.js 集成](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                                        |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/markdown.png?raw=true)                            | **Markdown 支持**<br><br>導入并解譯本地文件以及遠程 Markdown，以獲得隱私政策、文檔等多語言內容。解譯并在你的代码中使 Markdown 元數據可被訪問。<br><br> - [內容文件](https://intlayer.org/doc/concept/content/file)                                                                                                                                                                                                             |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.png?raw=true)                       | **免費的可視化編輯器與 CMS**<br><br>視覺編輯器和 CMS 免費向內容創作者開放，消除对第三方本地化平台的依賴。使用 Git 保持內容同步，或使用 CMS 徹底或部分外置管理它。<br><br> - [Intlayer 編輯器](https://intlayer.org/doc/concept/editor) <br> - [Intlayer CMS](https://intlayer.org/doc/concept/cms)                                                                                                                             |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/bundle.png?raw=true)                              | **構築時搖樹優化 (Tree-shakable) 內容**<br><br>構築時搖樹優化內容，減小最終包的體積。按組件載入內容，并从打包體積中排除 any 未使用的內容。支持懶載入以提高應用載入效率。<br><br> - [應用構築優化](https://intlayer.org/doc/concept/how-works-intlayer#app-build-optimization)                                                                                                                                                  |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/static_rendering.png?raw=true)                    | **靜態渲染**<br><br>不阻碍靜態渲染（Static Rendering）。<br><br> - [Next.js 集成](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                                                                                                 |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/AI_translation.png?raw=true)                      | **AI 驅動翻譯**<br><br>使用您自己的 AI 提供商/API 金鑰，點擊一下即可將您的網站翻譯成 231 種語言，得益於 Intlayer 先進的 AI 翻譯工具。<br><br> - [CI/CD 集成](https://intlayer.org/doc/concept/ci-cd) <br> - [Intlayer CLI](https://intlayer.org/doc/concept/cli) <br> - [自動填充](https://intlayer.org/doc/concept/auto-fill)                                                                                                 |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/mcp.png?raw=true)                                 | **MCP 服務器集成**<br><br>提供用於 IDE 自動化的 MCP（Model Context Protocol）服務器，能夠直接在你的開發環境中實現無縫的內容管理和 i18n 工作流。<br><br> - [MCP 服務器](https://github.com/aymericzip/intlayer/blob/main/docs/zh-TW/mcp_server.md)                                                                                                                                                                              |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vscode_extension.png?raw=true)                    | **VSCode 插件**<br><br>Intlayer 提供 VSCode 插件協助管理你的內容和翻譯，構築你的字典，翻譯你的內容等。<br><br> - [VSCode 插件](https://intlayer.org/doc/vs-code-extension)                                                                                                                                                                                                                                                     |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/interoperability.png?raw=true)                    | **互操作性**<br><br>允許與 react-i18next、next-i18next, next-intl 和 react-intl 互操作。<br><br> - [Intlayer 與 react-intl](https://intlayer.org/blog/intlayer-with-react-intl) <br> - [Intlayer 與 next-intl](https://intlayer.org/blog/intlayer-with-next-intl) <br> - [Intlayer 與 next-i18next](https://intlayer.org/blog/intlayer-with-next-i18next) <br> - [Intlayer 相容轉接器](https://intlayer.org/doc/compatibility) |
+| 測試缺失翻譯 (CLI/CI)                                                                                                     | ✅ CLI: npx intlayer content test (对 CI 友好的審計)                                                                                                                                                                                                                                                                                                                                                                           |
 
 ## Intlayer 與其他解決方案 of 比較
 
@@ -271,3 +271,5 @@ GitHub 星星數是衡量項目受歡迎程度、社區信任度以及長期相
 `intlayer` 還可以幫助管理你的 `react-intl`、`react-i18next`、`next-intl`、`next-i18next` 以及 `vue-i18n` 命名空間。
 
 使用 `intlayer`，你可以宣告你喜歡的 i18n 庫格式的內容，並且 intlayer 將在你想指定的路徑下生成命名空間（例如：`/messages/{{locale}}/{{namespace}}.json`）。
+
+如果你想繼續使用目前 i18n 函式庫的 API，`intlayer` 也提供 **相容轉接器（compat adapters）**：這些套件公開與 `react-i18next`、`next-intl`、`react-intl`、`vue-i18n` 等完全相同的 API，但內容由 Intlayer 字典提供。如此一來，你就能逐步遷移，而不需要重寫程式碼。請參閱[相容轉接器文件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/compat/index.md)。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/docs",
-  "version": "9.3.0",
+  "version": "9.3.2",
   "private": false,
   "description": "Intlayer documentation",
   "keywords": [
@@ -73,13 +73,13 @@
     "watch": "webpack --config ./webpack.config.ts --watch"
   },
   "dependencies": {
-    "@intlayer/config": "9.3.0",
-    "@intlayer/core": "9.3.0",
-    "@intlayer/types": "9.3.0"
+    "@intlayer/config": "9.3.2",
+    "@intlayer/core": "9.3.2",
+    "@intlayer/types": "9.3.2"
   },
   "devDependencies": {
-    "@intlayer/api": "9.3.0",
-    "@intlayer/cli": "9.3.0",
+    "@intlayer/api": "9.3.2",
+    "@intlayer/cli": "9.3.2",
     "@types/node": "26.2.0",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",

package/src/generated/docs.entry.ts

@@ -1485,6 +1485,26 @@ export const docsEntry = {
     vi: readLocale('dynamic_dictionaries/variants.md', 'vi'),
     uk: readLocale('dynamic_dictionaries/variants.md', 'uk'),
   } as unknown as Record<LocalesValues, Promise<string>>,
+  './docs/en/eslint.md': {
+    en: readLocale('eslint.md', 'en'),
+    es: readLocale('eslint.md', 'es'),
+    ru: readLocale('eslint.md', 'ru'),
+    ja: readLocale('eslint.md', 'ja'),
+    fr: readLocale('eslint.md', 'fr'),
+    ko: readLocale('eslint.md', 'ko'),
+    zh: readLocale('eslint.md', 'zh'),
+    de: readLocale('eslint.md', 'de'),
+    ar: readLocale('eslint.md', 'ar'),
+    it: readLocale('eslint.md', 'it'),
+    'en-GB': readLocale('eslint.md', 'en-GB'),
+    pt: readLocale('eslint.md', 'pt'),
+    hi: readLocale('eslint.md', 'hi'),
+    tr: readLocale('eslint.md', 'tr'),
+    pl: readLocale('eslint.md', 'pl'),
+    id: readLocale('eslint.md', 'id'),
+    vi: readLocale('eslint.md', 'vi'),
+    uk: readLocale('eslint.md', 'uk'),
+  } as unknown as Record<LocalesValues, Promise<string>>,
   './docs/en/formatters.md': {
     en: readLocale('formatters.md', 'en'),
     es: readLocale('formatters.md', 'es'),