@intlayer/docs 7.5.10 → 7.5.12

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

@@ -108,18 +108,22 @@ syncJSON({
   source: ({ key, locale }) => string, // wajib
   location?: string, // label opsional, default: "plugin"
   priority?: number, // prioritas opsional untuk resolusi konflik, default: 0
-  format?: 'intlayer' | 'icu' | 'i18next', // formatter opsional, default: 'intlayer'
+  format?: 'intlayer' | 'icu' | 'i18next', // formatter opsional, digunakan untuk kompatibilitas runtime Intlayer
 });
 ```
 
 #### `format` ('intlayer' | 'icu' | 'i18next')
 
-Menentukan formatter yang akan digunakan untuk konten kamus saat menyinkronkan file JSON. Ini memungkinkan penggunaan berbagai sintaks pemformatan pesan yang kompatibel dengan berbagai pustaka i18n.
+Menentukan formatter yang akan digunakan untuk konten kamus saat menyinkronkan file JSON. Ini memungkinkan penggunaan berbagai sintaks pemformatan pesan yang kompatibel dengan runtime Intlayer.
 
+- `undefined`: Tidak ada formatter yang akan digunakan, konten JSON akan digunakan apa adanya.
 - `'intlayer'`: Formatter Intlayer default (default).
 - `'icu'`: Menggunakan pemformatan pesan ICU (kompatibel dengan pustaka seperti react-intl, vue-i18n).
 - `'i18next'`: Menggunakan pemformatan pesan i18next (kompatibel dengan i18next, next-i18next, Solid-i18next).
 
+> Perhatikan bahwa menggunakan formatter akan mengubah konten JSON Anda pada input dan output. Untuk aturan JSON yang kompleks seperti pluralisasi ICU, parsing mungkin tidak menjamin pemetaan 1 ke 1 antara input dan output.
+> Jika Anda tidak menggunakan runtime Intlayer, Anda mungkin lebih memilih untuk tidak mengatur formatter.
+
 **Contoh:**
 
 ```ts

package/docs/it/cli/ci.md

