@intlayer/docs 7.5.10 → 7.5.12

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

@@ -108,18 +108,22 @@ syncJSON({
   source: ({ key, locale }) => string, // आवश्यक
   location?: string, // वैकल्पिक लेबल, डिफ़ॉल्ट: "plugin"
   priority?: number, // संघर्ष समाधान के लिए वैकल्पिक प्राथमिकता, डिफ़ॉल्ट: 0
-  format?: 'intlayer' | 'icu' | 'i18next', // वैकल्पिक फ़ॉर्मेटर, डिफ़ॉल्ट: 'intlayer'
+  format?: 'intlayer' | 'icu' | 'i18next', // वैकल्पिक फ़ॉर्मेटर, Intlayer रनटाइम संगतता के लिए उपयोग किया जाता है
 });
 ```
 
 #### `format` ('intlayer' | 'icu' | 'i18next')
 
-JSON फ़ाइलों को सिंक्रनाइज़ करते समय शब्दकोश सामग्री के लिए उपयोग किए जाने वाले फ़ॉर्मेटर को निर्दिष्ट करता है। यह विभिन्न i18n लाइब्रेरी के साथ संगत विभिन्न संदेश फ़ॉर्मेटिंग सिंटैक्स का उपयोग करने की अनुमति देता है।
+JSON फ़ाइलों को सिंक्रनाइज़ करते समय शब्दकोश सामग्री के लिए उपयोग किए जाने वाले फ़ॉर्मेटर को निर्दिष्ट करता है। यह Intlayer रनटाइम के साथ संगत विभिन्न संदेश फ़ॉर्मेटिंग सिंटैक्स का उपयोग करने की अनुमति देता है।
 
+- `undefined`: कोई फ़ॉर्मेटर उपयोग नहीं किया जाएगा, JSON सामग्री जैसी है वैसी ही उपयोग की जाएगी।
 - `'intlayer'`: डिफ़ॉल्ट Intlayer फ़ॉर्मेटर (डिफ़ॉल्ट)।
 - `'icu'`: ICU संदेश फ़ॉर्मेटिंग का उपयोग करता है (react-intl, vue-i18n जैसी लाइब्रेरी के साथ संगत)।
 - `'i18next'`: i18next संदेश फ़ॉर्मेटिंग का उपयोग करता है (i18next, next-i18next, Solid-i18next के साथ संगत)।
 
+> ध्यान दें कि फ़ॉर्मेटर का उपयोग करने से आपकी JSON सामग्री इनपुट और आउटपुट में रूपांतरित हो जाएगी। ICU बहुवचन जैसे जटिल JSON नियमों के लिए, पार्सिंग इनपुट और आउटपुट के बीच 1 से 1 मैपिंग की गारंटी नहीं दे सकता।
+> यदि आप Intlayer रनटाइम का उपयोग नहीं करते हैं, तो आप फ़ॉर्मेटर सेट न करना पसंद कर सकते हैं।
+
 **उदाहरण:**
 
 ```ts

package/docs/id/cli/ci.md

