@intlayer/docs 7.5.0-canary.0 → 7.5.0

package/docs/tr/intlayer_with_tanstack.md

@@ -60,7 +60,7 @@ Intlayer ile şunları yapabilirsiniz:
 <Tab defaultTab="video">
   <TabItem label="Video" value="video">
   
-<iframe title="Tanstack Start için en iyi i18n çözümü mü? Intlayer'ı keşfedin" 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/_XTdKVWaeqg?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
+<iframe title="Tanstack Start için en iyi i18n çözümü mü? Intlayer'ı keşfedin" 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/_XTdKVWaeqg?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
 
   </TabItem>
   <TabItem label="Code" value="code">

package/docs/tr/intlayer_with_vite+react.md

@@ -47,7 +47,7 @@ Intlayer ile şunları yapabilirsiniz:
 <Tab defaultTab="video">
   <TabItem label="Video" value="video">
   
-<iframe title="Vite ve React için en iyi i18n çözümü? Intlayer'ı keşfedin" 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?si=VaKmrYMmXjo3xpk2"/>
+<iframe title="Vite ve React için en iyi i18n çözümü? Intlayer'ı keşfedin" 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?si=VaKmrYMmXjo3xpk2"/>
 
   </TabItem>
   <TabItem label="Code" value="code">

package/docs/tr/intlayer_with_vite+vue.md

@@ -44,7 +44,7 @@ Intlayer ile şunları yapabilirsiniz:
 <Tab defaultTab="video">
   <TabItem label="Video" value="video">
   
-<iframe title="The best i18n solution for Vite and Vue? Discover 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/IE3XWkZ6a5U?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
+<iframe title="The best i18n solution for Vite and Vue? Discover 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/IE3XWkZ6a5U?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
 
   </TabItem>
   <TabItem label="Kod" value="code">

package/docs/tr/plugins/sync-json.md

@@ -34,7 +34,7 @@ history:
 
 # JSON Senkronizasyonu (i18n köprüleri) - ICU / i18next desteği ile JSON Senkronizasyonu
 
-<iframe title="JSON çevirilerinizi Intlayer ile nasıl senkronize tutarsınız" 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/MpGMxniDHNg?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
+<iframe title="JSON çevirilerinizi Intlayer ile nasıl senkronize tutarsınız" 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/MpGMxniDHNg?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
 
 Intlayer'ı mevcut i18n yapınıza bir eklenti olarak kullanın. Bu eklenti, JSON mesajlarınızı Intlayer sözlükleriyle senkronize tutar, böylece:
 

package/docs/vi/cli/index.md

@@ -103,6 +103,10 @@ Intlayer chấp nhận nhiều định dạng tệp cấu hình:
 
 ## Chạy các lệnh intlayer
 
+### Xác thực
+
+- **[Đăng nhập](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/login.md)** - Xác thực với Intlayer CMS và lấy thông tin đăng nhập
+
 ### Các Lệnh Cơ Bản
 
 - **[Xây dựng Từ điển](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/build.md)** - Xây dựng từ điển của bạn từ các tệp khai báo nội dung
