@intlayer/docs 7.2.2 → 7.3.0-canary.0

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

@@ -0,0 +1,217 @@
+---
+createdAt: 2025-11-16
+updatedAt: 2025-11-16
+title: getPrefix फ़ंक्शन दस्तावेज़ीकरण | intlayer
+description: intlayer पैकेज के लिए getPrefix फ़ंक्शन का उपयोग कैसे करें देखें
+keywords:
+  - getPrefix
+  - prefix
+  - Intlayer
+  - intlayer
+  - अंतरराष्ट्रीयकरण
+  - दस्तावेज़ीकरण
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getPrefix
+history:
+  - version: 7.1.0
+    date: 2025-11-16
+    changes: प्रारंभिक दस्तावेज़ीकरण
+---
+
+# दस्तावेज़ीकरण: `intlayer` में `getPrefix` फ़ंक्शन
+
+## विवरण
+
+`getPrefix` फ़ंक्शन रूटिंग मोड कॉन्फ़िगरेशन के आधार पर दिए गए locale के लिए URL प्रीफ़िक्स निर्धारित करता है। यह locale की तुलना डिफ़ॉल्ट locale से करता है और लचीले URL निर्माण के लिए तीन अलग-अलग प्रीफ़िक्स प्रारूपों वाला एक ऑब्जेक्ट लौटाता है।
+
+**मुख्य विशेषताएँ:**
+
+- पहले पैरामीटर के रूप में एक locale लेता है (आवश्यक)
+- वैकल्पिक `options` ऑब्जेक्ट जिसमें `defaultLocale` और `mode` शामिल हैं
+- `prefix` और `localePrefix` गुणों वाला एक ऑब्जेक्ट लौटाता है
+- सभी रूटिंग मोड का समर्थन करता है: `prefix-no-default`, `prefix-all`, `no-prefix`, और `search-params`
+- locale प्रीफ़िक्स जोड़ने के समय निर्धारित करने के लिए हल्का उपयोगिता
+
+---
+
+## फ़ंक्शन सिग्नेचर
+
+```typescript
+getPrefix(
+  locale: Locales,               // आवश्यक
+  options?: {                    // वैकल्पिक
+    defaultLocale?: Locales;
+    mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';
+  }
+): GetPrefixResult
+
+type GetPrefixResult = {
+  prefix: string;   // उदाहरण के लिए, 'fr/' या ''
+  localePrefix?: Locale; // उदाहरण के लिए, 'fr' या undefined
+}
+```
+
+---
+
+## पैरामीटर
+
+- `locale: Locales`
+  - **विवरण**: उस locale के लिए prefix उत्पन्न करने के लिए। यदि मान falsy है (undefined, null, खाली स्ट्रिंग), तो फ़ंक्शन एक खाली स्ट्रिंग लौटाता है।
+  - **प्रकार**: `Locales`
+  - **आवश्यक**: हाँ
+
+- `options?: object`
+  - **विवरण**: prefix निर्धारण के लिए कॉन्फ़िगरेशन ऑब्जेक्ट।
+  - **प्रकार**: `object`
+  - **आवश्यक**: नहीं (वैकल्पिक)
+
+  - `options.defaultLocale?: Locales`
+    - **विवरण**: एप्लिकेशन के लिए डिफ़ॉल्ट locale। यदि प्रदान नहीं किया गया है, तो आपके प्रोजेक्ट कॉन्फ़िगरेशन से कॉन्फ़िगर किया गया डिफ़ॉल्ट locale उपयोग किया जाता है।
+    - **प्रकार**: `Locales`
+    - **डिफ़ॉल्ट**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/configuration.md#middleware)
+
+  - `options.mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **विवरण**: locale हैंडलिंग के लिए URL रूटिंग मोड। यदि प्रदान नहीं किया गया है, तो आपके प्रोजेक्ट कॉन्फ़िगरेशन से कॉन्फ़िगर किया गया मोड उपयोग किया जाता है।
+    - **प्रकार**: `'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **डिफ़ॉल्ट**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/configuration.md#middleware)
+    - **मोड्स**:
+      - `prefix-no-default`: जब locale डिफ़ॉल्ट locale से मेल खाता है तो खाली स्ट्रिंग लौटाता है
+      - `prefix-all`: सभी locales के लिए prefix लौटाता है जिसमें डिफ़ॉल्ट भी शामिल है
+      - `no-prefix`: खाली स्ट्रिंग लौटाता है (URLs में कोई prefix नहीं)
+      - `search-params`: खाली स्ट्रिंग लौटाता है (locale क्वेरी पैरामीटर में)
+
+### Returns
+
+- **प्रकार**: `GetPrefixResult`
+- **विवरण**: एक ऑब्जेक्ट जिसमें तीन अलग-अलग prefix फॉर्मेट शामिल हैं:
+  - `prefix`: ट्रेलिंग स्लैश के साथ पाथ प्रीफिक्स (जैसे, `'fr/'`, `''`)
+  - `localePrefix`: स्लैश के बिना locale पहचानकर्ता (जैसे, `'fr'`, `undefined`)
+
+---
+
+## उदाहरण उपयोग
+
+### बुनियादी उपयोग
+
+```typescript codeFormat="typescript"
+import { getPrefix, Locales } from "intlayer";
+
+// अंग्रेज़ी locale के लिए प्रीफिक्स जांचें
+getPrefix(Locales.ENGLISH, {
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-all",
+});
+// लौटाता है: { prefix: 'en/', localePrefix: 'en' }
+
+// फ्रेंच locale के लिए प्रीफिक्स जांचें
+getPrefix(Locales.FRENCH, {
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-no-default",
+});
+// लौटाता है: { prefix: 'fr/', localePrefix: 'fr' }
+```
+
+```javascript codeFormat="esm"
+import { getPrefix, Locales } from "intlayer";
+
+getPrefix(Locales.ENGLISH, { mode: "prefix-all" });
+javascript codeFormat="esm"
+import { getPrefix, Locales } from "intlayer";
+
+getPrefix(Locales.ENGLISH, { mode: "prefix-all" });
+// लौटाता है: { prefix: '', localePrefix: undefined }
+```
+
+```javascript codeFormat="commonjs"
+const { getPrefix, Locales } = require("intlayer");
+
+getPrefix(Locales.ENGLISH, { mode: "prefix-all" });
+// लौटाता है: { prefix: '', localePrefix: undefined }
+```
+
+### विभिन्न रूटिंग मोड्स
+
+```typescript
+import { getPrefix, Locales } from "intlayer";
+
+// prefix-all: हमेशा प्रीफिक्स लौटाता है
+getPrefix(Locales.ENGLISH, {
+  mode: "prefix-all",
+  defaultLocale: Locales.ENGLISH,
+});
+// लौटाता है: { prefix: '/en', localePrefix: 'en' }
+
+// prefix-no-default: जब locale डिफ़ॉल्ट से मेल खाता है तो कोई प्रीफिक्स नहीं
+getPrefix(Locales.ENGLISH, {
+  mode: "prefix-no-default",
+  defaultLocale: Locales.ENGLISH,
+});
+// लौटाता है: { prefix: '', localePrefix: undefined }
+
+// prefix-no-default: जब locale डिफ़ॉल्ट से भिन्न हो तो प्रीफिक्स लौटाता है
+getPrefix(Locales.FRENCH, {
+  mode: "prefix-no-default",
+  defaultLocale: Locales.ENGLISH,
+});
+// लौटाता है: { prefix: 'fr/', localePrefix: 'fr' }
+
+// no-prefix & search-params: कभी भी प्रीफिक्स नहीं लौटाता
+getPrefix(Locales.ENGLISH, { mode: "no-prefix" });
+// लौटाता है: { prefix: '', localePrefix: undefined }
+
+getPrefix(Locales.ENGLISH, { mode: "search-params" });
+// लौटाता है: { prefix: '', localePrefix: undefined }
+```
+
+### व्यावहारिक उदाहरण
+
+```typescript
+import { getPrefix, Locales } from "intlayer";
+
+// किसी विशिष्ट locale के लिए उपयुक्त प्रीफिक्स के साथ URLs बनाएं
+const locale = Locales.FRENCH;
+const { prefix, localePrefix } = getPrefix(locale, {
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-no-default",
+});
+
+// पथ निर्माण के लिए प्रीफिक्स का उपयोग करना
+const url1 = `/${prefix}about`.replace(/\/+/g, "/");
+// परिणाम: "/fr/about"
+
+// localePrefix का उपयोग locale पहचान के लिए
+console.log(`वर्तमान locale: ${localePrefix}`);
+// आउटपुट: "वर्तमान locale: fr"
+```
+
+---
+
+## संबंधित फ़ंक्शन
+
+- [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/getLocalizedUrl.md): एक विशिष्ट locale के लिए स्थानीयकृत URL उत्पन्न करता है
+- [`getMultilingualUrls`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/getMultilingualUrls.md): सभी कॉन्फ़िगर किए गए locales के लिए URLs उत्पन्न करता है
+
+---
+
+## TypeScript
+
+```typescript
+type GetPrefixResult = {
+  prefix: string; // ट्रेलिंग स्लैश के साथ पथ प्रीफिक्स (जैसे, 'fr/' या '')
+  localePrefix?: Locale; // स्लैश के बिना locale पहचानकर्ता (जैसे, 'fr' या undefined)
+};
+
+function getPrefix(
+  locale: Locales,
+  options?: {
+    defaultLocale?: Locales;
+    mode?: "prefix-no-default" | "prefix-all" | "no-prefix" | "search-params";
+  }
+): GetPrefixResult;
+```

