@intlayer/docs 7.5.7 → 7.5.9

package/docs/vi/intlayer_with_vite+solid.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2025-06-29
-title: Cách dịch ứng dụng Vite và Solid của bạn – Hướng dẫn i18n 2025
+updatedAt: 2025-12-30
+title: Cách dịch ứng dụng Vite và Solid của bạn – Hướng dẫn i18n 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
@@ -16,6 +16,9 @@ slugs:
   - vite-and-solid
 # applicationTemplate: https://github.com/aymericzip/intlayer-vite-solid-template
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Thêm lệnh init
   - version: 5.5.10
     date: 2025-06-29
     changes: Khởi tạo lịch sử
@@ -53,16 +56,25 @@ Cài đặt các gói cần thiết bằng npm:
 ```bash packageManager="npm"
 npm install intlayer solid-intlayer
 npm install vite-intlayer --save-dev
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer solid-intlayer
 pnpm add vite-intlayer --save-dev
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer solid-intlayer
 yarn add vite-intlayer --save-dev
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer solid-intlayer
+bun add vite-intlayer --dev
+bunx intlayer init
 ```
 
 - **intlayer**

package/docs/vi/intlayer_with_vite+svelte.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2025-11-19
-title: Cách dịch ứng dụng Vite và Svelte của bạn – Hướng dẫn i18n 2025
+updatedAt: 2025-12-30
+title: Cách dịch ứng dụng Vite và Svelte của bạn – Hướng dẫn i18n 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
@@ -16,6 +16,9 @@ slugs:
   - vite-and-svelte
 applicationTemplate: https://github.com/aymericzip/intlayer-vite-svelte-template
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Thêm lệnh init
   - version: 5.5.11
     date: 2025-11-19
     changes: Cập nhật tài liệu
@@ -62,21 +65,25 @@ Cài đặt các gói cần thiết bằng npm:
 ```bash packageManager="npm"
 npm install intlayer svelte-intlayer
 npm install vite-intlayer --save-dev
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer svelte-intlayer
 pnpm add vite-intlayer --save-dev
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer svelte-intlayer
 yarn add vite-intlayer --save-dev
+yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer svelte-intlayer
 bun add vite-intlayer --save-dev
+bunx intlayer init
 ```
 
 - **intlayer**
@@ -302,14 +309,17 @@ Trước tiên, cài đặt `svelte-spa-router`:
 
 ```bash packageManager="npm"
 npm install svelte-spa-router
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add svelte-spa-router
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add svelte-spa-router
+yarn intlayer init
 ```
 
 ```bash packageManager="bun"

package/docs/vi/intlayer_with_vite+vue.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2025-06-29
-title: Cách dịch ứng dụng Vite và Vue của bạn – hướng dẫn i18n 2025
+updatedAt: 2025-12-30
+title: Cách dịch ứng dụng Vite và Vue của bạn – hướng dẫn i18n 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
@@ -17,6 +17,9 @@ slugs:
 applicationTemplate: https://github.com/aymericzip/intlayer-vite-vue-template
 youtubeVideo: https://www.youtube.com/watch?v=IE3XWkZ6a5U
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Thêm lệnh init
   - version: 5.5.10
     date: 2025-06-29
     changes: Khởi tạo lịch sử
@@ -71,16 +74,25 @@ Cài đặt các gói cần thiết bằng npm:
 ```bash packageManager="npm"
 npm install intlayer vue-intlayer
 npm install vite-intlayer --save-dev
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer vue-intlayer
 pnpm add vite-intlayer --save-dev
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer vue-intlayer
 yarn add vite-intlayer --save-dev
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer vue-intlayer
+bun add vite-intlayer --dev
+bunx intlayer init
 ```
 
 - **intlayer**
@@ -586,10 +598,12 @@ Trước tiên, cài đặt Vue Router:
 
 ```bash packageManager="npm"
 npm install vue-router
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add vue-router
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"

package/docs/zh/cli/index.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2025-12-30
 title: CLI
 description: 了解如何使用 Intlayer CLI 来管理您的多语言网站。按照本在线文档中的步骤，几分钟内即可设置您的项目。
 keywords:
@@ -17,6 +17,9 @@ slugs:
   - concept
   - cli
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: 添加 init 命令
   - version: 7.2.3
     date: 2025-11-22
     changes: 添加 transform 命令