@@ -144,6 +148,7 @@ Intlayer chấp nhận nhiều định dạng tệp cấu hình:
 
 ```json fileName="package.json"
 "scripts": {
+  "intlayer:login": "npx intlayer login",
   "intlayer:build": "npx intlayer build",
   "intlayer:watch": "npx intlayer build --watch",
   "intlayer:push": "npx intlayer push",

package/docs/vi/cli/login.md

@@ -0,0 +1,186 @@
+---
+createdAt: 2025-12-16
+updatedAt: 2025-12-16
+title: CLI - Đăng nhập
+description: Tìm hiểu cách sử dụng lệnh login của Intlayer CLI để xác thực với Intlayer CMS và lấy thông tin truy cập.
+keywords:
+  - CLI
+  - Login
+  - Authentication
+  - CMS
+  - Intlayer
+  - Credentials
+slugs:
+  - doc
+  - concept
+  - cli
+  - login
+---
+
+# Lệnh Login của Intlayer CLI
+
+---
+
+## Mô tả
+
+Lệnh `login` của Intlayer CLI cho phép bạn xác thực với Intlayer CMS. Lệnh này tự động mở trình duyệt mặc định của bạn để hoàn tất quá trình xác thực và nhận các thông tin xác thực cần thiết (Client ID và Client Secret) để sử dụng dịch vụ Intlayer.
+
+## Cách sử dụng
+
+```bash
+npx intlayer login [options]
+```
+
+hoặc
+
+```bash
+intlayer login [options]
+```
+
+## Tùy chọn
+
+### `--cms-url <url>`
+
+Chỉ định URL của Intlayer CMS để kết nối và thực hiện xác thực.
+
+- **Loại**: `string`
+- **Mặc định**: Giá trị cấu hình trong `intlayer.config.*` hoặc `https://intlayer.org`
+- **Ví dụ**:
+
+```bash
+npx intlayer login --cms-url https://intlayer.org
+```
+
+### Tùy chọn cấu hình
+
+Bạn cũng có thể sử dụng các tùy chọn cấu hình chung sau:
+
+- `--env-file <path>`: Đường dẫn tới file môi trường
+- `-e, --env <env>`: Môi trường thực thi
+- `--base-dir <dir>`: Thư mục gốc của dự án
+- `--verbose`: Bật đầu ra chi tiết (mặc định: true)
+- `--prefix <prefix>`: Tiền tố cho logs
+
+## Cách hoạt động
+
+1. **Khởi động máy chủ cục bộ**: Lệnh khởi động một máy chủ HTTP cục bộ trên một cổng ngẫu nhiên để nhận thông tin xác thực từ CMS
+
+Chỉ định URL của Intlayer CMS để kết nối xác thực.
+
+- **Loại**: `string`
+- **Mặc định**: Giá trị được cấu hình trong `intlayer.config.*` hoặc `https://intlayer.org`
+- **Ví dụ**:
+
+```bash
+npx intlayer login --cms-url https://intlayer.org
+```
+
+### Tùy chọn cấu hình
+
+Bạn cũng có thể sử dụng các tùy chọn cấu hình chung:
+
+- `--env-file <path>`: Đường dẫn tới file môi trường
+- `-e, --env <env>`: Môi trường thực thi
+- `--base-dir <dir>`: Thư mục gốc của dự án
+- `--verbose`: Bật hiển thị chi tiết (mặc định: true)
+- `--prefix <prefix>`: Tiền tố cho các log
+
+## Cách hoạt động
+
+1. **Khởi động máy chủ cục bộ**: Lệnh khởi động một HTTP server cục bộ trên một cổng ngẫu nhiên để nhận thông tin xác thực từ CMS
+2. **Mở trình duyệt**: Lệnh tự động mở trình duyệt mặc định của bạn tới URL đăng nhập của CMS
+3. **Xác thực**: Hoàn tất xác thực trong trình duyệt bằng tài khoản Intlayer của bạn
+4. **Nhận thông tin xác thực**: Máy chủ cục bộ nhận Client ID và Client Secret từ CMS
+5. **Hướng dẫn**: Lệnh hiển thị hướng dẫn để cấu hình thông tin xác thực trong dự án của bạn
+
+## Đầu ra
+
+Sau khi đăng nhập thành công, lệnh sẽ hiển thị:
+
+1. **Thông tin xác thực nhận được** (Client ID và Client Secret)
+2. **Hướng dẫn cho file `.env`**:
+
+```bash
+INTLAYER_CLIENT_ID=your_client_id
+INTLAYER_CLIENT_SECRET=your_client_secret
+```
+
+3. **Hướng dẫn cho file cấu hình Intlayer**:
+
+```typescript
+{
+  editor: {
+    cmsURL: 'https://intlayer.org',
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+  },
+}
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+  },
+}
+```
+
+## Cấu hình thủ công
+
+Nếu trình duyệt không tự mở, bạn có thể truy cập thủ công URL hiển thị trong terminal.
+
+## Ví dụ
+
+### Đăng nhập với URL CMS tùy chỉnh
+
+```bash
+npx intlayer login --cms-url https://custom-cms.example.com
+```
+
+### Đăng nhập với file môi trường cụ thể
+
+```bash
+npx intlayer login --env-file .env.production
+```
+
+### Đăng nhập ở chế độ verbose
+
+```bash
+npx intlayer login --verbose
+```
+
+## Khắc phục sự cố
+
+### Trình duyệt không tự mở
+
+Nếu trình duyệt không tự mở, sao chép URL hiển thị trong terminal và mở thủ công trên trình duyệt của bạn.
+
+### Sự cố kết nối
+
+Nếu bạn gặp sự cố kết nối, kiểm tra:
+
+1. Đảm bảo URL của CMS là chính xác
+2. Kết nối Internet của bạn đang hoạt động bình thường
+3. Không có tường lửa nào chặn kết nối
+
+### Không nhận được thông tin xác thực
+
+Nếu không nhận được thông tin xác thực:
+
+1. Đảm bảo bạn đã hoàn tất quy trình xác thực trong trình duyệt
+2. Xác nhận rằng cổng cục bộ không bị chặn
+3. Thử chạy lại lệnh
+
+## Các bước tiếp theo
+
+Sau khi hoàn tất đăng nhập:
+
+1. Thêm thông tin xác thực vào file `.env` của bạn
+2. Cấu hình file `intlayer.config.*` của bạn với thông tin xác thực
+3. Sử dụng các lệnh CLI để quản lý các từ điển của bạn:
+   - [`npx intlayer push`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/push.md) - Đẩy từ điển lên CMS
+   - [`npx intlayer pull`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/pull.md) - Kéo từ điển từ CMS
+
+- [`npx intlayer fill`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/fill.md) - Điền các bản dịch còn thiếu
+
+## Xem thêm
+
+- [Tài liệu CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md)
+- [Cấu hình Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/configuration.md)
+- [CMS của Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_CMS.md)

