@intlayer/docs 7.2.3 → 7.3.0-canary.0

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

@@ -0,0 +1,132 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Traduci Documento
+description: Scopri come tradurre automaticamente i file di documentazione utilizzando servizi di traduzione AI.
+keywords:
+  - Traduci
+  - Documento
+  - Documentazione
+  - AI
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - doc-translate
+---
+
+# Traduci Documento
+
+Il comando `doc translate` traduce automaticamente i file di documentazione da una locale base a locali target utilizzando servizi di traduzione AI.
+
+```bash
+npx intlayer doc translate
+```
+
+## Argomenti:
+
+**Opzioni lista file:**
+
+- **`--doc-pattern [docPattern...]`**: Pattern glob per selezionare i file di documentazione da tradurre.
+
+  > Esempio: `npx intlayer doc translate --doc-pattern "docs/**/*.md" "src/**/*.mdx"`
+
+- **`--excluded-glob-pattern [excludedGlobPattern...]`**: Pattern glob da escludere dalla traduzione.
+
+  > Esempio: `npx intlayer doc translate --excluded-glob-pattern "docs/internal/**"`
+
+- **`--skip-if-modified-before [skipIfModifiedBefore]`**: Salta il file se è stato modificato prima del tempo indicato.
+  - Può essere un tempo assoluto come "2025-12-05" (stringa o Date)
+  - Può essere un tempo relativo in ms `1 * 60 * 60 * 1000` (1 ora)
+  - Questa opzione controlla il tempo di aggiornamento del file usando il metodo `fs.stat`. Quindi potrebbe essere influenzata da Git o altri strumenti che modificano il file.
+
+  > Esempio: `npx intlayer doc translate --skip-if-modified-before "2025-12-05"`
+
+- **`--skip-if-modified-after [skipIfModifiedAfter]`**: Salta il file se è stato modificato entro il tempo indicato.
+  - Può essere un tempo assoluto come "2025-12-05" (stringa o Date)
+  - Può essere un tempo relativo in ms `1 * 60 * 60 * 1000` (1 ora)
+  - Questa opzione controlla il tempo di aggiornamento del file usando il metodo `fs.stat`. Quindi potrebbe essere influenzata da Git o altri strumenti che modificano il file.
+
+  > Esempio: `npx intlayer doc translate --skip-if-modified-after "2025-12-05"`
+
+- **`--skip-if-exists`**: Salta il file se esiste già.
+
+  > Esempio: `npx intlayer doc translate --skip-if-exists`
+
+**Opzioni di output delle voci:**
+
+- **`--locales [locales...]`**: Locali di destinazione per tradurre la documentazione.
+
+  > Esempio: `npx intlayer doc translate --locales fr es de`
+
+- **`--base-locale [baseLocale]`**: Locale sorgente da cui tradurre.
+
+  > Esempio: `npx intlayer doc translate --base-locale en`
+
+**Opzioni di elaborazione dei file:**
+
+- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: Numero di file da processare simultaneamente per la traduzione.
+
+  > Esempio: `npx intlayer doc translate --nb-simultaneous-file-processed 5`
+
+**Opzioni AI:**
+
+- **`--model [model]`**: Il modello AI da utilizzare per la traduzione (es. `gpt-3.5-turbo`).
+- **`--provider [provider]`**: Il provider AI da utilizzare per la traduzione.
+- **`--temperature [temperature]`**: Impostazione della temperatura per il modello AI.
+- **`--api-key [apiKey]`**: Fornisci la tua chiave API per il servizio AI.
+- **`--application-context [applicationContext]`**: Fornisci un contesto aggiuntivo per la traduzione AI.
+- **`--custom-prompt [prompt]`**: Personalizza il prompt base utilizzato per la traduzione. (Nota: per la maggior parte dei casi d'uso, si consiglia invece l'opzione `--custom-instructions` in quanto offre un controllo migliore sul comportamento della traduzione.)
+
+  > Esempio: `npx intlayer doc translate --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "La mia applicazione è un negozio di gatti"`
+
+**Opzioni variabili d'ambiente:**
+
+- **`--env`**: Specifica l'ambiente (es. `development`, `production`).
+- **`--env-file [envFile]`**: Fornisce un file ambiente personalizzato da cui caricare le variabili.
+- **`--base-dir`**: Specifica la directory base per il progetto.
+- **`--no-cache`**: Disabilita la cache.
+
+  > Esempio: `npx intlayer doc translate --base-dir ./docs --env-file .env.production.local`
+
+**Opzioni di log:**
+
+- **`--verbose`**: Abilita il logging dettagliato per il debugging. (impostazione predefinita a true usando la CLI)
+
+  > Esempio: `npx intlayer doc translate --verbose`
+
+**Opzioni istruzioni personalizzate:**
+
+- **`--custom-instructions [customInstructions]`**: Istruzioni personalizzate aggiunte al prompt. Utile per applicare regole specifiche riguardo al formato, alla traduzione degli URL, ecc.
+  - Può essere un tempo assoluto come "2025-12-05" (stringa o Date)
+  - Può essere un tempo relativo in ms `1 * 60 * 60 * 1000` (1 ora)
+  - Questa opzione controlla il tempo di aggiornamento del file usando il metodo `fs.stat`. Quindi potrebbe essere influenzata da Git o altri strumenti che modificano il file.
+
+  > Esempio: `npx intlayer doc translate --custom-instructions "Evita di tradurre gli URL e mantieni il formato markdown"`
+
+  > Esempio: `npx intlayer doc translate --custom-instructions "$(cat ./instructions.md)"`
+
+**Opzioni Git:**
+
+- **`--git-diff`**: Esegui solo sui dizionari che includono modifiche dalla base (predefinita `origin/main`) al branch corrente (predefinito: `HEAD`).
+- **`--git-diff-base`**: Specifica il riferimento base per il git diff (predefinito `origin/main`).
+- **`--git-diff-current`**: Specifica il riferimento corrente per il git diff (predefinito `HEAD`).
+- **`--uncommitted`**: Includi le modifiche non committate.
+- **`--unpushed`**: Includi le modifiche non pushate.
+- **`--untracked`**: Includi i file non tracciati.
+
+  > Esempio: `npx intlayer doc translate --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Esempio: `npx intlayer doc translate --uncommitted --unpushed --untracked`
+
+> Nota che il percorso del file di output sarà determinato sostituendo i seguenti pattern
+>
+> - `/{{baseLocale}}/` con `/{{locale}}/` (Unix)
+> - `\{{baseLocale}}\` con `\{{locale}}\` (Windows)
+> - `_{{baseLocale}}.` con `_{{locale}}.`
+> - `{{baseLocale}}_` con `{{locale}}_`
+> - `.{{baseLocaleName}}.` con `.{{localeName}}.`
+>
+> Se il pattern non viene trovato, il file di output aggiungerà `.{{locale}}` all'estensione del file. `./my/file.md` sarà tradotto in `./my/file.fr.md` per la localizzazione francese.

package/docs/it/cli/editor.md

@@ -0,0 +1,28 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Comandi dell'Editor
+description: Scopri come utilizzare i comandi dell'editor di Intlayer.
+keywords:
+  - Editor
+  - Editor Visuale
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - editor
+---
+
+# Comandi dell'editor
+
+Il comando `editor` incapsula i comandi di `intlayer-editor`.
+
+> Per poter utilizzare il comando `editor`, il pacchetto `intlayer-editor` deve essere installato. (Vedi [Intlayer Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_visual_editor.md))
+
+```json fileName="package.json"
+"scripts": {
+  "intlayer:editor:start": "npx intlayer editor start --with 'next dev --turbopack'"
+}
+```

package/docs/it/cli/fill.md

@@ -0,0 +1,130 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Riempire Dizionari
+description: Impara come riempire, controllare e tradurre i tuoi dizionari usando l'AI.
+keywords:
+  - Riempire
+  - Controllare
+  - Tradurre
+  - Dizionari
+  - CLI
+  - Intlayer
+  - AI
+slugs:
+  - doc
+  - concept
+  - cli
+  - fill
+---
+
+# Riempire / controllare / tradurre dizionari
+
+```bash
+npx intlayer fill
+```
+
+Questo comando analizza i tuoi file di dichiarazione dei contenuti per potenziali problemi come traduzioni mancanti, incoerenze strutturali o discrepanze di tipo. Se trova problemi, **intlayer fill** proporrà o applicherà aggiornamenti per mantenere i tuoi dizionari coerenti e completi.
+
+## Alias:
+
+- `npx intlayer dictionaries fill`
+- `npx intlayer dictionary fill`
+- `npx intlayer dic fill`
+
+## Argomenti:
+
+**Opzioni lista file:**
+
+- **`-f, --file [files...]`**: Una lista di file specifici di dichiarazione dei contenuti da controllare. Se non fornito, verranno controllati tutti i file `*.content.{ts,js,mjs,cjs,tsx,jsx,json}` scoperti in base alla configurazione del tuo file.
+
+  > Esempio: `npx intlayer dictionary fill -f src/home/app.content.ts`
+
+- **`-k, --keys [keys...]`**: Filtra i dizionari in base alle chiavi. Se non fornito, verranno controllati tutti i dizionari.
+
+  > Esempio: `npx intlayer dictionary fill -k key1 key2`
+
+- **`--key [keys...]`**: Filtra i dizionari in base alle chiavi (alias di --keys).
+
+  > Esempio: `npx intlayer dictionary fill --key key1 key2`
+
+- **`--excluded-keys [excludedKeys...]`**: Esclude i dizionari in base alle chiavi. Se non fornito, verranno controllati tutti i dizionari.
+
+  > Esempio: `npx intlayer dictionary fill --excluded-keys key1 key2`
+
+- **`--excluded-key [excludedKeys...]`**: Esclude i dizionari in base alle chiavi (alias di --excluded-keys).
+
+  > Esempio: `npx intlayer dictionary fill --excluded-key key1 key2`
+
+- **`--path-filter [pathFilters...]`**: Filtra i dizionari in base a un pattern glob per i percorsi dei file.
+
+  > Esempio: `npx intlayer dictionary fill --path-filter "src/home/**"`
+
+**Opzioni di output delle voci:**
+
+- **`--source-locale [sourceLocale]`**: La locale sorgente da cui tradurre. Se non specificata, verrà usata la locale predefinita dalla tua configurazione.
+
+- **`--output-locales [outputLocales...]`**: Locali di destinazione in cui tradurre. Se non specificate, verranno usate tutte le locali della tua configurazione eccetto la locale sorgente.
+
+- **`--mode [mode]`**: Modalità di traduzione: `complete`, `review`. Il valore predefinito è `complete`. `complete` riempirà tutti i contenuti mancanti, `review` riempirà i contenuti mancanti e rivedrà le chiavi esistenti.
+
+**Opzioni Git:**
+
+- **`--git-diff`**: Esegui solo sui dizionari che includono modifiche dalla base (predefinita `origin/main`) al ramo corrente (predefinito: `HEAD`).
+- **`--git-diff-base`**: Specifica il riferimento base per il git diff (predefinito `origin/main`).
+- **`--git-diff-current`**: Specifica il riferimento corrente per il git diff (predefinito `HEAD`).
+- **`--uncommitted`**: Includi le modifiche non commesse.
+- **`--unpushed`**: Includi le modifiche non pushate.
+- **`--untracked`**: Includi i file non tracciati.
+
+  > Esempio: `npx intlayer doc translate --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Esempio: `npx intlayer doc translate --uncommitted --unpushed --untracked`
+
+**Opzioni AI:**
+
+- **`--model [model]`**: Il modello AI da utilizzare per la traduzione (es. `gpt-3.5-turbo`).
+- **`--provider [provider]`**: Il provider AI da utilizzare per la traduzione.
+- **`--temperature [temperature]`**: Impostazione della temperatura per il modello AI.
+- **`--api-key [apiKey]`**: Fornisci la tua chiave API per il servizio AI.
+- **`--custom-prompt [prompt]`**: Fornisci un prompt personalizzato per le tue istruzioni di traduzione.
+- **`--application-context [applicationContext]`**: Fornisci un contesto aggiuntivo per la traduzione AI.
+
+  > Esempio: `npx intlayer fill --model gpt-3.5-turbo --provider openai --temperature 0.5 --api-key sk-1234567890 --application-context "La mia applicazione è un negozio di gatti"`
+
+**Opzioni per le variabili d'ambiente:**
+
+- **`--env`**: Specifica l'ambiente (es. `development`, `production`).
+- **`--env-file [envFile]`**: Fornisce un file di ambiente personalizzato da cui caricare le variabili.
+
+  > Esempio: `npx intlayer fill --env-file .env.production.local`
+
+  > Esempio: `npx intlayer fill --env production`
+
+**Opzioni di configurazione:**
+
+- **`--base-dir`**: Specifica la directory base per il progetto.
+
+  > Esempio: `npx intlayer fill --base-dir ./src`
+
+- **`--no-cache`**: Disabilita la cache.
+
+  > Esempio: `npx intlayer build --no-cache`
+
+**Opzioni di preparazione:**
+
+- **`--build`**: Costruisce i dizionari prima del push per assicurarsi che il contenuto sia aggiornato. True forza la build, false la salta, undefined permette di usare la cache della build.
+
+- **`--skip-metadata`**: Salta il riempimento dei metadati mancanti (descrizione, titolo, tag) per i dizionari.
+
+**Opzioni di log:**
+
+- **`--verbose`**: Abilita il logging dettagliato per il debug. (impostazione predefinita a true usando la CLI)
+
+## Esempio:
+
+```bash
+npx intlayer fill --file src/home/*.content.ts --source-locale en --output-locales fr es --model gpt-3.5-turbo
+```
+
+Questo comando tradurrà il contenuto dall'inglese al francese e allo spagnolo per tutti i file di dichiarazione del contenuto nella directory `src/home/` utilizzando il modello GPT-3.5 Turbo.