@@ -0,0 +1,137 @@
+---
+createdAt: 2026-01-06
+updatedAt: 2026-01-06
+title: Comando CI
+description: Impara come usare il comando Intlayer CI per eseguire comandi Intlayer con credenziali auto-iniettate nelle pipeline CI/CD e nei monorepo.
+keywords:
+  - CI
+  - CI/CD
+  - Automatizzazione
+  - Monorepo
+  - Credenziali
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - ci
+history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Aggiungere comando CI
+---
+
+# Comando CI
+
+```bash
+npx intlayer ci <command...>
+```
+
+Il comando CI è progettato per l'automazione e le pipeline CI/CD. Inietta automaticamente le credenziali dalla variabile d'ambiente `INTLAYER_PROJECT_CREDENTIALS` e può eseguire comandi Intlayer su più progetti in un monorepo.
+
+## Come funziona
+
+Il comando CI opera in due modalità:
+
+1. **Modalità progetto singolo**: Se la directory di lavoro corrente corrisponde a uno dei percorsi del progetto in `INTLAYER_PROJECT_CREDENTIALS`, esegue il comando solo per quel progetto specifico.
+
+2. **Modalità iterazione**: Se non viene rilevato un contesto di progetto specifico, itera su tutti i progetti configurati ed esegue il comando per ciascuno.
+
+## Variabile d'ambiente
+
+Il comando richiede che la variabile d'ambiente `INTLAYER_PROJECT_CREDENTIALS` sia impostata. Questa variabile deve contenere un oggetto JSON che mappa i percorsi del progetto alle loro credenziali:
+
+```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"
+  }
+}
+```
+
+## Rilevamento del gestore di pacchetti
+
+Il comando CI rileva automaticamente quale gestore di pacchetti viene utilizzato (npm, yarn, pnpm o bun) in base alla variabile d'ambiente `npm_config_user_agent` e utilizza il comando appropriato per eseguire Intlayer.
+
+## Argomenti
+
+- **`<command...>`**: Il comando Intlayer da eseguire (ad esempio, `fill`, `push`, `build`). Puoi passare qualsiasi comando Intlayer e i suoi argomenti.
+
+  > Esempio: `npx intlayer ci fill --verbose`
+  >
+  > Esempio: `npx intlayer ci push`
+  >
+  > Esempio: `npx intlayer ci build`
+
+## Esempi
+
+### Eseguire un comando in modalità progetto singolo
+
+Se ti trovi in una directory di progetto che corrisponde a uno dei percorsi in `INTLAYER_PROJECT_CREDENTIALS`:
+
+```bash
+cd packages/app
+npx intlayer ci fill
+```
+
+Questo eseguirà il comando `fill` con le credenziali iniettate automaticamente per il progetto `packages/app`.
+
+### Eseguire un comando su tutti i progetti
+
+Se ti trovi in una directory che non corrisponde a nessun percorso di progetto, il comando itererà su tutti i progetti configurati:
+
+```bash
+cd /path/to/monorepo
+npx intlayer ci push
+```
+
+Questo eseguirà il comando `push` per ogni progetto configurato in `INTLAYER_PROJECT_CREDENTIALS`.
+
+### Passare flag aggiuntivi
+
+Puoi passare qualsiasi flag al comando Intlayer sottostante:
+
+```bash
+npx intlayer ci fill --verbose --mode complete
+```
+
+### Utilizzare nelle pipeline CI/CD
+
+Nella tua configurazione CI/CD (ad esempio, GitHub Actions, GitLab CI), imposta `INTLAYER_PROJECT_CREDENTIALS` come segreto:
+
+```yaml
+# Esempio GitHub Actions
+env:
+  INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}
+
+steps:
+  - name: Riempire dizionari
+    run: npx intlayer ci fill
+```
+
+## Gestione degli errori
+
+- Se `INTLAYER_PROJECT_CREDENTIALS` non è impostata, il comando terminerà con un errore.
+- Se `INTLAYER_PROJECT_CREDENTIALS` non è un JSON valido, il comando terminerà con un errore.
+- Se un percorso di progetto non esiste, verrà saltato con un avviso.
+- Se un progetto fallisce, il comando terminerà con un codice di stato diverso da zero.
+
+## Casi d'uso
+
+- **Automatizzazione monorepo**: Eseguire comandi Intlayer su più progetti in un monorepo
+- **Pipeline CI/CD**: Automatizzare la gestione dei dizionari nei flussi di lavoro di integrazione continua
+- **Operazioni in batch**: Eseguire la stessa operazione su più progetti Intlayer contemporaneamente
+- **Gestione dei segreti**: Gestire in modo sicuro le credenziali per più progetti utilizzando variabili d'ambiente
+
+## Best practice di sicurezza
+
+- Archivia `INTLAYER_PROJECT_CREDENTIALS` come segreti crittografati nella tua piattaforma CI/CD
+- Non committare mai le credenziali nel controllo versione
+- Usa credenziali specifiche dell'ambiente per diversi ambienti di distribuzione
+- Ruota le credenziali regolarmente

package/docs/it/cli/index.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-12-30
+updatedAt: 2026-01-06
 title: CLI
 description: Scopri come utilizzare la CLI di Intlayer per gestire il tuo sito web multilingue. Segui i passaggi in questa documentazione online per configurare il tuo progetto in pochi minuti.
 keywords:
@@ -17,6 +17,9 @@ slugs:
   - concept
   - cli
 history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Aggiunto comando projects list
   - version: 7.5.9
     date: 2025-12-30
     changes: Aggiunto comando init