package/docs/vi/configuration.md

@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 7.5.0
+    date: 2025-12-17
+    changes: Thêm tùy chọn `buildMode`
   - version: 7.0.0
     date: 2025-10-25
     changes: Thêm cấu hình `dictionary`
@@ -666,6 +669,15 @@ Các tùy chọn build áp dụng cho các plugin `@intlayer/babel` và `@intlay
 
 #### Thuộc tính
 
+- **mode**:
+  - _Kiểu_: `'auto' | 'manual'`
+  - _Mặc định_: `'auto'`
+  - _Mô tả_: Điều khiển chế độ build.
+  - _Ví dụ_: `'manual'`
+  - _Lưu ý_: Nếu 'auto', build sẽ được bật tự động khi ứng dụng được build.
+  - _Lưu ý_: Nếu 'manual', build sẽ chỉ được đặt khi lệnh build được thực thi.
+  - _Lưu ý_: Có thể được sử dụng để vô hiệu hóa build từ điển, ví dụ khi nên tránh thực thi trong môi trường Node.js.
+
 - **optimize**:
   - _Kiểu_: `boolean`
   - _Mặc định_: `process.env.NODE_ENV === 'production'`

package/docs/vi/dictionary/content_file.md

@@ -28,7 +28,7 @@ history:
 
 # Tệp Nội Dung
 
-<iframe title="i18n, Markdown, JSON… một giải pháp duy nhất để quản lý tất cả | 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/1VHgSY_j9_I?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
+<iframe title="i18n, Markdown, JSON… một giải pháp duy nhất để quản lý tất cả | 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/1VHgSY_j9_I?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
 
 ## Tệp Nội Dung là gì?
 

package/docs/vi/intlayer_CMS.md

@@ -31,7 +31,7 @@ history:
 
 # Tài liệu Hệ thống Quản lý Nội dung (CMS) Intlayer
 
-<iframe title="Trình chỉnh sửa trực quan + CMS cho Ứng dụng Web của bạn: Giải thích về 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/UDDTnirwi_4?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
+<iframe title="Trình chỉnh sửa trực quan + CMS cho Ứng dụng Web của bạn: Giải thích về 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/UDDTnirwi_4?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
 
 Intlayer CMS là một ứng dụng cho phép bạn đưa nội dung của dự án Intlayer ra ngoài.
 

package/docs/vi/intlayer_visual_editor.md

@@ -33,7 +33,7 @@ history:
 
 # Tài liệu Trình chỉnh sửa trực quan Intlayer
 
-<iframe title="Trình chỉnh sửa trực quan + CMS cho ứng dụng web của bạn: Giải thích 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/UDDTnirwi_4?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
+<iframe title="Trình chỉnh sửa trực quan + CMS cho ứng dụng web của bạn: Giải thích 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/UDDTnirwi_4?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
 
 Trình chỉnh sửa trực quan Intlayer là một công cụ bao bọc trang web của bạn để tương tác với các tệp khai báo nội dung của bạn bằng cách sử dụng trình chỉnh sửa trực quan.
 

package/docs/vi/intlayer_with_nextjs_15.md

@@ -80,7 +80,7 @@ Với Intlayer, bạn có thể:
 <Tab defaultTab="video">
   <TabItem label="Video" value="video">
 
-<iframe title="Giải pháp i18n tốt nhất cho Next.js? Khám phá 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/e_PPG7PTqGU?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
+<iframe title="Giải pháp i18n tốt nhất cho Next.js? Khám phá 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/e_PPG7PTqGU?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
 
   </TabItem>
   <TabItem label="Code" value="code">

package/docs/vi/intlayer_with_nextjs_16.md

@@ -27,7 +27,7 @@ history:
 <Tab defaultTab="video">
   <TabItem label="Video" value="video">
   
-<iframe title="Giải pháp i18n tốt nhất cho Next.js? Khám phá 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/e_PPG7PTqGU?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
+<iframe title="Giải pháp i18n tốt nhất cho Next.js? Khám phá 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/e_PPG7PTqGU?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
 
   </TabItem>
   <TabItem label="Code" value="code">

package/docs/vi/intlayer_with_nuxt.md

@@ -49,7 +49,7 @@ Với Intlayer, bạn có thể:
 <Tab defaultTab="video">
   <TabItem label="Video" value="video">
   
-<iframe title="Cách dịch ứng dụng Nuxt và Vue của bạn bằng Intlayer? Khám phá 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/nhUcUAVQ6eQ?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
+<iframe title="Cách dịch ứng dụng Nuxt và Vue của bạn bằng Intlayer? Khám phá 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/nhUcUAVQ6eQ?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
 
   </TabItem>
   <TabItem label="Mã nguồn" value="code">

package/docs/vi/intlayer_with_react_router_v7.md

@@ -91,7 +91,7 @@ pnpm add vite-intlayer --save-dev
 <Tab defaultTab="video">
   <TabItem 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 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"/>
 
   </TabItem>
   <TabItem label="Code" value="code">

package/docs/vi/intlayer_with_react_router_v7_fs_routes.md

@@ -91,7 +91,7 @@ pnpm add vite-intlayer --save-dev
 <Tab defaultTab="video">
   <TabItem 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 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"/>
 
   </TabItem>
   <TabItem label="Code" value="code">

package/docs/vi/intlayer_with_tanstack.md

@@ -60,7 +60,7 @@ Với Intlayer, bạn có thể:
 <Tab defaultTab="video">
   <TabItem label="Video" value="video">
   
-<iframe title="Giải pháp i18n tốt nhất cho Tanstack Start? Khám phá 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/_XTdKVWaeqg?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
+<iframe title="Giải pháp i18n tốt nhất cho Tanstack Start? Khám phá 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/_XTdKVWaeqg?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
 
   </TabItem>
   <TabItem label="Code" value="code">

package/docs/vi/intlayer_with_vite+preact.md

@@ -1503,8 +1503,7 @@ import { forwardRef } from "preact/compat";
 export const checkIsExternalLink = (href?: string) =>
   /^https?:\/\//.test(href ?? "");
 
-export interface LocalizedLinkProps
-  extends JSX.HTMLAttributes<HTMLAnchorElement> {
+export interface LocalizedLinkProps extends JSX.HTMLAttributes<HTMLAnchorElement> {
   href: string;
   replace?: boolean;
 }

package/docs/vi/intlayer_with_vite+react.md

@@ -47,7 +47,7 @@ Với Intlayer, bạn có thể:
 <Tab defaultTab="video">
   <TabItem label="Video" value="video">
   
-<iframe title="Giải pháp i18n tốt nhất cho Vite và React? Khám phá 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?si=VaKmrYMmXjo3xpk2"/>
+<iframe title="Giải pháp i18n tốt nhất cho Vite và React? Khám phá 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?si=VaKmrYMmXjo3xpk2"/>
 
   </TabItem>
   <TabItem label="Code" value="code">

package/docs/vi/intlayer_with_vite+vue.md

@@ -46,7 +46,7 @@ Với Intlayer, bạn có thể:
 <Tab defaultTab="video">
   <TabItem label="Video" value="video">
   
-<iframe title="The best i18n solution for Vite and Vue? Discover 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/IE3XWkZ6a5U?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
+<iframe title="The best i18n solution for Vite and Vue? Discover 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/IE3XWkZ6a5U?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
 
   </TabItem>
   <TabItem label="Mã" value="code">

package/docs/vi/plugins/sync-json.md

@@ -34,7 +34,7 @@ history:
 
 # Đồng bộ JSON (cầu nối i18n) - Đồng bộ JSON với hỗ trợ ICU / i18next
 
-<iframe title="Cách giữ bản dịch JSON của bạn đồng bộ với 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/MpGMxniDHNg?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
+<iframe title="Cách giữ bản dịch JSON của bạn đồng bộ với 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/MpGMxniDHNg?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
 
 Sử dụng Intlayer như một tiện ích bổ sung cho bộ công cụ i18n hiện có của bạn. Plugin này giữ cho các thông điệp JSON của bạn đồng bộ với từ điển Intlayer để bạn có thể:
 

package/docs/zh/cli/index.md

@@ -103,6 +103,10 @@ Intlayer 支持多种配置文件格式：
 
 ## 运行 intlayer 命令
 
+### 身份验证
+
+- **[登录](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/login.md)** - 使用 Intlayer CMS 进行身份验证并获取访问凭据
+
 ### 核心命令
 
 - **[构建字典](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/build.md)** - 从内容声明文件构建字典
@@ -149,6 +153,7 @@ Intlayer 支持多种配置文件格式：
 
 ```json fileName="package.json"
 "scripts": {
+  "intlayer:login": "npx intlayer login",
   "intlayer:build": "npx intlayer build",
   "intlayer:watch": "npx intlayer build --watch",
   "intlayer:push": "npx intlayer push",

package/docs/zh/cli/login.md

@@ -0,0 +1,182 @@
+---
+createdAt: 2025-12-16
+updatedAt: 2025-12-16
+title: CLI - 登录
+description: 了解如何使用 Intlayer CLI 的 login 命令与 Intlayer CMS 进行身份验证并获取访问凭证。
+keywords:
+  - CLI
+  - 登录
+  - 认证
+  - CMS
+  - Intlayer
+  - 凭证
+slugs:
+  - doc
+  - concept
+  - cli
+  - login
+---
+
+# Intlayer CLI 登录命令
+
+---
+
+## 描述
+
+Intlayer CLI 的 `login` 命令允许您对 Intlayer CMS 进行身份验证。该命令会自动打开您的默认浏览器以完成身份验证流程，并接收使用 Intlayer 服务所需的凭证（Client ID 和 Client Secret）。
+
+## 用法
+
+```bash
+npx intlayer login [options]
+```
+
+或
+
+```bash
+intlayer login [options]
+```
+
+## 选项
+
+### `--cms-url <url>`
+
+指定用于身份验证的 Intlayer CMS 的 URL。
+
+- **类型**: `string`
+- **默认**: 在 `intlayer.config.*` 中配置的值，或 `https://intlayer.org`
+- **示例**:
+
+```bash
+npx intlayer login --cms-url https://intlayer.org
+```
+
+### 配置选项
+
+您还可以使用常见的配置选项：
+
+- `--env-file <path>`：环境文件的路径
+- `-e, --env <env>`：执行环境
+- `--base-dir <dir>`：项目的基目录
+- `--verbose`：启用详细输出（默认：true）
+- `--prefix <prefix>`：日志前缀
+
+## 工作原理
+
+1. **启动本地服务器**：该命令在一个随机端口上启动本地 HTTP 服务器，以从 CMS 接收凭证
+
+指定要用于身份验证的 Intlayer CMS 的 URL。
+
+- **类型**: `string`
+- **默认**: 在 `intlayer.config.*` 中配置的值，或 `https://intlayer.org`
+- **示例**:
+
+```bash
+npx intlayer login --cms-url https://intlayer.org
+```
+
+### 配置选项
+
+您还可以使用常用的配置选项：
+
+- `--env-file <path>`: 环境文件的路径
+- `-e, --env <env>`: 执行环境
+- `--base-dir <dir>`: 项目的基目录
+- `--verbose`: 启用详细输出（默认：true）
+- `--prefix <prefix>`: 日志前缀
+
+## 工作原理
+
+1. **启动本地服务器**：该命令在随机端口启动一个本地 HTTP 服务器以接收来自 CMS 的凭证
+2. **Browser Opening**：该命令会自动在你的默认浏览器中打开 CMS 的登录 URL
+3. **Authentication**：在浏览器中使用你的 Intlayer 帐户完成身份验证
+4. **Credentials Reception**：本地服务器从 CMS 接收 Client ID 和 Client Secret
+5. **Instructions**：该命令显示在项目中配置凭证的说明
+
+## 输出
+
+登录成功后，命令将显示：
+
+1. **接收到的凭证**（Client ID 和 Client Secret）
+2. **`.env` 文件的说明**：
+
+```bash
+INTLAYER_CLIENT_ID=your_client_id
+INTLAYER_CLIENT_SECRET=your_client_secret
+```
+
+3. **Intlayer 配置文件的说明**：
+
+```typescript
+{
+  editor: {
+    cmsURL: 'https://intlayer.org',
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+  },
+}
+```
+
+## 手动配置
+
+如果浏览器没有自动打开，您可以手动访问终端中显示的 URL。
+
+## 示例
+
+### 使用自定义 CMS URL 登录
+
+```bash
+npx intlayer login --cms-url https://custom-cms.example.com
+```
+
+### 使用特定环境文件登录
+
+```bash
+npx intlayer login --env-file .env.production
+```
+
+### 以详细模式登录
+
+```bash
+npx intlayer login --verbose
+```
+
+## 故障排除
+
+### 浏览器未打开
+
+如果浏览器没有自动打开，请复制终端中显示的 URL 并在浏览器中手动打开。
+
+### 连接问题
+
+如果遇到连接问题，请验证：
+
+1. 确认 CMS URL 是否正确
+2. 确认您的网络连接正常工作
+3. 确认没有防火墙阻止连接
+
+### 未收到凭证
+
+如果未收到凭证：
+
+1. 确保在浏览器中完成了身份验证流程
+2. 验证本地端口未被阻塞
+3. 重新尝试该命令
+
+## 后续步骤
+
+完成登录后：
+
+1. 将凭证添加到您的 `.env` 文件中
+2. 在 `intlayer.config.*` 文件中配置这些凭证
+3. 使用 CLI 命令管理您的词典：
+   - [`npx intlayer push`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/push.md) - 将词典推送到 CMS
+   - [`npx intlayer pull`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/pull.md) - 从 CMS 拉取词典
+   - [`npx intlayer fill`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/fill.md) - 填充缺失的翻译
+   - [`npx intlayer fill`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/fill.md) - 填充缺失的翻译
+
+## 另请参阅
+
+- [CLI 文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/index.md)
+- [Intlayer 配置](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md)
+- [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md)

package/docs/zh/configuration.md

@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 7.5.0
+    date: 2025-12-17
+    changes: 添加 `buildMode` 选项
   - version: 6.0.0
     date: 2025-09-16
     changes: 添加 `live` 导入模式
@@ -528,6 +531,15 @@ Intlayer 支持多个 AI 提供商，以增强灵活性和选择。目前支持
 
 #### 属性
 
+- **mode**：
+  - _类型_：`'auto' | 'manual'`
+  - _默认值_：`'auto'`
+  - _描述_：控制构建的模式。
+  - _示例_：`'manual'`
+  - _注意_：如果为 'auto'，构建将在应用程序构建时自动启用。
+  - _注意_：如果为 'manual'，构建仅在执行构建命令时设置。
+  - _注意_：可用于禁用字典构建，例如当应避免在 Node.js 环境中执行时。
+
 - **optimize**：
   - _类型_：`boolean`
   - _默认值_：`process.env.NODE_ENV === 'production'`

package/docs/zh/dictionary/content_file.md

@@ -25,7 +25,7 @@ history:
 
 # 内容文件
 
-<iframe title="i18n，Markdown，JSON……一站式管理解决方案 | 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/1VHgSY_j9_I?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
+<iframe title="i18n，Markdown，JSON……一站式管理解决方案 | 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/1VHgSY_j9_I?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
 
 ## 什么是内容文件？