package/docs/id/cli/build.md

@@ -0,0 +1,64 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Bangun Kamus
+description: Pelajari cara membangun kamus Intlayer Anda dari file deklarasi konten.
+keywords:
+  - Bangun
+  - Kamus
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - build
+---
+
+# Bangun Kamus
+
+Untuk membangun kamus Anda, Anda dapat menjalankan perintah:
+
+```bash
+npx intlayer build
+```
+
+atau dalam mode watch
+
+```bash
+npx intlayer build --watch
+```
+
+Perintah ini akan mencari file deklarasi konten Anda secara default di `./src/**/*.content.{ts|js|mjs|cjs|json|tsx|jsx}`. Dan membangun kamus di direktori `.intlayer`.
+
+## Alias:
+
+- `npx intlayer dictionaries build`
+- `npx intlayer dictionary build`
+- `npx intlayer dic build`
+
+## Argumen:
+
+- **`--base-dir`**: Tentukan direktori dasar untuk proyek. Untuk mengambil konfigurasi intlayer, perintah akan mencari file `intlayer.config.{ts,js,json,cjs,mjs}` di direktori dasar.
+
+  > Contoh: `npx intlayer build --base-dir ./src`
+
+- **`--env`**: Tentukan lingkungan (misalnya, `development`, `production`). Berguna jika Anda menggunakan variabel lingkungan dalam file konfigurasi intlayer Anda.
+
+  > Contoh: `npx intlayer build --env production`
+
+- **`--env-file`**: Sediakan file lingkungan khusus untuk memuat variabel. Berguna jika Anda menggunakan variabel lingkungan dalam file konfigurasi intlayer Anda.
+
+  > Contoh: `npx intlayer build --env-file .env.production.local`
+
+- **`--with`**: Mulai perintah secara paralel dengan proses build.
+
+  > Contoh: `npx intlayer build --with "next dev --turbopack"`
+
+- **`--skip-prepare`**: Lewati langkah prepare.
+
+  > Contoh: `npx intlayer build --skip-prepare`
+
+- **`--no-cache`**: Nonaktifkan cache.
+
+  > Contoh: `npx intlayer build --no-cache`