@@ -119,6 +122,7 @@ Per vedere come configurare le localizzazioni disponibili o altri parametri, con
 - **[Build Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/build.md)** - Costruisci i tuoi dizionari dai file di dichiarazione dei contenuti
 - **[Watch Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/watch.md)** - Monitora le modifiche e costruisci automaticamente i dizionari
 - **[Check CLI Version](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/version.md)** - Controlla la versione installata della CLI di Intlayer
+- **[Elenca Progetti](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/list_projects.md)** - Elenca tutti i progetti Intlayer in una directory o repository git
 
 ### Gestione dei Dizionari
 
@@ -161,6 +165,7 @@ Per vedere come configurare le localizzazioni disponibili o altri parametri, con
   "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"
 }
@@ -170,3 +175,4 @@ Per vedere come configurare le localizzazioni disponibili o altri parametri, con
 >
 > - `npx intlayer list` invece di `npx intlayer content list`
 > - `npx intlayer test` invece di `npx intlayer content test`
+> - `npx intlayer projects-list` o `npx intlayer pl` invece di `npx intlayer projects list`

package/docs/it/cli/list.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-01-06
 title: Elencare i file di dichiarazione del contenuto
 description: Scopri come elencare tutti i file di dichiarazione del contenuto nel tuo progetto.
 keywords:
@@ -13,6 +13,13 @@ slugs:
   - concept
   - cli
   - list
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: Aggiunta opzione di output assoluto al comando list
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Aggiunta opzione di output JSON al comando list
 ---
 
 # Elencare i file di dichiarazione del contenuto
@@ -27,14 +34,36 @@ npx intlayer content list
 
 Questo comando mostra tutti i file di dichiarazione del contenuto nel tuo progetto, visualizzando le loro chiavi nel dizionario e i percorsi dei file. È utile per avere una panoramica di tutti i tuoi file di contenuto e verificare che siano correttamente rilevati da Intlayer.
 
-## Esempio:
+## Argomenti:
+
+- **`--json`**: Mostra i risultati come JSON invece di testo formattato. Utile per scripting e accesso programmatico.
+
+  > Esempio: `npx intlayer content list --json`
+
+## Esempi:
+
+### Elencare i file di dichiarazione del contenuto:
 
 ```bash
 npx intlayer content list
 ```
 
+### Output come JSON:
+
+```bash
+npx intlayer content list --json
+```
+
+### Output come percorsi assoluti:
+
+```bash
+npx intlayer content list --absolute
+```
+
 ## Output di esempio:
 
+### Output formattato:
+
 ```bash
 npx intlayer content list
 Content declaration files:
@@ -45,6 +74,14 @@ Content declaration files:
 Totale file di dichiarazione del contenuto: 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"}]
+```
+
 Questo comando mostrerà:
 
 - Un elenco formattato di tutti i file di dichiarazione del contenuto con le loro chiavi e i percorsi relativi dei file

package/docs/it/cli/list_projects.md

