@intlayer/docs 7.2.3 → 7.3.0

package/docs/tr/packages/intlayer/getPrefix.md

@@ -0,0 +1,213 @@
+---
+createdAt: 2025-11-16
+updatedAt: 2025-11-16
+title: getPrefix Fonksiyon Dokümantasyonu | intlayer
+description: intlayer paketi için getPrefix fonksiyonunun nasıl kullanılacağını görün
+keywords:
+  - getPrefix
+  - prefix
+  - Intlayer
+  - intlayer
+  - Uluslararasılaştırma
+  - Dokümantasyon
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getPrefix
+history:
+  - version: 7.1.0
+    date: 2025-11-16
+    changes: İlk dokümantasyon
+---
+
+# Dokümantasyon: `intlayer` İçindeki `getPrefix` Fonksiyonu
+
+## Açıklama
+
+`getPrefix` fonksiyonu, yönlendirme modu yapılandırmasına bağlı olarak verilen bir locale için URL ön ekini belirler. Locale'i varsayılan locale ile karşılaştırır ve esnek URL yapısı için üç farklı ön ek formatını içeren bir nesne döner.
+
+**Temel Özellikler:**
+
+- İlk parametre olarak bir locale alır (zorunlu)
+- `defaultLocale` ve `mode` içeren isteğe bağlı `options` nesnesi
+- `prefix` ve `localePrefix` özelliklerine sahip bir nesne döner
+- Tüm yönlendirme modlarını destekler: `prefix-no-default`, `prefix-all`, `no-prefix` ve `search-params`
+- Locale ön eklerinin ne zaman ekleneceğini belirlemek için hafif bir yardımcı araç
+
+---
+
+## Fonksiyon İmzası
+
+```typescript
+getPrefix(
+  locale: Locales,               // Zorunlu
+  options?: {                    // İsteğe bağlı
+    defaultLocale?: Locales;
+    mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';
+  }
+): GetPrefixResult
+
+type GetPrefixResult = {
+  prefix: string;   // örn. 'fr/' veya ''
+  localePrefix?: Locale; // örn. 'fr' veya tanımsız
+}
+```
+
+---
+
+## Parametreler
+
+- `locale: Locales`
+  - **Açıklama**: Ön ek oluşturulacak locale. Değer falsy ise (undefined, null, boş string), fonksiyon boş string döner.
+  - **Tür**: `Locales`
+  - **Zorunlu**: Evet
+
+- `options?: object`
+  - **Açıklama**: Ön ek belirleme için yapılandırma nesnesi.
+  - **Tür**: `object`
+  - **Zorunlu**: Hayır (İsteğe bağlı)
+
+  - `options.defaultLocale?: Locales`
+    - **Açıklama**: Uygulamanın varsayılan locale'i. Sağlanmazsa, proje yapılandırmanızdaki varsayılan locale kullanılır.
+    - **Tür**: `Locales`
+    - **Varsayılan**: [`Proje Yapılandırması`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/configuration.md#middleware)
+
+  - `options.mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **Açıklama**: Locale işlemleri için URL yönlendirme modu. Sağlanmazsa, proje yapılandırmanızdaki yapılandırılmış modu kullanır.
+    - **Tür**: `'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **Varsayılan**: [`Proje Yapılandırması`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/configuration.md#middleware)
+    - **Modlar**:
+      - `prefix-no-default`: Locale varsayılan locale ile eşleştiğinde boş string döner
+      - `prefix-all`: Varsayılan dahil tüm localeler için ön ek döner
+      - `no-prefix`: Boş string döner (URL'lerde ön ek yok)
+      - `search-params`: Boş string döner (locale sorgu parametrelerinde)
+
+### Dönüş Değeri
+
+- **Tür**: `GetPrefixResult`
+- **Açıklama**: Üç farklı ön ek formatı içeren bir nesne:
+  - `prefix`: Sonunda eğik çizgi olan yol ön eki (örneğin, `'fr/'`, `''`)
+  - `localePrefix`: Eğik çizgisiz locale tanımlayıcısı (örneğin, `'fr'`, `undefined`)
+
+---
+
+## Örnek Kullanım
+
+### Temel Kullanım
+
+```typescript codeFormat="typescript"
+import { getPrefix, Locales } from "intlayer";
+
+// İngilizce locale için ön eki kontrol et
+getPrefix(Locales.ENGLISH, {
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-all",
+});
+// Döner: { prefix: 'en/', localePrefix: 'en' }
+
+// Fransızca locale için ön eki kontrol et
+getPrefix(Locales.FRENCH, {
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-no-default",
+});
+// Döner: { prefix: 'fr/', localePrefix: 'fr' }
+```
+
+```javascript codeFormat="esm"
+import { getPrefix, Locales } from "intlayer";
+
+getPrefix(Locales.ENGLISH, { mode: "prefix-all" });
+// Döner: { prefix: '', localePrefix: undefined }
+```
+
+```javascript codeFormat="commonjs"
+const { getPrefix, Locales } = require("intlayer");
+
+getPrefix(Locales.ENGLISH, { mode: "prefix-all" });
+// Döner: { prefix: '', localePrefix: undefined }
+```
+
+### Farklı Yönlendirme Modları
+
+```typescript
+import { getPrefix, Locales } from "intlayer";
+
+// prefix-all: Her zaman prefix döner
+getPrefix(Locales.ENGLISH, {
+  mode: "prefix-all",
+  defaultLocale: Locales.ENGLISH,
+});
+// Döner: { prefix: '/en', localePrefix: 'en' }
+
+// prefix-no-default: Locale varsayılanla eşleştiğinde prefix yok
+getPrefix(Locales.ENGLISH, {
+  mode: "prefix-no-default",
+  defaultLocale: Locales.ENGLISH,
+});
+// Döner: { prefix: '', localePrefix: undefined }
+
+// prefix-no-default: Locale varsayılanla farklıysa prefix döner
+getPrefix(Locales.FRENCH, {
+  mode: "prefix-no-default",
+  defaultLocale: Locales.ENGLISH,
+});
+// Döner: { prefix: 'fr/', localePrefix: 'fr' }
+
+// no-prefix & search-params: Hiçbir zaman prefix döndürmez
+getPrefix(Locales.ENGLISH, { mode: "no-prefix" });
+// Döner: { prefix: '', localePrefix: undefined }
+
+getPrefix(Locales.ENGLISH, { mode: "search-params" });
+// Döner: { prefix: '', localePrefix: undefined }
+```
+
+### Pratik Örnek
+
+```typescript
+import { getPrefix, Locales } from "intlayer";
+
+// Belirli bir locale için uygun prefix ile URL'ler oluştur
+const locale = Locales.FRENCH;
+const { prefix, localePrefix } = getPrefix(locale, {
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-no-default",
+});
+
+// Yol oluşturmak için prefix kullanımı
+const url1 = `/${prefix}about`.replace(/\/+/g, "/");
+// Sonuç: "/fr/about"
+
+// Locale tanımlaması için localePrefix kullanımı
+console.log(`Mevcut locale: ${localePrefix}`);
+// Çıktı: "Mevcut locale: fr"
+```
+
+---
+
+## İlgili Fonksiyonlar
+
+- [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getLocalizedUrl.md): Belirli bir locale için lokalize URL oluşturur
+- [`getMultilingualUrls`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getMultilingualUrls.md): Tüm yapılandırılmış locale'ler için URL'ler oluşturur
+
+---
+
+## TypeScript
+
+```typescript
+type GetPrefixResult = {
+  prefix: string; // Sonunda eğik çizgi olan yol öneki (örneğin, 'fr/' veya '')
+  localePrefix?: Locale; // Eğik çizgi olmadan locale tanımlayıcısı (örneğin, 'fr' veya tanımsız)
+};
+
+function getPrefix(
+  locale: Locales,
+  options?: {
+    defaultLocale?: Locales;
+    mode?: "prefix-no-default" | "prefix-all" | "no-prefix" | "search-params";
+  }
+): GetPrefixResult;
+```

package/docs/tr/per_locale_file.md

@@ -316,4 +316,4 @@ console.log(JSON.stringify(intlayer, null, 2));
 
 ### Otomatik Çeviri Oluşturma
 
-Eksik çevirileri tercih ettiğiniz servisler temelinde otomatik olarak doldurmak için [intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_cli.md)'yi kullanın.
+Eksik çevirileri tercih ettiğiniz servisler temelinde otomatik olarak doldurmak için [intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/index.md)'yi kullanın.

package/docs/tr/roadmap.md

@@ -280,7 +280,7 @@ Intlayer içerik bildirmek için **TypeScript** (ayrıca JavaScript) ve **JSON**
 
 > Kaynaklar:
 >
-> - [CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_cli.md)
+> - [CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/index.md)
 
 ---
 

package/docs/vi/cli/build.md

@@ -0,0 +1,64 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Xây dựng Từ điển
+description: Tìm hiểu cách xây dựng từ điển Intlayer của bạn từ các tệp khai báo nội dung.
+keywords:
+  - Xây dựng
+  - Từ điển
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - build
+---
+
+# Xây dựng Từ điển
+
+Để xây dựng từ điển của bạn, bạn có thể chạy các lệnh:
+
+```bash
+npx intlayer build
+```
+
+hoặc ở chế độ theo dõi
+
+```bash
+npx intlayer build --watch
+```
+
+Lệnh này sẽ tìm các tệp khai báo nội dung của bạn theo mặc định tại `./src/**/*.content.{ts|js|mjs|cjs|json|tsx|jsx}`. Và xây dựng các từ điển trong thư mục `.intlayer`.
+
+## Bí danh:
+
+- `npx intlayer dictionaries build`
+- `npx intlayer dictionary build`
+- `npx intlayer dic build`
+
+## Tham số:
+
+- **`--base-dir`**: Chỉ định thư mục gốc cho dự án. Để lấy cấu hình intlayer, lệnh sẽ tìm tệp `intlayer.config.{ts,js,json,cjs,mjs}` trong thư mục gốc.
+
+  > Ví dụ: `npx intlayer build --base-dir ./src`
+
+- **`--env`**: Chỉ định môi trường (ví dụ: `development`, `production`). Hữu ích trong trường hợp bạn sử dụng biến môi trường trong tệp cấu hình intlayer của mình.
+
+  > Ví dụ: `npx intlayer build --env production`
+
+- **`--env-file`**: Cung cấp tệp môi trường tùy chỉnh để tải các biến. Hữu ích trong trường hợp bạn sử dụng biến môi trường trong tệp cấu hình intlayer của mình.
+
+  > Ví dụ: `npx intlayer build --env-file .env.production.local`
+
+- **`--with`**: Khởi chạy lệnh song song với quá trình build.
+
+  > Ví dụ: `npx intlayer build --with "next dev --turbopack"`
+
+- **`--skip-prepare`**: Bỏ qua bước chuẩn bị.
+
+  > Ví dụ: `npx intlayer build --skip-prepare`
+
+- **`--no-cache`**: Vô hiệu hóa bộ nhớ đệm.
+
+  > Ví dụ: `npx intlayer build --no-cache`

package/docs/vi/cli/configuration.md

@@ -0,0 +1,63 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Quản lý Cấu hình
+description: Tìm hiểu cách lấy và đẩy cấu hình Intlayer của bạn lên CMS.
+keywords:
+  - Cấu hình
+  - Config
+  - CLI
+  - Intlayer
+  - CMS
+slugs:
+  - doc
+  - concept
+  - cli
+  - configuration
+---
+
+# Quản lý Cấu hình
+
+## Lấy Cấu hình
+
+Lệnh `configuration get` lấy cấu hình hiện tại cho Intlayer, đặc biệt là các thiết lập locale. Điều này hữu ích để kiểm tra cấu hình của bạn.
+
+```bash
+npx intlayer configuration get
+```
+
+## Bí danh:
+
+- `npx intlayer config get`
+- `npx intlayer conf get`
+
+## Tham số:
+
+- **`--env`**: Chỉ định môi trường (ví dụ: `development`, `production`).
+- **`--env-file`**: Cung cấp file môi trường tùy chỉnh để tải biến từ đó.
+- **`--base-dir`**: Chỉ định thư mục gốc cho dự án.
+- **`--verbose`**: Bật ghi log chi tiết để gỡ lỗi. (mặc định là true khi sử dụng CLI)
+- **`--no-cache`**: Vô hiệu hóa bộ nhớ đệm.
+
+## Đẩy Cấu hình
+
+Lệnh `configuration push` tải cấu hình của bạn lên Intlayer CMS và trình chỉnh sửa. Bước này cần thiết để cho phép sử dụng từ điển từ xa trong Intlayer Visual Editor.
+
+```bash
+npx intlayer configuration push
+```
+
+## Bí danh:
+
+- `npx intlayer config push`
+- `npx intlayer conf push`
+
+## Tham số:
+
+- **`--env`**: Chỉ định môi trường (ví dụ: `development`, `production`).
+- **`--env-file`**: Cung cấp file môi trường tùy chỉnh để tải biến từ đó.
+- **`--base-dir`**: Chỉ định thư mục gốc cho dự án.
+- **`--verbose`**: Bật ghi log chi tiết để gỡ lỗi. (mặc định là true khi sử dụng CLI)
+- **`--no-cache`**: Vô hiệu hóa bộ nhớ đệm.
+
+Bằng cách đẩy cấu hình, dự án của bạn được tích hợp hoàn toàn với Intlayer CMS, cho phép quản lý từ điển liền mạch giữa các nhóm.

package/docs/vi/cli/debug.md

@@ -0,0 +1,46 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Gỡ lỗi lệnh Intlayer
+description: Tìm hiểu cách gỡ lỗi và khắc phục sự cố CLI của Intlayer.
+keywords:
+  - Gỡ lỗi
+  - Khắc phục sự cố
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - debug
+---
+
+# Gỡ lỗi lệnh intlayer
+
+## 1. **Đảm bảo bạn đang sử dụng phiên bản mới nhất**
+
+Chạy:
+
+```bash
+npx intlayer --version                  # phiên bản intlayer hiện tại theo locale
+npx intlayer@latest --version           # phiên bản intlayer mới nhất hiện tại
+```
+
+## 2. **Kiểm tra xem lệnh đã được đăng ký chưa**
+
+Bạn có thể kiểm tra bằng:
+
+```bash
+npx intlayer --help                     # Hiển thị danh sách các lệnh có sẵn và thông tin sử dụng
+npx intlayer dictionary build --help    # Hiển thị danh sách các tùy chọn có sẵn cho một lệnh
+```
+
+## 3. **Khởi động lại terminal của bạn**
+
+Đôi khi cần khởi động lại terminal để nhận diện các lệnh mới.
+
+## 4. **Xóa cache npx (nếu bạn bị kẹt với phiên bản cũ hơn)**
+
+```bash
+npx clear-npx-cache
+```

package/docs/vi/cli/doc-review.md

@@ -0,0 +1,43 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Đánh Giá Tài Liệu
+description: Tìm hiểu cách đánh giá các tệp tài liệu về chất lượng, tính nhất quán và độ đầy đủ trên các ngôn ngữ khác nhau.
+keywords:
+  - Đánh Giá
+  - Tài Liệu
+  - Tài Liệu Hướng Dẫn
+  - AI
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - doc-review
+---
+
+# Đánh Giá Tài Liệu
+
+Lệnh `doc review` phân tích các tệp tài liệu về chất lượng, tính nhất quán và độ đầy đủ trên các ngôn ngữ khác nhau.
+
+```bash
+npx intlayer doc review
+```
+
+Lệnh này có thể được sử dụng để đánh giá các tệp đã được dịch, và kiểm tra xem bản dịch có chính xác hay không.
+
+Đối với hầu hết các trường hợp sử dụng,
+
+- ưu tiên sử dụng `doc translate` khi phiên bản dịch của tệp này chưa có.
+- ưu tiên sử dụng `doc review` khi phiên bản dịch của tệp này đã tồn tại.
+
+> Lưu ý rằng quá trình đánh giá tiêu tốn nhiều token đầu vào hơn so với quá trình dịch để đánh giá toàn bộ tệp. Tuy nhiên, quá trình đánh giá sẽ tối ưu các phần cần đánh giá, và sẽ bỏ qua những phần không thay đổi.
+
+## Tham số:
+
+Lệnh `doc review` chấp nhận cùng các tham số như `doc translate`, cho phép bạn đánh giá các tệp tài liệu cụ thể và áp dụng các kiểm tra chất lượng.
+
+Nếu bạn đã kích hoạt một trong các tùy chọn git, lệnh sẽ chỉ đánh giá phần của các tệp bị thay đổi. Script sẽ xử lý bằng cách chia tệp thành các phần nhỏ và đánh giá từng phần. Nếu phần đó không có thay đổi, script sẽ bỏ qua để tăng tốc quá trình đánh giá và giới hạn chi phí API của nhà cung cấp AI.
+
+- Để xem danh sách đầy đủ các tham số, hãy xem tài liệu lệnh [Translate Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/doc-translate.md).

package/docs/vi/cli/doc-translate.md

@@ -0,0 +1,132 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Dịch Tài Liệu
+description: Tìm hiểu cách tự động dịch các tệp tài liệu sử dụng dịch vụ dịch thuật AI.
+keywords:
+  - Dịch
+  - Tài liệu
+  - Tài liệu hướng dẫn
+  - AI
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - doc-translate
+---
+
+# Dịch Tài Liệu
+
+Lệnh `doc translate` tự động dịch các tệp tài liệu từ ngôn ngữ cơ sở sang các ngôn ngữ đích sử dụng dịch vụ dịch thuật AI.
+
+```bash
+npx intlayer doc translate
+```
+
+## Tham số:
+
+**Tùy chọn danh sách tệp:**
+
+- **`--doc-pattern [docPattern...]`**: Các mẫu glob để khớp với các tệp tài liệu cần dịch.
+
+  > Ví dụ: `npx intlayer doc translate --doc-pattern "docs/**/*.md" "src/**/*.mdx"`
+
+- **`--excluded-glob-pattern [excludedGlobPattern...]`**: Các mẫu glob để loại trừ khỏi việc dịch.
+
+  > Ví dụ: `npx intlayer doc translate --excluded-glob-pattern "docs/internal/**"`
+
+- **`--skip-if-modified-before [skipIfModifiedBefore]`**: Bỏ qua tệp nếu nó đã được sửa đổi trước thời gian cho trước.
+  - Có thể là thời gian tuyệt đối như "2025-12-05" (chuỗi hoặc Date)
+  - Có thể là thời gian tương đối tính bằng ms `1 * 60 * 60 * 1000` (1 giờ)
+  - Tùy chọn này kiểm tra thời gian cập nhật của tệp bằng phương thức `fs.stat`. Do đó, nó có thể bị ảnh hưởng bởi Git hoặc các công cụ khác sửa đổi tệp.
+
+  > Ví dụ: `npx intlayer doc translate --skip-if-modified-before "2025-12-05"`
+
+- **`--skip-if-modified-after [skipIfModifiedAfter]`**: Bỏ qua tệp nếu nó đã được sửa đổi trong khoảng thời gian cho trước.
+  - Có thể là thời gian tuyệt đối như "2025-12-05" (chuỗi hoặc Date)
+  - Có thể là thời gian tương đối tính bằng ms `1 * 60 * 60 * 1000` (1 giờ)
+  - Tùy chọn này kiểm tra thời gian cập nhật của tệp bằng phương thức `fs.stat`. Do đó, nó có thể bị ảnh hưởng bởi Git hoặc các công cụ khác sửa đổi tệp.
+
+  > Ví dụ: `npx intlayer doc translate --skip-if-modified-after "2025-12-05"`
+
+- **`--skip-if-exists`**: Bỏ qua tệp nếu tệp đã tồn tại.
+
+  > Ví dụ: `npx intlayer doc translate --skip-if-exists`
+
+**Tùy chọn xuất đầu vào:**
+
+- **`--locales [locales...]`**: Các ngôn ngữ đích để dịch tài liệu.
+
+  > Ví dụ: `npx intlayer doc translate --locales fr es de`
+
+- **`--base-locale [baseLocale]`**: Ngôn ngữ nguồn để dịch từ.
+
+  > Ví dụ: `npx intlayer doc translate --base-locale en`
+
+**Tùy chọn xử lý tệp:**
+
+- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: Số lượng tệp được xử lý đồng thời để dịch.
+
+  > Ví dụ: `npx intlayer doc translate --nb-simultaneous-file-processed 5`
+
+**Tùy chọn AI:**
+
+- **`--model [model]`**: Mô hình AI được sử dụng để dịch (ví dụ: `gpt-3.5-turbo`).
+- **`--provider [provider]`**: Nhà cung cấp AI được sử dụng để dịch.
+- **`--temperature [temperature]`**: Thiết lập nhiệt độ cho mô hình AI.
+- **`--api-key [apiKey]`**: Cung cấp khóa API riêng của bạn cho dịch vụ AI.
+- **`--application-context [applicationContext]`**: Cung cấp ngữ cảnh bổ sung cho việc dịch AI.
+- **`--custom-prompt [prompt]`**: Tùy chỉnh prompt cơ bản được sử dụng cho việc dịch. (Lưu ý: Trong hầu hết các trường hợp, tùy chọn `--custom-instructions` được khuyến nghị hơn vì nó cung cấp kiểm soát tốt hơn đối với hành vi dịch.)
+
+  > Ví dụ: `npx intlayer doc translate --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "Ứng dụng của tôi là một cửa hàng mèo"`
+
+**Tùy chọn biến môi trường:**
+
+- **`--env`**: Chỉ định môi trường (ví dụ: `development`, `production`).
+- **`--env-file [envFile]`**: Cung cấp tệp môi trường tùy chỉnh để tải biến.
+- **`--base-dir`**: Chỉ định thư mục gốc cho dự án.
+- **`--no-cache`**: Vô hiệu hóa bộ nhớ đệm.
+
+  > Ví dụ: `npx intlayer doc translate --base-dir ./docs --env-file .env.production.local`
+
+**Tùy chọn ghi log:**
+
+- **`--verbose`**: Bật ghi log chi tiết để gỡ lỗi. (mặc định là true khi sử dụng CLI)
+
+  > Ví dụ: `npx intlayer doc translate --verbose`
+
+**Tùy chọn hướng dẫn tùy chỉnh:**
+
+- **`--custom-instructions [customInstructions]`**: Hướng dẫn tùy chỉnh được thêm vào prompt. Hữu ích để áp dụng các quy tắc cụ thể liên quan đến định dạng, dịch URL, v.v.
+  - Có thể là thời gian tuyệt đối như "2025-12-05" (chuỗi hoặc Date)
+  - Có thể là thời gian tương đối tính bằng ms `1 * 60 * 60 * 1000` (1 giờ)
+  - Tùy chọn này kiểm tra thời gian cập nhật của tệp bằng phương thức `fs.stat`. Vì vậy, nó có thể bị ảnh hưởng bởi Git hoặc các công cụ khác sửa đổi tệp.
+
+  > Ví dụ: `npx intlayer doc translate --custom-instructions "Tránh dịch các URL, và giữ nguyên định dạng markdown"`
+
+  > Ví dụ: `npx intlayer doc translate --custom-instructions "$(cat ./instructions.md)"`
+
+**Tùy chọn Git:**
+
+- **`--git-diff`**: Chỉ chạy trên các từ điển có thay đổi từ cơ sở (mặc định `origin/main`) đến nhánh hiện tại (mặc định: `HEAD`).
+- **`--git-diff-base`**: Chỉ định tham chiếu cơ sở cho git diff (mặc định `origin/main`).
+- **`--git-diff-current`**: Chỉ định tham chiếu hiện tại cho git diff (mặc định: `HEAD`).
+- **`--uncommitted`**: Bao gồm các thay đổi chưa được commit.
+- **`--unpushed`**: Bao gồm các thay đổi chưa được đẩy lên.
+- **`--untracked`**: Bao gồm các tệp chưa được theo dõi.
+
+  > Ví dụ: `npx intlayer doc translate --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Ví dụ: `npx intlayer doc translate --uncommitted --unpushed --untracked`
+
+> Lưu ý rằng đường dẫn tệp đầu ra sẽ được xác định bằng cách thay thế các mẫu sau
+>
+> - `/{{baseLocale}}/` thành `/{{locale}}/` (Unix)
+> - `\{{baseLocale}}\` thành `\{{locale}}\` (Windows)
+> - `_{{baseLocale}}.` thành `_{{locale}}.`
+> - `{{baseLocale}}_` thành `{{locale}}_`
+> - `.{{baseLocaleName}}.` thành `.{{localeName}}.`
+>
+> Nếu không tìm thấy mẫu, tệp đầu ra sẽ thêm `.{{locale}}` vào phần mở rộng của tệp. Ví dụ, `./my/file.md` sẽ được dịch thành `./my/file.fr.md` cho ngôn ngữ Pháp.

package/docs/vi/cli/editor.md

@@ -0,0 +1,28 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Lệnh Editor
+description: Tìm hiểu cách sử dụng các lệnh editor của Intlayer.
+keywords:
+  - Editor
+  - Visual Editor
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - editor
+---
+
+# Lệnh Editor
+
+Lệnh `editor` bao bọc lại các lệnh `intlayer-editor`.
+
+> Để có thể sử dụng lệnh `editor`, gói `intlayer-editor` phải được cài đặt. (Xem [Intlayer Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_visual_editor.md))
+
+```json fileName="package.json"
+"scripts": {
+  "intlayer:editor:start": "npx intlayer editor start --with 'next dev --turbopack'"
+}
+```