@intlayer/docs 8.3.0 → 8.3.2

package/docs/zh/intlayer_with_vite+svelte.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2025-12-30
+updatedAt: 2026-03-12
 title: Vite + Svelte i18n - 如何翻译Svelte 应用 2026
 description: 了解如何使您的 Vite 和 Svelte 网站支持多语言。按照文档进行国际化 (i18n) 和翻译。
 keywords:
@@ -498,8 +498,8 @@ const changeLocale = (event: Event) => {
 
 为此，您可以在 `.gitignore` 文件中添加以下指令：
 
-```plaintext
-# 忽略 Intlayer 生成的文件
+```bash
+#  忽略 Intlayer 生成的文件
 .intlayer
 ```
 
@@ -520,6 +520,162 @@ const changeLocale = (event: Event) => {
 
 ---
 
+### (可选) 步骤 1 : 提取组件内容
+
+如果您有现有的代码库，转换数千个文件可能会非常耗时。
+
+为了简化此过程，Intlayer 提出了 [编译器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compiler.md) / [提取器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/extract.md) 来转换您的组件并提取内容。
+
+要进行设置，您可以在 `intlayer.config.ts` 文件中添加 `compiler` 部分：
+
+```typescript fileName="intlayer.config.ts" codeFormat="typescript"
+import { type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  // ... 您的其他配置
+  compiler: {
+    /**
+     * 指示是否应启用编译器。
+     */
+    enabled: true,
+
+    /**
+     * 定义输出文件路径
+     */
+    output: ({ fileName, extension }) => `./${fileName}${extension}`,
+
+    /**
+     * 指示在转换后是否应保存组件。这样，编译器只需运行一次即可转换应用程序，然后即可将其删除。
+     */
+    saveComponents: false,
+
+    /**
+     * 字典键前缀
+     */
+    dictionaryKeyPrefix: "",
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.mjs" codeFormat="esm"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... 您的其他配置
+  compiler: {
+    /**
+     * 指示是否应启用编译器。
+     */
+    enabled: true,
+
+    /**
+     * 定义输出文件路径
+     */
+    output: ({ fileName, extension }) => `./${fileName}${extension}`,
+
+    /**
+     * 指示在转换后是否应保存组件。这样，编译器只需运行一次即可转换应用程序，然后即可将其删除。
+     */
+    saveComponents: false,
+
+    /**
+     * 字典键前缀
+     */
+    dictionaryKeyPrefix: "",
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... 您的其他配置
+  compiler: {
+    /**
+     * 指示是否应启用编译器。
+     */
+    enabled: true,
+
+    /**
+     * 定义输出文件路径
+     */
+    output: ({ fileName, extension }) => `./${fileName}${extension}`,
+
+    /**
+     * 指示在转换后是否应保存组件。这样，编译器只需运行一次即可转换应用程序，然后即可将其删除。
+     */
+    saveComponents: false,
+
+    /**
+     * 字典键前缀
+     */
+    dictionaryKeyPrefix: "",
+  },
+};
+
+module.exports = config;
+```
+
+<Tabs>
+ <Tab value='提取命令'>
+
+运行提取器以转换组件并提取内容
+
+```bash packageManager="npm"
+npx intlayer extract
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer extract
+```
+
+```bash packageManager="yarn"
+yarn intlayer extract
+```
+
+```bash packageManager="bun"
+bunx intlayer extract
+```
+
+ </Tab>
+ <Tab value='Babel 编译器'>
+
+更新您的 `vite.config.ts` 以包含 `intlayerCompiler` 插件：
+
+```ts fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer, intlayerCompiler } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [
+    intlayer(),
+    intlayerCompiler(), // 添加编译器插件
+  ],
+});
+```
+
+```bash packageManager="npm"
+npm run build # 或 npm run dev
+```
+
+```bash packageManager="pnpm"
+pnpm run build # 或 pnpm run dev
+```
+
+```bash packageManager="yarn"
+yarn build # 或 yarn dev
+```
+
+```bash packageManager="bun"
+bun run build # Or bun run dev
+```
+
+ </Tab>
+</Tabs>
+
 ### 深入了解
 
 要进一步提升，您可以实现[可视化编辑器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)或使用[CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md)将内容外部化。

package/docs/zh/intlayer_with_vite+vue.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2025-12-30
+updatedAt: 2026-03-12
 title: Vite + Vue i18n - 如何翻译Vue 应用 2026
 description: 了解如何使您的 Vite 和 Vue 网站支持多语言。按照文档进行国际化（i18n）和翻译。
 keywords:
@@ -55,7 +55,7 @@ history:
 <iframe
   src="https://stackblitz.com/github/aymericzip/intlayer-vite-vue-template?embed=1&ctl=1&file=intlayer.config.ts"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="Demo CodeSandbox - How to Internationalize your application using Intlayer"
+  title="Demo CodeSandbox - 如何使用 Intlayer 实现应用国际化"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />
@@ -1058,8 +1058,8 @@ Intlayer 使用模块增强来利用 TypeScript 的优势，使您的代码库
 
 为此，您可以在 `.gitignore` 文件中添加以下指令：
 
-```plaintext
-# 忽略 Intlayer 生成的文件
+```bash
+#  忽略 Intlayer 生成的文件
 .intlayer
 ```
 