@@ -0,0 +1,130 @@
+---
+createdAt: 2025-12-30
+updatedAt: 2026-01-06
+title: Elencare i progetti Intlayer
+description: Scopri come elencare tutti i progetti Intlayer in una directory o in un repository git.
+keywords:
+  - Elenco
+  - Progetti
+  - CLI
+  - Intlayer
+  - Git
+slugs:
+  - doc
+  - concept
+  - cli
+  - list-projects
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: Aggiungere opzione di output assoluto al comando list projects
+---
+
+# Elencare i progetti Intlayer
+
+```bash
+npx intlayer projects list
+```
+
+Questo comando cerca ed elenca tutti i progetti Intlayer trovando le directory che contengono file di configurazione di Intlayer. È utile per scoprire tutti i progetti Intlayer in un monorepo, workspace o repository git.
+
+## Alias:
+
+- `npx intlayer projects-list`
+- `npx intlayer pl`
+
+## Argomenti:
+
+- **`--base-dir [path]`**: Specifica la directory base da cui avviare la ricerca. Predefinita è la directory di lavoro corrente.
+
+  > Esempio: `npx intlayer projects list --base-dir /path/to/workspace`
+
+  > Esempio: `npx intlayer projects list --base-dir /path/to/workspace`
+
+- **`--git-root`**: Effettua la ricerca dalla root del repository git invece che dalla directory base. Questo è utile per trovare tutti i progetti Intlayer in un monorepo o in un repository git.
+
+  > Esempio: `npx intlayer projects list --git-root`
+
+- **`--json`**: Mostra i risultati come JSON invece di testo formattato. Utile per scripting e accesso programmatico.
+
+  > Esempio: `npx intlayer projects list --json`
+
+- **`--absolute`**: Mostra i risultati come percorsi assoluti invece di percorsi relativi.
+
+  > Esempio: `npx intlayer projects list --absolute`
+
+## Come funziona:
+
+Il comando cerca i file di configurazione di Intlayer nella directory specificata (o nella root git se viene usato `--git-root`). Cerca i seguenti pattern di file di configurazione:
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+Ogni directory che contiene uno di questi file è considerata un progetto Intlayer e verrà elencata nell'output.
+
+## Esempi:
+
+### Elencare i progetti nella directory corrente:
+
+```bash
+npx intlayer projects list
+```
+
+### Elencare i progetti in una directory specifica:
+
+```bash
+npx intlayer projects list --base-dir ./packages
+```
+
+### Elencare tutti i progetti nel repository git:
+
+```bash
+npx intlayer projects list --git-root
+```
+
+### Utilizzo dell'alias rapido:
+
+```bash
+npx intlayer pl --git-root
+```
+
+### Output come JSON:
+
+```bash
+npx intlayer projects list --json
+```
+
+## Esempio di output:
+
+### Output formattato:
+
+```bash
+$ npx intlayer projects list --git-root
+
+Trovati 3 progetti Intlayer:
+
+  - /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"]
+```
+
+## Casi d'uso:
+
+- **Monorepo management**: Scoprire tutti i progetti Intlayer in una struttura monorepo
+- **Project discovery**: Trovare tutti i progetti abilitati a Intlayer in uno workspace
+- **CI/CD**: Verificare i progetti Intlayer nei workflow automatizzati
+- **Documentazione**: Generare documentazione che elenchi tutti i progetti che utilizzano Intlayer
+
+L'output fornisce i percorsi assoluti di ogni directory di progetto, rendendo semplice navigare verso di essi o scrivere script per operazioni su più progetti Intlayer.

package/docs/it/intlayer_CMS.md

@@ -71,6 +71,26 @@ Per l'integrazione con Vite + React, consulta la [guida all'installazione](https
 
 ## Configurazione
 
+Esegui il seguente comando per accedere all'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
+```
+
+Questo aprirà il tuo browser predefinito per completare il processo di autenticazione e ricevere le credenziali necessarie (Client ID e Client Secret) per utilizzare i servizi Intlayer.
+
 Nel file di configurazione di Intlayer, puoi personalizzare le impostazioni del CMS:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/it/intlayer_with_next-i18next.md

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

package/docs/it/intlayer_with_nextjs_14.md

@@ -74,6 +74,34 @@ bunx intlayer init
 
 ### Passo 2: Configura il tuo progetto
 
+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.
+
 Crea un file di configurazione per configurare le lingue della tua applicazione:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/it/intlayer_with_nextjs_15.md

@@ -84,6 +84,34 @@ Il pacchetto che integra Intlayer con Next.js. Fornisce provider di contesto e h
 
 ### Passo 2: Configura il tuo progetto
 
+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.
+
 Crea un file di configurazione per configurare le lingue della tua applicazione:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/it/intlayer_with_nextjs_16.md

@@ -104,6 +104,34 @@ bunx intlayer init
 
 ### Passo 2: Configura il tuo progetto
 
+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.
+
 Crea un file di configurazione per configurare le lingue della tua applicazione:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"