@@ -0,0 +1,137 @@
+---
+createdAt: 2026-01-06
+updatedAt: 2026-01-06
+title: Perintah CI
+description: Pelajari cara menggunakan perintah Intlayer CI untuk menjalankan perintah Intlayer dengan kredensial yang disuntikkan otomatis di pipeline CI/CD dan monorepo.
+keywords:
+  - CI
+  - CI/CD
+  - Otomasi
+  - Monorepo
+  - Kredensial
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - ci
+history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Tambahkan perintah CI
+---
+
+# Perintah CI
+
+```bash
+npx intlayer ci <command...>
+```
+
+Perintah CI dirancang untuk otomasi dan pipeline CI/CD. Perintah ini secara otomatis menyuntikkan kredensial dari variabel lingkungan `INTLAYER_PROJECT_CREDENTIALS` dan dapat menjalankan perintah Intlayer di beberapa proyek dalam monorepo.
+
+## Cara kerja
+
+Perintah CI beroperasi dalam dua mode:
+
+1. **Mode Proyek Tunggal**: Jika direktori kerja saat ini cocok dengan salah satu jalur proyek di `INTLAYER_PROJECT_CREDENTIALS`, perintah akan dijalankan hanya untuk proyek spesifik tersebut.
+
+2. **Mode Iterasi**: Jika tidak ada konteks proyek spesifik yang terdeteksi, perintah akan mengiterasi semua proyek yang dikonfigurasi dan menjalankan perintah untuk masing-masing.
+
+## Variabel Lingkungan
+
+Perintah memerlukan variabel lingkungan `INTLAYER_PROJECT_CREDENTIALS` untuk disetel. Variabel ini harus berisi objek JSON yang memetakan jalur proyek ke kredensialnya:
+
+```json
+{
+  "packages/app": {
+    "clientId": "your-client-id-1",
+    "clientSecret": "your-client-secret-1"
+  },
+  "packages/admin": {
+    "clientId": "your-client-id-2",
+    "clientSecret": "your-client-secret-2"
+  }
+}
+```
+
+## Deteksi Package Manager
+
+Perintah CI secara otomatis mendeteksi package manager yang digunakan (npm, yarn, pnpm, atau bun) berdasarkan variabel lingkungan `npm_config_user_agent` dan menggunakan perintah yang sesuai untuk mengeksekusi Intlayer.
+
+## Argumen
+
+- **`<command...>`**: Perintah Intlayer yang akan dieksekusi (misalnya, `fill`, `push`, `build`). Anda dapat meneruskan perintah Intlayer apa pun dan argumennya.
+
+  > Contoh: `npx intlayer ci fill --verbose`
+  >
+  > Contoh: `npx intlayer ci push`
+  >
+  > Contoh: `npx intlayer ci build --watch`
+
+## Contoh
+
+### Menjalankan perintah dalam mode proyek tunggal
+
+Jika Anda berada di direktori proyek yang cocok dengan salah satu jalur di `INTLAYER_PROJECT_CREDENTIALS`:
+
+```bash
+cd packages/app
+npx intlayer ci fill
+```
+
+Ini akan menjalankan perintah `fill` dengan kredensial yang secara otomatis disuntikkan untuk proyek `packages/app`.
+
+### Menjalankan perintah di semua proyek
+
+Jika Anda berada di direktori yang tidak cocok dengan jalur proyek mana pun, perintah akan mengiterasi semua proyek yang dikonfigurasi:
+
+```bash
+cd /path/to/monorepo
+npx intlayer ci push
+```
+
+Ini akan menjalankan perintah `push` untuk setiap proyek yang dikonfigurasi di `INTLAYER_PROJECT_CREDENTIALS`.
+
+### Meneruskan flag tambahan
+
+Anda dapat meneruskan flag apa pun ke perintah Intlayer yang mendasarinya:
+
+```bash
+npx intlayer ci fill --verbose --mode complete
+```
+
+### Menggunakan di pipeline CI/CD
+
+Dalam konfigurasi CI/CD Anda (misalnya, GitHub Actions, GitLab CI), setel `INTLAYER_PROJECT_CREDENTIALS` sebagai rahasia:
+
+```yaml
+# Contoh GitHub Actions
+env:
+  INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}
+
+steps:
+  - name: Isi kamus
+    run: npx intlayer ci fill
+```
+
+## Penanganan Kesalahan
+
+- Jika `INTLAYER_PROJECT_CREDENTIALS` tidak disetel, perintah akan keluar dengan kesalahan.
+- Jika `INTLAYER_PROJECT_CREDENTIALS` bukan JSON yang valid, perintah akan keluar dengan kesalahan.
+- Jika jalur proyek tidak ada, akan dilewati dengan peringatan.
+- Jika proyek mana pun gagal, perintah akan keluar dengan kode status bukan nol.
+
+## Kasus Penggunaan
+
+- **Otomasi monorepo**: Menjalankan perintah Intlayer di beberapa proyek dalam monorepo
+- **Pipeline CI/CD**: Mengotomatisasi manajemen kamus dalam alur kerja integrasi berkelanjutan
+- **Operasi massal**: Melakukan operasi yang sama pada beberapa proyek Intlayer sekaligus
+- **Manajemen rahasia**: Mengelola kredensial dengan aman untuk beberapa proyek menggunakan variabel lingkungan
+
+## Praktik Keamanan Terbaik
+
+- Simpan `INTLAYER_PROJECT_CREDENTIALS` sebagai rahasia terenkripsi di platform CI/CD Anda
+- Jangan pernah melakukan commit kredensial ke kontrol versi
+- Gunakan kredensial khusus lingkungan untuk berbagai lingkungan deployment
+- Putar kredensial secara teratur

package/docs/id/cli/index.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-12-30
+updatedAt: 2026-01-06
 title: CLI
 description: Temukan cara menggunakan Intlayer CLI untuk mengelola situs web multibahasa Anda. Ikuti langkah-langkah dalam dokumentasi daring ini untuk mengatur proyek Anda dalam beberapa menit.
 keywords:
@@ -17,6 +17,9 @@ slugs:
   - concept
   - cli
 history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Menambahkan perintah projects list
   - version: 7.5.9
     date: 2025-12-30
     changes: Menambahkan perintah init