package/docs/id/cli/configuration.md

@@ -0,0 +1,62 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Kelola Konfigurasi
+description: Pelajari cara mendapatkan dan mengirim konfigurasi Intlayer Anda ke CMS.
+keywords:
+  - Konfigurasi
+  - Config
+  - CLI
+  - Intlayer
+  - CMS
+slugs:
+  - doc
+  - concept
+  - cli
+  - configuration
+---
+
+# Kelola Konfigurasi
+
+## Dapatkan Konfigurasi
+
+Perintah `configuration get` mengambil konfigurasi saat ini untuk Intlayer, khususnya pengaturan locale. Ini berguna untuk memverifikasi pengaturan Anda.
+
+```bash
+npx intlayer configuration get
+```
+
+## Alias:
+
+- `npx intlayer config get`
+- `npx intlayer conf get`
+
+## Argumen:
+
+- **`--env`**: Tentukan environment (misalnya, `development`, `production`).
+- **`--env-file`**: Berikan file environment kustom untuk memuat variabel dari file tersebut.
+- **`--base-dir`**: Tentukan direktori dasar untuk proyek.
+- **`--verbose`**: Aktifkan logging verbose untuk debugging. (default true menggunakan CLI)
+- **`--no-cache`**: Nonaktifkan cache.
+
+## Kirim Konfigurasi
+
+Perintah `configuration push` mengunggah konfigurasi Anda ke Intlayer CMS dan editor. Langkah ini diperlukan untuk mengaktifkan penggunaan kamus jarak jauh di Intlayer Visual Editor.
+
+```bash
+npx intlayer configuration push
+```
+
+## Alias:
+
+- `npx intlayer config push`
+- `npx intlayer conf push`
+
+## Argumen:
+
+- **`--env`**: Tentukan environment (misalnya, `development`, `production`).
+- **`--env-file`**: Berikan file environment kustom untuk memuat variabel dari.
+- **`--verbose`**: Aktifkan logging verbose untuk debugging. (default true menggunakan CLI)
+- **`--no-cache`**: Nonaktifkan cache.
+
+Dengan mengirim konfigurasi, proyek Anda sepenuhnya terintegrasi dengan Intlayer CMS, memungkinkan manajemen kamus yang mulus di seluruh tim.