@@ -1080,8 +1080,8 @@ Intlayer 使用模块增强来利用 TypeScript 的优势，使您的代码库
 
 为此，您可以在 `.gitignore` 文件中添加以下指令：
 
-```plaintext
-# 忽略由 Intlayer 生成的文件
+```bash
+#  忽略由 Intlayer 生成的文件
 .intlayer
 ```
 
@@ -1102,6 +1102,162 @@ Intlayer 使用模块增强来利用 TypeScript 的优势，使您的代码库
 
 ---
 
+### (可选) 步骤 1 : 提取组件内容
+
+如果您有现有的代码库，转换数千个文件可能会非常耗时。
+
+为了简化此过程，Intlayer 提出了 [编译器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compiler.md) / [提取器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/extract.md) 来转换您的组件并提取内容。
+
+要进行设置，您可以在 `intlayer.config.ts` 文件中添加 `compiler` 部分：
+
+```typescript fileName="intlayer.config.ts" codeFormat="typescript"
+import { type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  // ... 您的其他配置
+  compiler: {
+    /**
+     * 指示是否应启用编译器。
+     */
+    enabled: true,
+
+    /**
+     * 定义输出文件路径
+     */
+    output: ({ fileName, extension }) => `./${fileName}${extension}`,
+
+    /**
+     * 指示在转换后是否应保存组件。这样，编译器只需运行一次即可转换应用程序，然后即可将其删除。
+     */
+    saveComponents: false,
+
+    /**
+     * 字典键前缀
+     */
+    dictionaryKeyPrefix: "",
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.mjs" codeFormat="esm"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... 您的其他配置
+  compiler: {
+    /**
+     * 指示是否应启用编译器。
+     */
+    enabled: true,
+
+    /**
+     * 定义输出文件路径
+     */
+    output: ({ fileName, extension }) => `./${fileName}${extension}`,
+
+    /**
+     * 指示在转换后是否应保存组件。这样，编译器只需运行一次即可转换应用程序，然后即可将其删除。
+     */
+    saveComponents: false,
+
+    /**
+     * 字典键前缀
+     */
+    dictionaryKeyPrefix: "",
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... 您的其他配置
+  compiler: {
+    /**
+     * 指示是否应启用编译器。
+     */
+    enabled: true,
+
+    /**
+     * 定义输出文件路径
+     */
+    output: ({ fileName, extension }) => `./${fileName}${extension}`,
+
+    /**
+     * 指示在转换后是否应保存组件。这样，编译器只需运行一次即可转换应用程序，然后即可将其删除。
+     */
+    saveComponents: false,
+
+    /**
+     * 字典键前缀
+     */
+    dictionaryKeyPrefix: "",
+  },
+};
+
+module.exports = config;
+```
+
+<Tabs>
+ <Tab value='提取命令'>
+
+运行提取器以转换组件并提取内容
+
+```bash packageManager="npm"
+npx intlayer extract
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer extract
+```
+
+```bash packageManager="yarn"
+yarn intlayer extract
+```
+
+```bash packageManager="bun"
+bunx intlayer extract
+```
+
+ </Tab>
+ <Tab value='Babel 编译器'>
+
+更新您的 `vite.config.ts` 以包含 `intlayerCompiler` 插件：
+
+```ts fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer, intlayerCompiler } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [
+    intlayer(),
+    intlayerCompiler(), // 添加编译器插件
+  ],
+});
+```
+
+```bash packageManager="npm"
+npm run build # 或 npm run dev
+```
+
+```bash packageManager="pnpm"
+pnpm run build # 或 pnpm run dev
+```
+
+```bash packageManager="yarn"
+yarn build # 或 yarn dev
+```
+
+```bash packageManager="bun"
+bun run build # Or bun run dev
+```
+
+ </Tab>
+</Tabs>
+
 ### 深入了解
 
 要进一步使用，您可以实现 [可视化编辑器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md) 或使用 [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md) 来外部管理您的内容。

package/docs/zh/vs_code_extension.md

@@ -120,14 +120,14 @@ Intlayer 建议将您的 AI API 密钥，以及 Intlayer 客户端 ID 和密钥
 
 #### 选择活动环境
 
-- **命令面板**：打开命令面板并运行 `Intlayer: Select Environment`，然后选择环境（例如，`development`、`staging`、`production`）。扩展将尝试加载上述优先级列表中第一个可用的文件，并显示类似“已从 .env.<env>.local 加载环境”的通知。
+- **命令面板**：打开命令面板并运行 `Intlayer: Select Environment`，然后选择环境（例如，`development`、`staging`、`production`）。扩展将尝试加载上述优先级列表中第一个可用的文件，并显示类似“已从 `.env.<env>.local` 加载环境”的通知。
 - **设置**：进入 `设置 → 扩展 → Intlayer`，并设置：
   - **环境**：用于解析 `.env.<env>*` 文件的环境名称。
   - （可选）**环境文件**：显式指定一个 `.env` 文件路径。提供后，该路径优先于推断的列表。
 
 #### Monorepos 和自定义目录
 
-- **命令面板**：打开命令面板并运行 `Intlayer: Select Environment`，然后选择环境（例如，`development`、`staging`、`production`）。扩展将尝试加载上述优先列表中的第一个可用文件，并显示类似“已从 .env.<env>.local 加载环境”的通知。
+- **命令面板**：打开命令面板并运行 `Intlayer: Select Environment`，然后选择环境（例如，`development`、`staging`、`production`）。扩展将尝试加载上述优先列表中的第一个可用文件，并显示类似“已从 `.env.<env>.local` 加载环境”的通知。
 - **设置**：进入 `设置 → 扩展 → Intlayer`，并设置：
   - **环境**：用于解析 `.env.<env>*` 文件的环境名称。
   - （可选）**Env 文件**：显式指定一个 `.env` 文件路径。提供后，该路径优先于推断的列表。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/docs",
-  "version": "8.3.0",
+  "version": "8.3.2",
   "private": false,
   "description": "Intlayer documentation",
   "keywords": [
@@ -72,14 +72,14 @@
     "watch": "webpack --config ./webpack.config.ts --watch"
   },
   "dependencies": {
-    "@intlayer/config": "8.3.0",
-    "@intlayer/core": "8.3.0",
-    "@intlayer/types": "8.3.0"
+    "@intlayer/config": "8.3.2",
+    "@intlayer/core": "8.3.2",
+    "@intlayer/types": "8.3.2"
   },
   "devDependencies": {
-    "@intlayer/api": "8.3.0",
-    "@intlayer/cli": "8.3.0",
-    "@types/node": "25.4.0",
+    "@intlayer/api": "8.3.2",
+    "@intlayer/cli": "8.3.2",
+    "@types/node": "25.5.0",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",
     "@utils/tsdown-config": "1.0.4",
@@ -87,7 +87,7 @@
     "rimraf": "6.1.3",
     "tsdown": "0.21.2",
     "typescript": "5.9.3",
-    "vitest": "4.0.18"
+    "vitest": "4.1.0"
   },
   "engines": {
     "node": ">=14.18"

package/docs/update_docs.py

@@ -1,65 +0,0 @@
-import os
-import re
-
-locales = [
-    "ar", "de", "en", "en-GB", "es", "fr", "hi", "id", "it", "ja", "ko", "pl", "pt", "ru", "tr", "uk", "vi", "zh"
-]
-
-translations = {
-    "ar": {"cli_title": "الإعداد عبر واجهة سطر أوامر Intlayer (موصى به)"},
-    "de": {"cli_title": "Einrichtung über die Intlayer CLI (empfohlen)"},
-    "en": {"cli_title": "Setup via Intlayer CLI (recommended)"},
-    "en-GB": {"cli_title": "Setup via Intlayer CLI (recommended)"},
-    "es": {"cli_title": "Configuración a través de la CLI de Intlayer (recomendado)"},
-    "fr": {"cli_title": "Configuration via la CLI Intlayer (recommandé)"},
-    "hi": {"cli_title": "Intlayer CLI के माध्यम से सेटअप (अनुशंसित)"},
-    "id": {"cli_title": "Setup melalui CLI Intlayer (disarankan)"},
-    "it": {"cli_title": "Configurazione tramite la CLI di Intlayer (consigliata)"},
-    "ja": {"cli_title": "Intlayer CLI経由のセットアップ（推奨）"},
-    "ko": {"cli_title": "Intlayer CLI를 통한 설정 (권장)"},
-    "pl": {"cli_title": "Konfiguracja przez Intlayer CLI (zalecane)"},
-    "pt": {"cli_title": "Configuração via CLI do Intlayer (recomendado)"},
-    "ru": {"cli_title": "Настройка через Intlayer CLI (рекомендуется)"},
-    "tr": {"cli_title": "Intlayer CLI aracılığıyla kurulum (önerilen)"},
-    "uk": {"cli_title": "Налаштування через Intlayer CLI (рекомендовано)"},
-    "vi": {"cli_title": "Thiết lập qua Intlayer CLI (khuyên dùng)"},
-    "zh": {"cli_title": "通过 Intlayer CLI 设置（推荐）"}
-}
-
-base_dir = "/Users/aymericpineau/Documents/intlayer_/docs/docs"
-
-vsc_title = "## Setup via Intlayer VS Code extension"
-
-for lang in locales:
-    file_path = os.path.join(base_dir, lang, "mcp_server.md")
-    if not os.path.exists(file_path):
-        continue
-    
-    with open(file_path, "r", encoding="utf-8") as f:
-        content = f.read()
-    
-    # Update title as requested
-    # Standardize titles even if translated before, because user explicitly asked for English title specifically.
-    # Pattern to find the section and ensure its title is exactly as requested
-    content = re.sub(r"## (Using|Utilisation|Uso|Installation|Einrichtung|إعداد|सेटअप|Setup|でのセットアップ|에서 설정|Konfiguracja|Configuração|Настройка|Kurulum|Thiết lập|通过).*VS Code.*extension.*", "## Setup via Intlayer VS Code extension", content)
-    
-    # Standardize CLI titles too if they exist
-    trans = translations.get(lang)
-    if trans:
-        cli_pattern = r"## (Setup via Intlayer CLI|Configuration via la CLI Intlayer|Configuración a través de la CLI de Intlayer|Einrichtung über die Intlayer CLI|الإعداد عبر واجهة سطر أوامر|Intlayer CLI के माध्यम से|Setup attraverso la CLI|Intlayer CLI経由のセットアップ|Intlayer CLI를 통한 설정|Konfiguracja przez Intlayer CLI|Configuração via CLI|Настройка через Intlayer CLI|Intlayer CLI aracılığıyla|Налаштування через Intlayer CLI|Thiết lập qua Intlayer CLI|通过 Intlayer CLI 设置).*"
-        content = re.sub(cli_pattern, f"## {trans['cli_title']}", content)
-
-    # General updates
-    content = re.sub(r"updatedAt: \d{4}-\d{2}-\d{2}", "updatedAt: 2026-03-03", content)
-    content = re.sub(r"docs/docs/" + re.escape(lang) + r"/intlayer_cli\.md", "docs/docs/" + lang + "/cli/index.md", content)
-    
-    # Fix Claude Desktop JSON block extra brace issue for all
-    # Pattern to fix the double closure if it exists
-    # If the file has ...}\n}\n}\n```, change to ...}\n}\n}\n}\n``` if it was meant to be 4 deep?
-    # Actually, Claude Desktop config uses "mcpServers": { "intlayer": { ... } } so it needs 3 closing braces for the object + 1 for file?
-    # Usually: { "mcpServers": { "intlayer": { ... } } } - so 3 braces at the end.
-    
-    with open(file_path, "w", encoding="utf-8") as f:
-        f.write(content)
-
-print("Done")