@@ -119,6 +122,7 @@ Untuk melihat cara mengonfigurasi locale yang tersedia, atau parameter lainnya,
 - **[Bangun Kamus](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/cli/build.md)** - Bangun kamus Anda dari file deklarasi konten
 - **[Pantau Kamus](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/cli/watch.md)** - Pantau perubahan dan bangun kamus secara otomatis
 - **[Periksa Versi CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/cli/version.md)** - Periksa versi Intlayer CLI yang terpasang
+- **[Daftar Proyek](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/cli/list_projects.md)** - Daftar semua proyek Intlayer dalam direktori atau repositori git
 
 ### Manajemen Kamus
 
@@ -166,6 +170,7 @@ Untuk melihat cara mengonfigurasi locale yang tersedia, atau parameter lainnya,
   "intlayer:list": "npx intlayer content list",
   "intlayer:test": "npx intlayer content test",
   "intlayer:transform": "npx intlayer transform",
+  "intlayer:projects": "npx intlayer projects list",
   "intlayer:doc:translate": "npx intlayer doc translate",
   "intlayer:doc:review": "npx intlayer doc review"
 }
@@ -175,3 +180,4 @@ Untuk melihat cara mengonfigurasi locale yang tersedia, atau parameter lainnya,
 >
 > - `npx intlayer list` sebagai pengganti `npx intlayer content list`
 > - `npx intlayer test` sebagai pengganti `npx intlayer content test`
+> - `npx intlayer projects-list` atau `npx intlayer pl` sebagai pengganti `npx intlayer projects list`

package/docs/id/cli/list.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-01-06
 title: Daftar File Deklarasi Konten
 description: Pelajari cara mendaftar semua file deklarasi konten dalam proyek Anda.
 keywords:
@@ -13,6 +13,13 @@ slugs:
   - concept
   - cli
   - list
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: Menambahkan opsi output absolut ke perintah list
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Menambahkan opsi output JSON ke perintah list
 ---
 
 # Daftar file deklarasi konten
@@ -27,14 +34,36 @@ npx intlayer content list
 
 Perintah ini menampilkan semua file deklarasi konten dalam proyek Anda, menunjukkan kunci kamus dan jalur file mereka. Ini berguna untuk mendapatkan gambaran semua file konten Anda dan memverifikasi bahwa mereka ditemukan dengan benar oleh Intlayer.
 
+## Argumen:
+
+- **`--json`**: Menampilkan hasil sebagai JSON alih-alih teks yang diformat. Berguna untuk scripting dan akses programatik.
+
+  > Contoh: `npx intlayer content list --json`
+
 ## Contoh:
 
+### Daftar file deklarasi konten:
+
 ```bash
 npx intlayer content list
 ```
 
+### Output sebagai JSON:
+
+```bash
+npx intlayer content list --json
+```
+
+### Output sebagai jalur absolut:
+
+```bash
+npx intlayer content list --absolute
+```
+
 ## Contoh output:
 
+### Output yang diformat:
+
 ```bash
 npx intlayer content list
 Content declaration files:
@@ -45,6 +74,14 @@ Content declaration files:
 Total file deklarasi konten: 3
 ```
 
+### Output JSON:
+
+```bash
+$ npx intlayer content list --json
+
+[{"key":"home-page","path":"src/components/HomePage/homePage.content.ts"},{"key":"server-component","path":"src/components/ServerComponent/serverComponent.content.ts"},{"key":"client-component","path":"src/components/ClientComponent/clientComponent.content.ts"}]
+```
+
 Perintah ini akan menampilkan:
 
 - Daftar terformat dari semua file deklarasi konten dengan kunci dan jalur file relatifnya

package/docs/id/cli/list_projects.md