package/docs/id/cli/debug.md

@@ -0,0 +1,46 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Debug Perintah Intlayer
+description: Pelajari cara melakukan debug dan memecahkan masalah CLI Intlayer.
+keywords:
+  - Debug
+  - Memecahkan Masalah
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - debug
+---
+
+# Debug perintah intlayer
+
+## 1. **Pastikan Anda menggunakan versi terbaru**
+
+Jalankan:
+
+```bash
+npx intlayer --version                  # versi intlayer lokal saat ini
+npx intlayer@latest --version           # versi intlayer terbaru saat ini
+```
+
+## 2. **Periksa apakah perintah sudah terdaftar**
+
+Anda dapat memeriksa dengan:
+
+```bash
+npx intlayer --help                     # Menampilkan daftar perintah yang tersedia dan informasi penggunaan
+npx intlayer dictionary build --help    # Menampilkan daftar opsi yang tersedia untuk sebuah perintah
+```
+
+## 3. **Restart terminal Anda**
+
+Terkadang restart terminal diperlukan agar perintah baru dikenali.
+
+## 4. **Bersihkan cache npx (jika Anda terjebak dengan versi lama)**
+
+```bash
+npx clear-npx-cache
+```

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

@@ -0,0 +1,43 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Tinjau Dokumen
+description: Pelajari cara meninjau file dokumentasi untuk kualitas, konsistensi, dan kelengkapan di berbagai lokal.
+keywords:
+  - Tinjau
+  - Dokumen
+  - Dokumentasi
+  - AI
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - doc-review
+---
+
+# Tinjau Dokumen
+
+Perintah `doc review` menganalisis file dokumentasi untuk kualitas, konsistensi, dan kelengkapan di berbagai lokal.
+
+```bash
+npx intlayer doc review
+```
+
+Perintah ini dapat digunakan untuk meninjau file yang sudah diterjemahkan, dan untuk memeriksa apakah terjemahannya sudah benar.
+
+Untuk sebagian besar kasus penggunaan,
+
+- lebih baik menggunakan `doc translate` ketika versi terjemahan dari file ini belum tersedia.
+- lebih baik menggunakan `doc review` ketika versi terjemahan dari file ini sudah ada.
+
+> Perlu dicatat bahwa proses review mengonsumsi lebih banyak token entri dibandingkan proses translate untuk meninjau file yang sama secara keseluruhan. Namun, proses review akan mengoptimalkan chunk yang ditinjau, dan akan melewati bagian yang tidak berubah.
+
+## Argumen:
+
+Perintah `doc review` menerima argumen yang sama seperti `doc translate`, memungkinkan Anda untuk meninjau file dokumentasi tertentu dan menerapkan pemeriksaan kualitas.
+
+Jika Anda mengaktifkan salah satu opsi git, perintah hanya akan meninjau bagian dari file yang mengalami perubahan. Skrip akan memproses dengan membagi file menjadi chunk dan meninjau setiap chunk. Jika tidak ada perubahan pada chunk tersebut, skrip akan melewatinya untuk mempercepat proses review dan membatasi biaya API Penyedia AI.
+
+- Untuk daftar lengkap argumen, lihat dokumentasi perintah [Translate Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/cli/doc-translate.md).

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