package/docs/it/cli/index.md

@@ -0,0 +1,158 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+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:
+  - CLI
+  - Interfaccia a Riga di Comando
+  - Internazionalizzazione
+  - Documentazione
+  - Intlayer
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - concept
+  - cli
+history:
+  - version: 7.2.3
+    date: 2025-11-22
+    changes: Aggiunto comando transform
+  - version: 7.1.0
+    date: 2025-11-05
+    changes: Aggiunta opzione skipIfExists al comando translate
+  - version: 6.1.4
+    date: 2025-01-27
+    changes: Aggiunti alias per argomenti e comandi CLI
+  - version: 6.1.3
+    date: 2025-10-05
+    changes: Aggiunta opzione build ai comandi
+  - version: 6.1.2
+    date: 2025-09-26
+    changes: Aggiunto comando version
+  - version: 6.1.0
+    date: 2025-09-26
+    changes: Impostata l'opzione verbose su true di default tramite CLI
+  - version: 6.1.0
+    date: 2025-09-23
+    changes: Aggiunto comando watch e opzione with
+  - version: 6.0.1
+    date: 2025-09-23
+    changes: Aggiunto comando editor
+  - version: 6.0.0
+    date: 2025-09-17
+    changes: Aggiunti comandi content test e list
+  - version: 5.5.11
+    date: 2025-07-11
+    changes: Aggiornata documentazione dei parametri dei comandi CLI
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: Inizializzata la cronologia
+---
+
+# CLI di Intlayer
+
+---
+
+## Indice
+
+<TOC/>
+
+---
+
+## Installare il Pacchetto
+
+Installa i pacchetti necessari usando npm:
+
+```bash packageManager="npm"
+npm install intlayer-cli -g
+```
+
+```bash packageManager="yarn"
+yarn add intlayer-cli -g
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer-cli -g
+```
+
+> Se il pacchetto `intlayer` è già installato, il CLI viene installato automaticamente. Puoi saltare questo passaggio.
+
+## Pacchetto intlayer-cli
+
+Il pacchetto `intlayer-cli` ha lo scopo di transpile le tue [dichiarazioni intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/content_file.md) in dizionari.
+
+Questo pacchetto transpilerà tutti i file intlayer, come `src/**/*.content.{ts|js|mjs|cjs|json}`. [Vedi come dichiarare i tuoi file di dichiarazione Intlayer](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md).
+
+Per interpretare i dizionari intlayer puoi utilizzare interpreter, come [react-intlayer](https://www.npmjs.com/package/react-intlayer), o [next-intlayer](https://www.npmjs.com/package/next-intlayer)
+
+## Supporto per i file di configurazione
+
+Intlayer accetta diversi formati di file di configurazione:
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+Per vedere come configurare le localizzazioni disponibili o altri parametri, consulta la [documentazione sulla configurazione qui](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md).
+
+## Esegui i comandi di intlayer
+
+### Comandi principali
+
+- **[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
+
+### Gestione dei Dizionari
+
+- **[Push Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/push.md)** - Invia i dizionari all'editor e CMS di Intlayer
+- **[Pull Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/pull.md)** - Scarica i dizionari dall'editor e CMS di Intlayer
+- **[Fill Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/fill.md)** - Compila, verifica e traduci i dizionari usando l'AI
+- **[Test Missing Translations](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/test.md)** - Testa e identifica le traduzioni mancanti
+- **[List Content Declaration Files](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/list.md)** - Elenca tutti i file di dichiarazione dei contenuti nel tuo progetto
+
+### Gestione Componenti
+
+- **[Trasforma Componenti](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/transform.md)** - Trasforma i componenti esistenti per utilizzare Intlayer
+
+### Configurazione
+
+- **[Gestisci Configurazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/configuration.md)** - Ottieni e invia la tua configurazione Intlayer al CMS
+
+### Gestione Documentazione
+
+- **[Traduci Documento](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/doc-translate.md)** - Traduce automaticamente i file di documentazione usando l'AI
+- **[Revisiona Documento](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/doc-review.md)** - Revisiona i file di documentazione per qualità e coerenza
+
+### Editor & Live Sync
+
+- **[Comandi Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/editor.md)** - Usa i comandi dell'editor Intlayer
+- **[Comandi Live Sync](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/live.md)** - Usa Live Sync per riflettere le modifiche dei contenuti CMS in tempo reale
+
+## Usa i comandi intlayer nel tuo `package.json`
+
+```json fileName="package.json"
+"scripts": {
+  "intlayer:build": "npx intlayer build",
+  "intlayer:watch": "npx intlayer build --watch",
+  "intlayer:push": "npx intlayer push",
+  "intlayer:pull": "npx intlayer pull",
+  "intlayer:fill": "npx intlayer fill",
+  "intlayer:list": "npx intlayer content list",
+  "intlayer:test": "npx intlayer content test",
+  "intlayer:transform": "npx intlayer transform",
+  "intlayer:doc:translate": "npx intlayer doc translate",
+  "intlayer:doc:review": "npx intlayer doc review"
+}
+```
+
+> **Nota**: Puoi anche usare gli alias più brevi:
+>
+> - `npx intlayer list` invece di `npx intlayer content list`
+> - `npx intlayer test` invece di `npx intlayer content test`

package/docs/it/cli/list.md

@@ -0,0 +1,53 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Elencare i file di dichiarazione del contenuto
+description: Scopri come elencare tutti i file di dichiarazione del contenuto nel tuo progetto.
+keywords:
+  - Elenco
+  - Dichiarazione del contenuto
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - list
+---
+
+# Elencare i file di dichiarazione del contenuto
+
+```bash
+npx intlayer content list
+```
+
+## Alias:
+
+- `npx intlayer 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:
+
+```bash
+npx intlayer content list
+```
+
+## Output di esempio:
+
+```bash
+npx intlayer content list
+Content declaration files:
+ - home-page        - src/components/HomePage/homePage.content.ts
+ - server-component - src/components/ServerComponent/serverComponent.content.ts
+ - client-component - src/components/ClientComponent/clientComponent.content.ts
+
+Totale file di dichiarazione del contenuto: 3
+```
+
+Questo comando mostrerà:
+
+- Un elenco formattato di tutti i file di dichiarazione del contenuto con le loro chiavi e i percorsi relativi dei file
+- Il conteggio totale dei file di dichiarazione del contenuto trovati
+
+L'output ti aiuta a verificare che tutti i tuoi file di contenuto siano configurati correttamente e rilevabili dal sistema Intlayer.

package/docs/it/cli/live.md

@@ -0,0 +1,41 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Comandi Live Sync
+description: Scopri come utilizzare Live Sync per riflettere le modifiche dei contenuti CMS in tempo reale.
+keywords:
+  - Live Sync
+  - CMS
+  - Runtime
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - live
+---
+
+# Comandi Live Sync
+
+Live Sync consente alla tua app di riflettere le modifiche dei contenuti CMS in tempo reale. Non è necessario ricostruire o ridistribuire. Quando abilitato, gli aggiornamenti vengono trasmessi a un server Live Sync che aggiorna i dizionari letti dalla tua applicazione. Consulta [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_CMS.md) per maggiori dettagli.
+
+```json fileName="package.json"
+"scripts": {
+  "intlayer:live:start": "npx intlayer live start --with 'next dev --turbopack'"
+}
+```
+
+## Argomenti:
+
+**Opzioni di configurazione:**
+
+- **`--base-dir`**: Specifica la directory base per il progetto. Per recuperare la configurazione di intlayer, il comando cercherà il file `intlayer.config.{ts,js,json,cjs,mjs}` nella directory base.
+
+- **`--no-cache`**: Disabilita la cache.
+
+  > Esempio: `npx intlayer dictionary push --env-file .env.production.local`
+
+**Opzioni di log:**
+
+- **`--verbose`**: Abilita il logging dettagliato per il debug. (impostazione predefinita a true usando la CLI)

package/docs/it/cli/pull.md

@@ -0,0 +1,78 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Estrazione Dizionari
+description: Scopri come estrarre dizionari dall'editor Intlayer e dal CMS.
+keywords:
+  - Estrazione
+  - Dizionari
+  - CLI
+  - Intlayer
+  - Editor
+  - CMS
+slugs:
+  - doc
+  - concept
+  - cli
+  - pull
+---
+
+# Estrazione Dizionari Remoti
+
+```bash
+npx intlayer pull
+```
+
+Se l'[editor Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_visual_editor.md) è installato, puoi anche estrarre dizionari direttamente dall'editor. In questo modo, puoi sovrascrivere il contenuto dei tuoi dizionari in base alle esigenze della tua applicazione.
+
+## Alias:
+
+- `npx intlayer dictionaries pull`
+- `npx intlayer dictionary pull`
+- `npx intlayer dic pull`
+
+## Argomenti:
+
+**Opzioni dizionario:**
+
+- **`-d, --dictionaries`**: Id degli dizionari da estrarre. Se non specificato, verranno estratti tutti i dizionari.
+
+  > Esempio: `npx intlayer dictionary pull -d my-dictionary-id my-other-dictionary-id`
+
+- **`--dictionary`**: Id degli dizionari da estrarre (alias di --dictionaries).
+
+  > Esempio: `npx intlayer dictionary pull --dictionary my-dictionary-id my-other-dictionary-id`
+
+**Opzioni di configurazione:**
+
+- **`--base-dir`**: Specifica la directory base del progetto. Per recuperare la configurazione di intlayer, il comando cercherà il file `intlayer.config.{ts,js,json,cjs,mjs}` nella directory base.
+
+  > Esempio: `npx intlayer dictionary push --env-file .env.production.local`
+
+- **`--no-cache`**: Disabilita la cache.
+
+  > Esempio: `npx intlayer build --no-cache`
+
+**Opzioni delle variabili d'ambiente:**
+
+- **`--env`**: Specifica l'ambiente (es. `development`, `production`).
+- **`--env-file`**: Fornisce un file di ambiente personalizzato da cui caricare le variabili.
+- **`--base-dir`**: Specifica la directory base del progetto. Per recuperare la configurazione di intlayer, il comando cercherà il file `intlayer.config.{ts,js,json,cjs,mjs}` nella directory base.
+
+  > Esempio: `npx intlayer dictionary push --env-file .env.production.local`
+
+  > Esempio: `npx intlayer dictionary push --env production`
+
+**Opzioni di output:**
+
+- **`--new-dictionaries-path`** : Percorso della directory in cui verranno salvati i nuovi dizionari. Se non specificato, i nuovi dizionari saranno salvati nella directory `./intlayer-dictionaries` del progetto. Se nel contenuto del dizionario è specificato un campo `filePath`, i dizionari non considereranno questo argomento e saranno salvati nella directory `filePath` specificata.
+
+**Opzioni di log:**
+
+- **`--verbose`**: Abilita il logging dettagliato per il debug. (impostazione predefinita a true usando la CLI)
+
+## Esempio:
+
+```bash
+npx intlayer dictionary pull --newDictionariesPath ./my-dictionaries-dir/
+```