@@ -0,0 +1,128 @@
+---
+createdAt: 2025-12-30
+updatedAt: 2026-01-06
+title: Daftar Proyek Intlayer
+description: Pelajari cara mendaftarkan semua proyek Intlayer di sebuah direktori atau repositori git.
+keywords:
+  - Daftar
+  - Proyek
+  - CLI
+  - Intlayer
+  - Git
+slugs:
+  - doc
+  - concept
+  - cli
+  - list-projects
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: Tambahkan opsi output absolut ke perintah list projects
+---
+
+# Daftar Proyek Intlayer
+
+```bash
+npx intlayer projects list
+```
+
+Perintah ini mencari dan menampilkan semua proyek Intlayer dengan menemukan direktori yang berisi berkas konfigurasi Intlayer. Ini berguna untuk menemukan semua proyek Intlayer dalam monorepo, workspace, atau repositori git.
+
+## Alias:
+
+- `npx intlayer projects-list`
+- `npx intlayer pl`
+
+## Argumen:
+
+- **`--base-dir [path]`**: Tentukan direktori dasar untuk memulai pencarian. Secara default adalah direktori kerja saat ini.
+
+  > Contoh: `npx intlayer projects list --base-dir /path/to/workspace`
+
+- **`--git-root`**: Cari dari direktori root git alih-alih direktori dasar. Ini berguna untuk menemukan semua proyek Intlayer dalam monorepo atau repositori git.
+
+  > Contoh: `npx intlayer projects list --git-root`
+
+- **`--json`**: Menampilkan hasil sebagai JSON alih-alih teks yang diformat. Berguna untuk scripting dan akses programatik.
+
+  > Contoh: `npx intlayer projects list --json`
+
+- **`--absolute`**: Menampilkan hasil sebagai jalur absolut alih-alih jalur relatif.
+
+  > Contoh: `npx intlayer projects list --absolute`
+
+## Cara kerjanya:
+
+Perintah ini mencari berkas konfigurasi Intlayer di direktori yang ditentukan (atau root git jika `--git-root` digunakan). Ia mencari pola berkas konfigurasi berikut:
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+Setiap direktori yang berisi salah satu berkas ini dianggap sebagai proyek Intlayer dan akan ditampilkan dalam output.
+
+## Contoh:
+
+### Daftar proyek di direktori saat ini:
+
+```bash
+npx intlayer projects list
+```
+
+### Daftar proyek di direktori tertentu:
+
+```bash
+npx intlayer projects list --base-dir ./packages
+```
+
+### Daftar semua proyek di repositori git:
+
+```bash
+npx intlayer projects list --git-root
+```
+
+### Menggunakan alias pintas:
+
+```bash
+npx intlayer pl --git-root
+```
+
+### Output sebagai JSON:
+
+```bash
+npx intlayer projects list --json
+```
+
+## Contoh output:
+
+### Output yang diformat:
+
+```bash
+$ npx intlayer projects list --git-root
+
+Found 3 Intlayer project(s):
+
+  - /Users/user/workspace/packages/app
+  - /Users/user/workspace/packages/admin
+  - /Users/user/workspace/packages/shared
+```
+
+### Output JSON:
+
+```bash
+$ npx intlayer projects list --json
+
+["/Users/user/workspace/packages/app","/Users/user/workspace/packages/admin","/Users/user/workspace/packages/shared"]
+```
+
+## Kasus penggunaan:
+
+- **Manajemen monorepo**: Temukan semua proyek Intlayer dalam struktur monorepo
+- **Penemuan proyek**: Temukan semua proyek yang mendukung Intlayer di sebuah workspace
+- **CI/CD**: Verifikasi proyek Intlayer dalam alur kerja otomatis
+- **Dokumentasi**: Hasilkan dokumentasi yang mencantumkan semua proyek yang menggunakan Intlayer
+
+Keluaran menyediakan jalur absolut ke setiap direktori proyek, sehingga mudah untuk menavigasi atau membuat skrip operasi pada beberapa proyek Intlayer.

package/docs/id/intlayer_CMS.md

@@ -77,6 +77,26 @@ Untuk integrasi dengan Vite + React, lihat [panduan pengaturan](https://github.c
 
 ## Konfigurasi
 
+Jalankan perintah berikut untuk masuk ke Intlayer CMS:
+
+```bash packageManager="npm"
+npx intlayer login
+```
+
+```bash packageManager="yarn"
+yarn intlayer login
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer login
+```
+
+```bash packageManager="bun"
+bunx intlayer login
+```
+
+Ini akan membuka browser default Anda untuk menyelesaikan proses autentikasi dan menerima kredensial yang diperlukan (Client ID dan Client Secret) untuk menggunakan layanan Intlayer.
+
 Dalam file konfigurasi Intlayer Anda, Anda dapat menyesuaikan pengaturan CMS:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/id/intlayer_with_next-i18next.md

@@ -593,7 +593,6 @@ const config: IntlayerConfig = {
   },
   plugins: [
     syncJSON({
-      format: "i18next",
       source: ({ locale }) => `./locales/${locale}.json`,
     }),
   ],

package/docs/id/intlayer_with_nextjs_14.md

@@ -107,6 +107,34 @@ bunx intlayer init
 
 ### Langkah 2: Konfigurasikan Proyek Anda
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── middleware.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 Buat file konfigurasi untuk mengatur bahasa aplikasi Anda:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/id/intlayer_with_nextjs_15.md

@@ -128,6 +128,34 @@ bunx intlayer init
 
 ### Langkah 2: Konfigurasikan Proyek Anda
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── middleware.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 Buat file konfigurasi untuk mengatur bahasa aplikasi Anda:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/id/intlayer_with_nextjs_16.md

@@ -104,6 +104,34 @@ Paket yang mengintegrasikan Intlayer dengan Next.js. Paket ini menyediakan conte
 
 ### Langkah 2: Konfigurasikan Proyek Anda
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── proxy.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 Buat file konfigurasi untuk mengatur bahasa aplikasi Anda:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"