@@ -0,0 +1,132 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Terjemahkan Dokumen
+description: Pelajari cara menerjemahkan file dokumentasi secara otomatis menggunakan layanan terjemahan AI.
+keywords:
+  - Terjemahkan
+  - Dokumen
+  - Dokumentasi
+  - AI
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - doc-translate
+---
+
+# Terjemahkan Dokumen
+
+Perintah `doc translate` secara otomatis menerjemahkan file dokumentasi dari locale dasar ke locale target menggunakan layanan terjemahan AI.
+
+```bash
+npx intlayer doc translate
+```
+
+## Argumen:
+
+**Opsi daftar file:**
+
+- **`--doc-pattern [docPattern...]`**: Pola glob untuk mencocokkan file dokumentasi yang akan diterjemahkan.
+
+  > Contoh: `npx intlayer doc translate --doc-pattern "docs/**/*.md" "src/**/*.mdx"`
+
+- **`--excluded-glob-pattern [excludedGlobPattern...]`**: Pola glob untuk mengecualikan file dari penerjemahan.
+
+  > Contoh: `npx intlayer doc translate --excluded-glob-pattern "docs/internal/**"`
+
+- **`--skip-if-modified-before [skipIfModifiedBefore]`**: Lewati file jika telah dimodifikasi sebelum waktu yang diberikan.
+  - Bisa berupa waktu absolut seperti "2025-12-05" (string atau Date)
+  - Bisa berupa waktu relatif dalam ms `1 * 60 * 60 * 1000` (1 jam)
+  - Opsi ini memeriksa waktu pembaruan file menggunakan metode `fs.stat`. Jadi bisa terpengaruh oleh Git atau alat lain yang memodifikasi file.
+
+  > Contoh: `npx intlayer doc translate --skip-if-modified-before "2025-12-05"`
+
+- **`--skip-if-modified-after [skipIfModifiedAfter]`**: Lewati file jika telah dimodifikasi dalam waktu yang diberikan.
+  - Bisa berupa waktu absolut seperti "2025-12-05" (string atau Date)
+  - Bisa berupa waktu relatif dalam ms `1 * 60 * 60 * 1000` (1 jam)
+  - Opsi ini memeriksa waktu pembaruan file menggunakan metode `fs.stat`. Jadi bisa terpengaruh oleh Git atau alat lain yang memodifikasi file.
+
+  > Contoh: `npx intlayer doc translate --skip-if-modified-after "2025-12-05"`
+
+- **`--skip-if-exists`**: Lewati file jika file tersebut sudah ada.
+
+  > Contoh: `npx intlayer doc translate --skip-if-exists`
+
+**Opsi output entri:**
+
+- **`--locales [locales...]`**: Lokalisasi target untuk menerjemahkan dokumentasi.
+
+  > Contoh: `npx intlayer doc translate --locales fr es de`
+
+- **`--base-locale [baseLocale]`**: Lokalisasi sumber untuk diterjemahkan dari.
+
+  > Contoh: `npx intlayer doc translate --base-locale en`
+
+**Opsi pemrosesan file:**
+
+- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: Jumlah file yang diproses secara bersamaan untuk penerjemahan.
+
+  > Contoh: `npx intlayer doc translate --nb-simultaneous-file-processed 5`
+
+**Opsi AI:**
+
+- **`--model [model]`**: Model AI yang digunakan untuk penerjemahan (misalnya, `gpt-3.5-turbo`).
+- **`--provider [provider]`**: Penyedia AI yang digunakan untuk penerjemahan.
+- **`--temperature [temperature]`**: Pengaturan temperature untuk model AI.
+- **`--api-key [apiKey]`**: Berikan API key Anda sendiri untuk layanan AI.
+- **`--application-context [applicationContext]`**: Berikan konteks tambahan untuk penerjemahan AI.
+- **`--custom-prompt [prompt]`**: Sesuaikan prompt dasar yang digunakan untuk penerjemahan. (Catatan: Untuk sebagian besar kasus penggunaan, opsi `--custom-instructions` lebih disarankan karena memberikan kontrol yang lebih baik atas perilaku penerjemahan.)
+
+  > Contoh: `npx intlayer doc translate --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "My application is a cat store"`
+
+**Opsi variabel lingkungan:**
+
+- **`--env`**: Tentukan lingkungan (misalnya, `development`, `production`).
+- **`--env-file [envFile]`**: Berikan file lingkungan khusus untuk memuat variabel.
+- **`--base-dir`**: Tentukan direktori dasar untuk proyek.
+- **`--no-cache`**: Nonaktifkan cache.
+
+  > Contoh: `npx intlayer doc translate --base-dir ./docs --env-file .env.production.local`
+
+**Opsi log:**
+
+- **`--verbose`**: Aktifkan logging verbose untuk debugging. (default true saat menggunakan CLI)
+
+  > Contoh: `npx intlayer doc translate --verbose`
+
+**Opsi instruksi khusus:**
+
+- **`--custom-instructions [customInstructions]`**: Instruksi khusus yang ditambahkan ke prompt. Berguna untuk menerapkan aturan spesifik terkait format, penerjemahan URL, dll.
+  - Bisa berupa waktu absolut seperti "2025-12-05" (string atau Date)
+  - Bisa berupa waktu relatif dalam ms `1 * 60 * 60 * 1000` (1 jam)
+  - Opsi ini memeriksa waktu pembaruan file menggunakan metode `fs.stat`. Jadi bisa terpengaruh oleh Git atau alat lain yang memodifikasi file.
+
+  > Contoh: `npx intlayer doc translate --custom-instructions "Hindari menerjemahkan url, dan pertahankan format markdown"`
+
+  > Contoh: `npx intlayer doc translate --custom-instructions "$(cat ./instructions.md)"`
+
+**Opsi Git:**
+
+- **`--git-diff`**: Hanya jalankan pada kamus yang mencakup perubahan dari base (default `origin/main`) ke cabang saat ini (default: `HEAD`).
+- **`--git-diff-base`**: Tentukan referensi base untuk git diff (default `origin/main`).
+- **`--git-diff-current`**: Tentukan referensi saat ini untuk git diff (default: `HEAD`).
+- **`--uncommitted`**: Sertakan perubahan yang belum dikomit.
+- **`--unpushed`**: Sertakan perubahan yang belum dipush.
+- **`--untracked`**: Sertakan file yang belum terlacak.
+
+  > Contoh: `npx intlayer doc translate --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Contoh: `npx intlayer doc translate --uncommitted --unpushed --untracked`
+
+> Perlu diperhatikan bahwa jalur file keluaran akan ditentukan dengan mengganti pola-pola berikut
+>
+> - `/{{baseLocale}}/` menjadi `/{{locale}}/` (Unix)
+> - `\{{baseLocale}}\` menjadi `\{{locale}}\` (Windows)
+> - `_{{baseLocale}}.` menjadi `_{{locale}}.`
+> - `{{baseLocale}}_` menjadi `{{locale}}_`
+> - `.{{baseLocaleName}}.` menjadi `.{{localeName}}.`
+>
+> Jika pola tidak ditemukan, file keluaran akan menambahkan `.{{locale}}` pada ekstensi file. Misalnya `./my/file.md` akan diterjemahkan menjadi `./my/file.fr.md` untuk locale Prancis.

package/docs/id/cli/editor.md

@@ -0,0 +1,28 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Perintah Editor
+description: Pelajari cara menggunakan perintah editor Intlayer.
+keywords:
+  - Editor
+  - Visual Editor
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - editor
+---
+
+# Perintah editor
+
+Perintah `editor` membungkus ulang perintah `intlayer-editor`.
+
+> Untuk dapat menggunakan perintah `editor`, paket `intlayer-editor` harus diinstal. (Lihat [Intlayer Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/intlayer_visual_editor.md))
+
+```json fileName="package.json"
+"scripts": {
+  "intlayer:editor:start": "npx intlayer editor start --with 'next dev --turbopack'"
+}
+```