@@ -78,6 +81,10 @@ yarn add intlayer-cli -g
 pnpm add intlayer-cli -g
 ```
 
+```bash packageManager="bun"
+bun add intlayer-cli -g
+```
+
 > 如果已经安装了 `intlayer` 包，CLI 会自动安装。你可以跳过这一步。
 
 ## intlayer-cli 包
@@ -127,6 +134,7 @@ Intlayer 支持多种配置文件格式：
 
 ### 配置
 
+- **[初始化 Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/init.md)** - 在您的项目中通过自动配置设置 Intlayer
 - **[管理配置](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/configuration.md)** - 获取并推送您的 Intlayer 配置到 CMS
 
 ### 文档管理
@@ -153,6 +161,7 @@ Intlayer 支持多种配置文件格式：
 
 ```json fileName="package.json"
 "scripts": {
+  "intlayer:init": "npx intlayer init",
   "intlayer:login": "npx intlayer login",
   "intlayer:build": "npx intlayer build",
   "intlayer:watch": "npx intlayer build --watch",

package/docs/zh/cli/init.md

@@ -0,0 +1,84 @@
+---
+createdAt: 2025-12-30
+updatedAt: 2025-12-30
+title: 初始化 Intlayer
+description: 了解如何在项目中初始化 Intlayer。
+keywords:
+  - 初始化
+  - CLI
+  - Intlayer
+  - AI
+slugs:
+  - doc
+  - concept
+  - cli
+  - init
+history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: 添加 init 命令
+---
+
+# 初始化 Intlayer
+
+```bash
+npx intlayer init
+```
+
+`init` 命令会自动在你的项目中设置 Intlayer，配置必要的文件和设置。这是开始使用 Intlayer 的推荐方式。
+
+## 别名：
+
+- `npx intlayer init`
+
+## 参数：
+
+- `--project-root [projectRoot]` - 可选。指定项目根目录。如果未提供，命令将从当前工作目录开始向上搜索项目根目录。
+
+## 它会执行以下操作：
+
+`init` 命令执行以下设置任务：
+
+1. **验证项目结构** - 确保你位于包含 `package.json` 文件的有效项目目录中
+2. **更新 `.gitignore`** - 将 `.intlayer` 添加到你的 `.gitignore` 文件中，以将生成的文件排除在版本控制之外
+3. **配置 TypeScript** - 更新所有 `tsconfig.json` 文件以包含 Intlayer 类型定义（`.intlayer/**/*.ts`）
+4. **创建配置文件** - 生成带有默认设置的 `intlayer.config.ts`（用于 TypeScript 项目）或 `intlayer.config.mjs`（用于 JavaScript 项目）
+5. **更新 Vite 配置** - 如果检测到 Vite 配置文件，则添加 `vite-intlayer` 插件的导入
+6. **更新 Next.js 配置** - 如果检测到 Next.js 配置文件，则添加 `next-intlayer` 插件的导入
+
+## 示例：
+
+### 基本初始化：
+
+```bash
+npx intlayer init
+```
+
+这将在当前目录初始化 Intlayer，自动检测项目根目录。
+
+### 使用自定义项目根目录初始化：
+
+```bash
+npx intlayer init --project-root ./my-project
+```
+
+这将在指定目录初始化 Intlayer。
+
+## 示例输出：
+
+```bash
+npx intlayer init
+Checking Intlayer configuration...
+✓ Added .intlayer to .gitignore
+✓ Updated tsconfig.json to include intlayer types
+Created intlayer.config.ts
+✓ Injected import into vite.config.ts
+✓ Intlayer init setup complete.
+```
+
+## 注意事项：
+
+- 该命令是幂等的 - 可以安全地多次运行。它会跳过已配置的步骤。
+- 如果配置文件已存在，则不会被覆盖。
+- 如果 TypeScript 配置文件没有 `include` 数组（例如带 references 的 solution 样式配置），则会被跳过。
+- 如果在项目根目录未找到 `package.json`，命令将以错误退出。

package/docs/zh/cli/sdk.md

@@ -31,6 +31,10 @@ yarn add @intlayer/cli --save-dev
 pnpm add @intlayer/cli --save-dev
 ```
 
+```bash packageManager="bun"
+bun add @intlayer/cli --dev
+```
+
 使用示例：
 
 ```ts

package/docs/zh/intlayer_visual_editor.md

@@ -80,6 +80,10 @@ yarn add intlayer-editor --save-dev
 pnpm add intlayer-editor --save-dev
 ```
 
+```bash packageManager="bun"
+bun add intlayer-editor --dev
+```
+
 ## 配置
 
 在您的 Intlayer 配置文件中，您可以自定义编辑器设置：

package/docs/zh/intlayer_with_angular.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2025-06-29
-title: 如何翻译您的Angular应用 – i18n指南 2025
+updatedAt: 2025-12-30
+title: 如何翻译您的Angular应用 – i18n指南 2026
 description: 了解如何使您的Angular网站实现多语言支持。按照文档进行国际化（i18n）和翻译。
 keywords:
   - 国际化
@@ -15,6 +15,9 @@ slugs:
   - angular
 # applicationTemplate: https://github.com/aymericzip/intlayer-angular-template
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: 添加 init 命令
   - version: 5.5.10
     date: 2025-06-29
     changes: 初始化历史
@@ -47,14 +50,22 @@ history:
 
 ```bash packageManager="npm"
 npm install intlayer angular-intlayer @intlayer/webpack
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer angular-intlayer @intlayer/webpack
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer angular-intlayer @intlayer/webpack
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer angular-intlayer @intlayer/webpack
+bunx intlayer init
 ```
 
 - **intlayer**

package/docs/zh/intlayer_with_astro.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-03-07
-updatedAt: 2025-10-03
-title: 如何翻译您的Astro应用 – i18n指南 2025
+updatedAt: 2025-12-30
+title: 如何翻译您的Astro应用 – i18n指南 2026
 description: 学习如何使用 Intlayer 为您的 Astro 网站添加国际化（i18n）。按照本指南使您的网站支持多语言。
 keywords:
   - 国际化
@@ -17,6 +17,9 @@ slugs:
   - astro
 applicationTemplate: https://github.com/aymericzip/intlayer-astro-template
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: 添加 init 命令
   - version: 6.2.0
     date: 2025-10-03
     changes: 针对 Astro 集成、配置和使用进行了更新

package/docs/zh/intlayer_with_create_react_app.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-06-29
-title: 如何翻译您的Create React App应用 – i18n指南 2025
+updatedAt: 2025-12-30
+title: 如何翻译您的Create React App应用 – i18n指南 2026
 description: 了解如何使您的 Create React App (CRA) 网站实现多语言。请遵循文档进行国际化（i18n）和翻译。
 keywords:
   - 国际化
@@ -17,6 +17,9 @@ slugs:
   - create-react-app
 applicationTemplate: https://github.com/aymericzip/intlayer-react-cra-template
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: 添加 init 命令
   - version: 5.5.10
     date: 2025-06-29
     changes: 初始化历史记录
@@ -45,14 +48,22 @@ history:
 
 ```bash packageManager="npm"
 npm install intlayer react-intlayer react-scripts-intlayer
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer react-intlayer react-scripts-intlayer
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer react-intlayer react-scripts-intlayer
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer react-intlayer react-scripts-intlayer
+bunx intlayer init
 ```
 
 - **intlayer**

package/docs/zh/intlayer_with_express.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-06-29
-title: 如何翻译您的Express backend应用 – i18n指南 2025
+updatedAt: 2025-12-30
+title: 如何翻译您的Express backend应用 – i18n指南 2026
 description: 了解如何使您的 Express 后端实现多语言。请遵循文档进行国际化（i18n）和翻译。
 keywords:
   - 国际化
@@ -15,6 +15,9 @@ slugs:
   - environment
   - express
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: 添加 init 命令
   - version: 5.5.10
     date: 2025-06-29
     changes: 初始化历史
@@ -48,14 +51,22 @@ history:
 
 ```bash packageManager="npm"
 npm install intlayer express-intlayer
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer express-intlayer
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer express-intlayer
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer express-intlayer
+bunx intlayer init
 ```
 
 ### 配置

package/docs/zh/intlayer_with_lynx+react.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-03-09
-updatedAt: 2025-06-29
-title: 如何翻译您的Lynx and React mobile app应用 – i18n指南 2025
+updatedAt: 2025-12-30
+title: 如何翻译您的Lynx and React mobile app应用 – i18n指南 2026
 description: 了解如何使您的使用 Lynx 和 React 的移动应用实现多语言。请遵循文档进行国际化（i18n）和翻译。
 keywords:
   - 国际化
@@ -17,6 +17,9 @@ slugs:
   - lynx-and-react
 applicationTemplate: https://github.com/aymericzip/intlayer-lynx-template
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: 添加 init 命令
   - version: 5.5.10
     date: 2025-06-29
     changes: 初始化历史
@@ -45,14 +48,22 @@ history:
 
 ```bash packageManager="npm"
 npm install intlayer react-intlayer lynx-intlayer
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer react-intlayer lynx-intlayer
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer react-intlayer lynx-intlayer
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer react-intlayer lynx-intlayer
+bunx intlayer init
 ```
 
 ### 包说明

package/docs/zh/intlayer_with_nestjs.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2025-09-09
-title: 如何翻译您的Nest backend应用 – i18n指南 2025
+updatedAt: 2025-12-30
+title: 如何翻译您的Nest backend应用 – i18n指南 2026
 description: 了解如何使你的 NestJS 后端支持多语言。按照文档进行国际化（i18n）和翻译。
 keywords:
   - 国际化
@@ -17,6 +17,9 @@ slugs:
 applicationTemplate: https://github.com/AydinTheFirst/nestjs-intlayer
 author: AydinTheFirst
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: 添加 init 命令
   - version: 5.8.0
     date: 2025-09-09
     changes: 初始文档
@@ -59,14 +62,22 @@ nest new my-nest-app
 
 ```bash packageManager="npm"
 npm install intlayer express-intlayer
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer express-intlayer
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer express-intlayer
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer express-intlayer
+bunx intlayer init
 ```
 
 ### 配置 tsconfig.json

package/docs/zh/intlayer_with_next-i18next.md

@@ -57,6 +57,10 @@ pnpm add next-i18next i18next react-i18next i18next-resources-to-backend
 yarn add next-i18next i18next react-i18next i18next-resources-to-backend
 ```
 
+```bash packageManager="bun"
+bun add next-i18next i18next react-i18next i18next-resources-to-backend
+```
+
 从清晰的结构开始。保持消息按语言环境和命名空间分开。
 
 ```bash
@@ -554,14 +558,22 @@ Intlayer 帮助你保持 JSON 翻译同步，测试缺失的键，并在需要
 
 ```bash packageManager="npm"
 npm install intlayer @intlayer/sync-json-plugin --save-dev
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer @intlayer/sync-json-plugin --save-dev
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer @intlayer/sync-json-plugin --dev
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer @intlayer/sync-json-plugin --dev
+bunx intlayer init
 ```
 
 ```ts fileName="intlayer.config.ts"

package/docs/zh/intlayer_with_next-intl.md

@@ -52,6 +52,10 @@ pnpm add next-intl
 yarn add next-intl
 ```
 
+```bash packageManager="bun"
+bun add next-intl
+```
+
 ```bash
 .
 ├── locales
@@ -404,6 +408,11 @@ yarn add intlayer @intlayer/sync-json-plugin --dev
 pnpm add intlayer @intlayer/sync-json-plugin --save-dev
 ```
 
+```bash packageManager="bun"
+bun add intlayer @intlayer/sync-json-plugin --dev
+bunx intlayer init
+```
+
 创建 intlayer 配置文件：
 
 ```tsx fileName="intlayer.config.ts"

package/docs/zh/intlayer_with_nextjs_14.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-06
-updatedAt: 2025-06-29
-title: 如何翻译您的Next.js 14 and App Router应用 – i18n指南 2025
+updatedAt: 2025-12-30
+title: 如何翻译您的Next.js 14 and App Router应用 – i18n指南 2026
 description: 了解如何使你的 Next.js 14 App Router 网站支持多语言。按照文档进行国际化（i18n）和翻译。
 keywords:
   - 国际化
@@ -17,6 +17,9 @@ slugs:
   - 14
 applicationTemplate: https://github.com/aymericzip/intlayer-next-14-template
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: 添加 init 命令
   - version: 5.5.10
     date: 2025-06-29
     changes: 初始化历史
@@ -50,14 +53,22 @@ history:
 
 ```bash packageManager="npm"
 npm install intlayer next-intlayer
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer next-intlayer
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer next-intlayer
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer next-intlayer
+bunx intlayer init
 ```
 
 - **intlayer**
@@ -1418,14 +1429,22 @@ Link.displayName = 'Link';
 
 ```bash packageManager="npm"
 npm install @intlayer/swc --save-dev
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add @intlayer/swc --save-dev
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add @intlayer/swc --save-dev
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add @intlayer/swc --dev
+bunx intlayer init
 ```
 
 > 注意：此优化仅适用于 Next.js 13 及以上版本。