@intlayer/docs 5.5.12 → 5.7.0

package/docs/it/intlayer_cli.md

@@ -1,11 +1,11 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-06-29
+updatedAt: 2025-07-11
 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
+  - Interfaccia a Riga di Comando
   - Internazionalizzazione
   - Documentazione
   - Intlayer
@@ -20,7 +20,7 @@ slugs:
 
 # CLI di Intlayer
 
-## Installare il pacchetto
+## Installare il Pacchetto
 
 Installa i pacchetti necessari usando npm:
 
@@ -44,9 +44,9 @@ Il pacchetto `intlayer-cli` ha lo scopo di trascrivere le tue [dichiarazioni int
 
 Questo pacchetto trascriverà 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 usare interpreter, come [react-intlayer](https://www.npmjs.com/package/react-intlayer), o [next-intlayer](https://www.npmjs.com/package/next-intlayer).
+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 file di configurazione
+## Supporto ai File di Configurazione
 
 Intlayer accetta diversi formati di file di configurazione:
 
@@ -57,53 +57,11 @@ Intlayer accetta diversi formati di file di configurazione:
 - `intlayer.config.mjs`
 - `.intlayerrc`
 
-Per vedere come configurare le localizzazioni disponibili, o altri parametri, fai riferimento alla [documentazione di configurazione qui](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md).
+Per vedere come configurare le lingue disponibili o altri parametri, fai riferimento alla [documentazione di configurazione qui](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md).
 
-## CLI SDK
-
-Il CLI SDK è una libreria che ti permette di usare il CLI di Intlayer nel tuo codice.
-
-```bash packageManager="npm"
-npm install @intlayer/cli -D
-```
-
-```bash packageManager="yarn"
-yarn add @intlayer/cli -D
-```
-
-```bash packageManager="pnpm"
-pnpm add @intlayer/cli -D
-```
-
-Esempio di utilizzo:
-
-```ts
-import {
-  push,
-  pull,
-  fill,
-  build,
-  docTranslate,
-  docReview,
-} from "@intlayer/cli";
+## Eseguire i comandi di intlayer
 
-push();
-// ...
-pull();
-// ...
-fill();
-// ...
-build();
-// ...
-docTranslate();
-// ...
-docReview();
-// ...
-```
-
-## Esegui i comandi di intlayer
-
-### Costruisci i dizionari
+### Costruire i dizionari
 
 Per costruire i tuoi dizionari, puoi eseguire i comandi:
 
@@ -117,7 +75,7 @@ oppure in modalità watch
 npx intlayer build --watch
 ```
 
-Questo comando troverà i tuoi file di contenuto di dichiarazione di default in `./src/**/*.content.{ts|js|mjs|cjs|json|tsx|jsx}`. E costruirà i dizionari nella directory `.intlayer`.
+Questo comando troverà i tuoi file di dichiarazione del contenuto di default in `./src/**/*.content.{ts|js|mjs|cjs|json|tsx|jsx}`. E costruirà i dizionari nella directory `.intlayer`.
 
 ##### Alias:
 
@@ -131,7 +89,7 @@ Questo comando troverà i tuoi file di contenuto di dichiarazione di default in
 npx intlayer dictionary push
 ```
 
-Se [intlayer editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_visual_editor.md) è installato, puoi anche inviare i dizionari all'editor. Questo comando permetterà di rendere i dizionari disponibili a [l'editor](https://intlayer.org/dashboard). In questo modo, puoi condividere i tuoi dizionari con il tuo team e modificare i tuoi contenuti senza modificare il codice della tua applicazione.
+Se [intlayer editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_visual_editor.md) è installato, puoi anche inviare i dizionari all'editor. Questo comando permette di rendere i dizionari disponibili a [l'editor](https://intlayer.org/dashboard). In questo modo, puoi condividere i tuoi dizionari con il tuo team e modificare i tuoi contenuti senza modificare il codice della tua applicazione.
 
 ##### Alias:
 
@@ -141,22 +99,57 @@ Se [intlayer editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/
 
 ##### Argomenti:
 
-- `-d`, `--dictionaries`: ID dei dizionari da inviare. Se non specificato, tutti i dizionari saranno inviati.
+**Opzioni dizionario:**
+
+- **`-d`, `--dictionaries`**: ID dei dizionari da inviare. Se non specificato, verranno inviati tutti i dizionari.
+
   > Esempio: `npx intlayer dictionary push -d my-dictionary-id my-other-dictionary-id`
-- `-r`, `--deleteLocaleDictionary`: Salta la domanda che chiede di eliminare le directory delle localizzazioni una volta che i dizionari sono stati inviati, e le rimuove. Per impostazione predefinita, se il dizionario è definito localmente, sovrascriverà il contenuto dei dizionari remoti.
+
+**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.
+
+  > Esempio: `npx intlayer dictionary push --env-file .env.production.local`
+
+**Opzioni per le variabili d'ambiente:**
+
+- **`--env`**: Specifica l'ambiente (ad esempio, `development`, `production`). Utile nel caso in cui si utilizzino variabili d'ambiente nel file di configurazione di intlayer.
+- **`--env-file`**: Fornisce un file di ambiente personalizzato da cui caricare le variabili. Utile nel caso in cui si utilizzino variabili d'ambiente nel file di configurazione di intlayer.
+
+  > Esempio: `npx intlayer dictionary push --env-file .env.production.local`
+
+  > Esempio: `npx intlayer dictionary push --env production`
+
+**Opzioni di output:**
+
+- **`-r`, `--delete-locale-dictionary`**: Salta la domanda che chiede di eliminare le directory delle localizzazioni una volta che i dizionari sono stati inviati, e le rimuove. Per impostazione predefinita, se il dizionario è definito localmente, sovrascriverà il contenuto dei dizionari remoti.
+
   > Esempio: `npx intlayer dictionary push -r`
-- `-k`, `--keepLocaleDictionary`: Salta la domanda che chiede di eliminare le directory delle localizzazioni una volta che i dizionari sono stati inviati, e le mantiene. Per impostazione predefinita, se il dizionario è definito localmente, sovrascriverà il contenuto dei dizionari remoti.
+
+  > Esempio: `npx intlayer dictionary push --delete-locale-dictionary`
+
+- **`-k`, `--keep-locale-dictionary`**: Salta la domanda che chiede di eliminare le directory delle localizzazioni una volta che i dizionari sono stati inviati, e le mantiene. Per impostazione predefinita, se il dizionario è definito localmente, sovrascriverà il contenuto dei dizionari remoti.
+
   > Esempio: `npx intlayer dictionary push -k`
-- `--env`: Specifica l'ambiente (es. `development`, `production`).
-- `--env-file`: Fornisce un file ambiente personalizzato da cui caricare le variabili.
-- `--base-dir`: Specifica la directory base per il progetto.
-- `--verbose`: Abilita il logging dettagliato per il debug.
-- `--git-diff`: Esegui solo sui dizionari che includono modifiche dalla base (default `origin/main`) al branch corrente (default: `HEAD`).
-- `--git-diff-base`: Specifica il riferimento base per il git diff (default `origin/main`).
-- `--git-diff-current`: Specifica il riferimento corrente per il git diff (default `HEAD`).
-- `--uncommitted`: Includi le modifiche non committate.
-- `--unpushed`: Includi le modifiche non pushate.
-- `--untracked`: Includi i file non tracciati.
+
+  > Esempio: `npx intlayer dictionary push --keep-locale-dictionary`
+
+**Opzioni di log:**
+
+- **`--verbose`**: Abilita il logging dettagliato per il debug.
+
+**Opzioni Git:**
+
+- **`--git-diff`**: Esegui solo sui dizionari che includono modifiche dalla base (default `origin/main`) al ramo corrente (default: `HEAD`).
+- **`--git-diff-base`**: Specifica il riferimento base per il git diff (default `origin/main`).
+- **`--git-diff-current`**: Specifica il riferimento corrente per il git diff (default: `HEAD`).
+- **`--uncommitted`**: Includi le modifiche non committate.
+- **`--unpushed`**: Includi le modifiche non pushate.
+- **`--untracked`**: Includi i file non tracciati.
+
+  > Esempio: `npx intlayer dictionary push --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Esempio: `npx intlayer dictionary push --uncommitted --unpushed --untracked`
 
 ### Scaricare dizionari remoti
 
@@ -164,7 +157,7 @@ Se [intlayer editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/
 npx intlayer pull
 ```
 
-Se [intlayer editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_visual_editor.md) è installato, puoi anche scaricare i dizionari dall'editor. In questo modo, puoi sovrascrivere il contenuto dei tuoi dizionari in base alle esigenze della tua applicazione.
+Se l'[editor intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_visual_editor.md) è installato, puoi anche scaricare i dizionari dall'editor. In questo modo, puoi sovrascrivere il contenuto dei tuoi dizionari in base alle esigenze della tua applicazione.
 
 ##### Alias:
 
@@ -174,13 +167,35 @@ Se [intlayer editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/
 
 ##### Argomenti:
 
-- `-d, --dictionaries`: ID dei dizionari da scaricare. Se non specificato, verranno scaricati tutti i dizionari.
+**Opzioni dizionario:**
+
+- **`-d, --dictionaries`**: Id dei dizionari da scaricare. Se non specificato, verranno scaricati tutti i dizionari.
+
   > Esempio: `npx intlayer dictionary pull -d my-dictionary-id my-other-dictionary-id`
-- `--newDictionariesPath` : Percorso della directory in cui verranno salvati i nuovi dizionari. Se non specificato, i nuovi dizionari verranno salvati nella directory `./intlayer-dictionaries` del progetto. Se nel contenuto del dizionario è specificato un campo `filePath`, i dizionari non considereranno questo argomento e verranno salvati nella directory `filePath` specificata.
-- `--env`: Specifica l'ambiente (ad esempio, `development`, `production`).
-- `--env-file`: Fornisce un file ambiente personalizzato da cui caricare le variabili.
-- `--base-dir`: Specifica la directory base per il progetto.
-- `--verbose`: Abilita il logging dettagliato per il debug.
+
+**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.
+
+  > Esempio: `npx intlayer dictionary push --env-file .env.production.local`
+
+**Opzioni per le variabili d'ambiente:**
+
+- **`--env`**: Specifica l'ambiente (ad esempio, `development`, `production`).
+- **`--env-file`**: Fornisce un file di ambiente personalizzato da cui caricare le variabili.
+- **`--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.
+
+  > 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 verranno salvati nella directory `./intlayer-dictionaries` del progetto. Se nel contenuto del dizionario è specificato un campo `filePath`, i dizionari ignoreranno questo argomento e verranno salvati nella directory `filePath` specificata.
+
+**Opzioni di log:**
+
+- **`--verbose`**: Abilita il logging dettagliato per il debug.
 
 ##### Esempio:
 
@@ -188,13 +203,13 @@ Se [intlayer editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/
 npx intlayer dictionary pull --newDictionariesPath ./my-dictionaries-dir/
 ```
 
-### Riempire / controllare / tradurre dizionari
+### Compila / verifica / traduci 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 rileva problemi, **intlayer fill** proporrà o applicherà aggiornamenti per mantenere i tuoi dizionari coerenti e completi.
+Questo comando analizza i tuoi file di dichiarazione dei contenuti per individuare potenziali problemi come traduzioni mancanti, incoerenze strutturali o discrepanze di tipo. Se rileva problemi, **intlayer fill** proporrà o applicherà aggiornamenti per mantenere i tuoi dizionari coerenti e completi.
 
 ##### Alias:
 
@@ -204,86 +219,80 @@ Questo comando analizza i tuoi file di dichiarazione dei contenuti per potenzial
 
 ##### Argomenti:
 
-- `-f, --file [files...]`
-  Una lista di file specifici di dichiarazione dei contenuti da controllare. Se non fornita, verranno controllati tutti i file `*.content.{ts,js,mjs,cjs,tsx,jsx,json}` trovati.
+**Opzioni per la lista dei file:**
 
-- `--exclude [excludedGlobs...]`
-  Pattern glob da escludere dal controllo (es. `--exclude "src/test/**"`).
+- **`-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.
 
-- `--source-locale [sourceLocale]`
-  La locale di origine da cui tradurre. Se non specificata, verrà utilizzata la locale predefinita dalla tua configurazione.
+  > Esempio: `npx intlayer dictionary fill -f src/home/app.content.ts`
 
-- `--output-locales [outputLocales...]`
-  Locali di destinazione in cui tradurre. Se non specificate, verranno utilizzate tutte le locali dalla tua configurazione eccetto la locale di origine.
+- **`-k, --keys [keys...]`**: Filtra i dizionari in base alle chiavi. Se non specificato, verranno controllati tutti i dizionari.
 
-- `--mode [mode]`
-  Modalità di traduzione: 'complete', 'review' o 'missing-only'. Il valore predefinito è 'missing-only'.
+  > Esempio: `npx intlayer dictionary fill -k key1 key2`
 
-- `--git-diff`
-  Filtra i dizionari che includono modifiche dalla base (predefinita `origin/main`) al ramo corrente (predefinito: `HEAD`).
+- **`--excluded-keys [excludedKeys...]`**: Esclude i dizionari in base alle chiavi. Se non specificato, verranno controllati tutti i dizionari.
 
-- `--git-diff-base`
-  Specifica il riferimento base per il git diff (predefinito `origin/main`).
+  > Esempio: `npx intlayer dictionary fill --excluded-keys key1 key2`
 
-- `--git-diff-current`
-  Specifica il riferimento corrente per il git diff (predefinito `HEAD`).
+- **`--path-filter [pathFilters...]`**: Filtra i dizionari in base a un pattern glob per i percorsi dei file.
 
-- `--uncommitted`
-  Filtra i dizionari che includono modifiche non committate.
+  > Esempio: `npx intlayer dictionary fill --path-filter "src/home/**"`
 
-- `--unpushed`
-- Filtra i dizionari che includono modifiche non inviate.
+**Opzioni di output delle voci:**
 
-- `--untracked`
-  Filtra i dizionari che includono file non tracciati.
+- **`--source-locale [sourceLocale]`**: La locale sorgente da cui tradurre. Se non specificata, verrà utilizzata la locale predefinita dalla tua configurazione.
 
-- `--keys [keys...]`
-  Filtra i dizionari in base alle chiavi specificate.
+- **`--output-locales [outputLocales...]`**: Locali di destinazione per la traduzione. Se non specificato, verranno usate tutte le locali della tua configurazione eccetto la locale sorgente.
 
-- `--excluded-keys [excludedKeys...]`
-  Esclude i dizionari in base alle chiavi specificate.
+- **`--mode [mode]`**: Modalità di traduzione: 'complete', 'review' o 'missing-only'. Il valore predefinito è 'missing-only'.
 
-- `--path-filter [pathFilters...]`
-  Filtra i dizionari in base a un pattern glob per i percorsi dei file.
+**Opzioni Git:**
 
-- `--model [model]`
-  Il modello AI da utilizzare per la traduzione (es. `gpt-3.5-turbo`).
+- **`--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 diff git (predefinito `origin/main`).
+- **`--git-diff-current`**: Specifica il riferimento corrente per il diff git (predefinito `HEAD`).
+- **`--uncommitted`**: Includi le modifiche non commesse.
+- **`--unpushed`**: Includi le modifiche non inviate.
+- **`--untracked`**: Includi i file non tracciati.
 
-- `--provider [provider]`
-  Il provider AI da utilizzare per la traduzione.
+  > Esempio: `npx intlayer doc translate --git-diff --git-diff-base origin/main --git-diff-current HEAD`
 
-- `--temperature [temperature]`
-  Impostazione della temperatura per il modello AI.
+  > Esempio: `npx intlayer doc translate --uncommitted --unpushed --untracked`
 
-- `--api-key [apiKey]`
-  Fornisci la tua chiave API per il servizio AI.
+**Opzioni AI:**
 
-- `--custom-prompt [prompt]`
-  Fornisci un prompt personalizzato per le istruzioni di traduzione.
-- `--application-context [applicationContext]`
-  Fornisce un contesto aggiuntivo per la traduzione 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 istruzioni di traduzione.
+- **`--application-context [applicationContext]`**: Fornisci un contesto aggiuntivo per la traduzione AI.
 
-- `--env`
-  Specifica l'ambiente (es. `development`, `production`).
+  > 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"`
 
-- `--env-file [envFile]`
-  Fornisce un file ambiente personalizzato da cui caricare le variabili.
+**Opzioni per le variabili d'ambiente:**
 
-- `--base-dir`
-  Specifica la directory base per il progetto.
+- **`--env`**: Specifica l'ambiente (es. `development`, `production`).
+- **`--env-file [envFile]`**: Fornisce un file di ambiente personalizzato da cui caricare le variabili.
 
-- `--verbose`
-  Abilita il logging dettagliato per il debug.
+  > Esempio: `npx intlayer fill --env-file .env.production.local`
 
-##### Esempio:
+  > Esempio: `npx intlayer fill --env production`
 
-```bash
-npx intlayer fill --file src/home/*.content.ts --source-locale en --output-locales fr es --model gpt-3.5-turbo
-```
+**Opzioni di configurazione:**
+
+- **`--base-dir`**: Specifica la directory base per il progetto.
 
-Questo comando tradurrà il contenuto dall'inglese al francese e spagnolo per tutti i file di dichiarazione contenuti nella directory `src/home/` utilizzando il modello GPT-3.5 Turbo.
+  > Esempio: `npx intlayer fill --base-dir ./src`
 
-### Gestione della Configurazione
+**Opzioni di log:**
+
+- **`--verbose`**: Abilita il logging dettagliato per il debug.
+
+##### Esempio:
+
+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.
+
+### Gestire la Configurazione
 
 #### Ottenere la Configurazione
 
@@ -301,13 +310,13 @@ npx intlayer configuration get
 ##### Argomenti:
 
 - **`--env`**: Specifica l'ambiente (es. `development`, `production`).
-- **`--env-file`**: Fornisce un file di ambiente personalizzato da cui caricare le variabili.
+- **`--env-file`**: Fornisce un file ambiente personalizzato da cui caricare le variabili.
 - **`--base-dir`**: Specifica la directory base per il progetto.
 - **`--verbose`**: Abilita il logging dettagliato per il debug.
 
 #### Push Configuration
 
-Il comando `configuration push` carica la tua configurazione nel CMS e nell'editor di Intlayer. Questo passaggio è necessario per abilitare l'uso di dizionari remoti nell'Intlayer Visual Editor.
+Il comando `configuration push` carica la tua configurazione nel CMS e nell'editor di Intlayer. Questo passaggio è necessario per abilitare l'uso di dizionari remoti nell'Editor Visivo di Intlayer.
 
 ```bash
 npx intlayer configuration push
@@ -325,15 +334,15 @@ npx intlayer configuration push
 - **`--base-dir`**: Specifica la directory base per il progetto.
 - **`--verbose`**: Abilita il logging dettagliato per il debug.
 
-Effettuando il push della configurazione, il tuo progetto sarà completamente integrato con Intlayer CMS, permettendo una gestione fluida del dizionario tra i team.
+Spingendo la configurazione, il tuo progetto è completamente integrato con l'Intlayer CMS, consentendo una gestione fluida dei dizionari tra i team.
 
 ### Gestione della Documentazione
 
-I comandi `doc` offrono strumenti per gestire e tradurre i file di documentazione in più localizzazioni.
+I comandi `doc` forniscono strumenti per gestire e tradurre i file di documentazione in più localizzazioni.
 
 #### Traduci Documentazione
 
-Il comando `doc translate` traduce automaticamente i file di documentazione da una locale base a locali di destinazione utilizzando servizi di traduzione AI.
+Il comando `doc translate` traduce automaticamente i file di documentazione da una localizzazione base a localizzazioni target utilizzando servizi di traduzione AI.
 
 ```bash
 npx intlayer doc translate
@@ -341,37 +350,97 @@ npx intlayer doc translate
 
 ##### Argomenti:
 
+**Opzioni per la lista dei 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/**"`
-- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: Numero di file da processare simultaneamente per la traduzione.
-  > Esempio: `npx intlayer doc translate --nb-simultaneous-file-processed 5`
+
+- **`--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 orario assoluto come "2025-12-05" (stringa o Date)
+  - Può essere un orario relativo in ms `1 * 60 * 60 * 1000` (1 ora)
+  - Questa opzione controlla l'orario 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"`
+
+**Opzioni di output dell'entry:**
+
 - **`--locales [locales...]`**: Locali di destinazione per tradurre la documentazione.
+
   > Esempio: `npx intlayer doc translate --locales fr es de`
-- **`--base-locale [baseLocale]`**: Locale di origine da cui tradurre.
+
+- **`--base-locale [baseLocale]`**: Locale sorgente da cui tradurre.
+
   > Esempio: `npx intlayer doc translate --base-locale en`
-- **`--model [model]`**: Modello AI da utilizzare per la traduzione (es. `gpt-3.5-turbo`).
-- **`--provider [provider]`**: Provider AI da utilizzare per la traduzione.
+
+**Opzioni di elaborazione dei file:**
+
+- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: Numero di file da elaborare 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]`**: Fornire la propria chiave API per il servizio AI.
-- **`--custom-prompt [prompt]`**: Fornire un prompt personalizzato per le istruzioni di traduzione.
-- **`--application-context [applicationContext]`**: Fornire un contesto aggiuntivo per la traduzione AI.
-- **`--env`**: Specificare l'ambiente (ad esempio, `development`, `production`).
-- **`--env-file [envFile]`**: Fornire un file di ambiente personalizzato da cui caricare le variabili.
-- **`--base-dir`**: Specificare la directory base per il progetto.
-- **`--verbose`**: Abilitare il logging dettagliato per il debug.
-- **`--custom-instructions [customInstructions]`**: Istruzioni personalizzate aggiunte al prompt. Utile per applicare regole specifiche riguardanti il formato, la traduzione degli URL, ecc.
+- **`--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, è consigliato utilizzare l'opzione `--custom-instructions` in quanto offre un controllo migliore sul comportamento della traduzione.)
 
-##### Esempio:
+  > 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"`
 
-```bash
-npx intlayer doc translate
-  --doc-pattern "docs/en/**/*.md"
-  --base-locale en --locales fr es
-  --model chatgpt-4o-latest
-  --custom-instructions "$(cat ./instructions.md)"
-```
+**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.
+- **`--base-dir`**: Specifica la directory base per il progetto.
+
+  > Esempio: `npx intlayer doc translate --base-dir ./docs --env-file .env.production.local`
+
+**Opzioni di log:**
+
+- **`--verbose`**: Abilita il logging dettagliato per il debug.
+
+  > Esempio: `npx intlayer doc translate --verbose`
+
+**Opzioni per istruzioni personalizzate:**
+
+- **`--custom-instructions [customInstructions]`**: Istruzioni personalizzate aggiunte al prompt. Utile per applicare regole specifiche riguardanti la formattazione, la traduzione degli URL, ecc.
+
+  - Può essere un tempo assoluto come "2025-12-05" (stringa o Data)
+  - 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 (default `origin/main`) al ramo corrente (default: `HEAD`).
+- **`--git-diff-base`**: Specifica il riferimento base per il git diff (default `origin/main`).
+- **`--git-diff-current`**: Specifica il riferimento corrente per il git diff (default: `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
 >
@@ -381,7 +450,7 @@ npx intlayer doc translate
 > - `{{baseLocale}}_` con `{{locale}}_`
 > - `.{{baseLocaleName}}.` con `.{{localeName}}.`
 >
-> Se il modello non viene trovato, il file di output aggiungerà `.{{locale}}` all'estensione del file. `./my/file.md` sarà tradotto in `./my/file.it.md` per la localizzazione italiana.
+> Se il modello 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 lingua francese.
 
 #### Revisione della Documentazione
 
@@ -391,21 +460,22 @@ Il comando `doc review` analizza i file di documentazione per qualità, coerenza
 npx intlayer doc review
 ```
 
+Può essere utilizzato per revisionare file già tradotti e per verificare se la traduzione è corretta.
+
+Per la maggior parte dei casi,
+
+- preferisci usare il comando `doc translate` quando la versione tradotta di questo file non è disponibile.
+- preferisci usare il comando `doc review` quando la versione tradotta di questo file esiste già.
+
+> Nota che il processo di revisione consuma più token di input rispetto al processo di traduzione per revisionare completamente lo stesso file. Tuttavia, il processo di revisione ottimizzerà i chunk da revisionare e salterà le parti che non sono state modificate.
+
 ##### Argomenti:
 
 Il comando `doc review` accetta gli stessi argomenti di `doc translate`, permettendoti di revisionare file di documentazione specifici e applicare controlli di qualità.
 
-##### Esempio:
-
-```bash
-npx intlayer doc review
- --doc-pattern "docs/en/**/*.md"
- --locales fr es de
- --model chatgpt-4o-latest
- --custom-instructions "$(cat ./instructions.md)"
-```
+Se hai attivato una delle opzioni git, il comando esaminerà solo la parte dei file che viene modificata. Lo script elaborerà il file suddividendolo in chunk e revisionerà ogni chunk. Se non ci sono modifiche nel chunk, lo script lo salterà per velocizzare il processo di revisione e limitare il costo dell'API del fornitore AI.
 
-## Usa i comandi di intlayer nel tuo `package.json`
+## Usa i comandi intlayer nel tuo `package.json`
 
 ```json fileName="package.json"
 "scripts": {
@@ -419,9 +489,51 @@ npx intlayer doc review
 }
 ```
 
+## CLI SDK
+
+Il CLI SDK è una libreria che ti permette di utilizzare il CLI di Intlayer nel tuo codice.
+
+```bash packageManager="npm"
+npm install @intlayer/cli --save-dev
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/cli --save-dev
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/cli --save-dev
+```
+
+Esempio di utilizzo:
+
+```ts
+import {
+  push,
+  pull,
+  fill,
+  build,
+  docTranslate,
+  docReview,
+} from "@intlayer/cli";
+
+push();
+// ...
+pull();
+// ...
+fill();
+// ...
+build();
+// ...
+docTranslate();
+// ...
+docReview();
+// ...
+```
+
 ## Debug del comando intlayer
 
-### 1. **Assicurati di usare l'ultima versione**
+### 1. **Assicurati di utilizzare l'ultima versione**
 
 Esegui:
 
@@ -451,4 +563,7 @@ npx clear-npx-cache
 
 ## Cronologia della documentazione
 
-- 5.5.10 - 2025-06-29: Inizio cronologia
+| Versione | Data       | Modifiche                                                        |
+| -------- | ---------- | ---------------------------------------------------------------- |
+| 5.5.11   | 2025-07-11 | Aggiornamento della documentazione dei parametri dei comandi CLI |
+| 5.5.10   | 2025-06-29 | Inizializzazione della cronologia                                |

package/docs/it/intlayer_visual_editor.md

@@ -15,6 +15,7 @@ slugs:
   - doc
   - concept
   - editor
+youtubeVideo: https://www.youtube.com/watch?v=UDDTnirwi_4
 ---
 
 # Documentazione dell'Editor Visivo di Intlayer

package/docs/it/intlayer_with_angular.md

@@ -13,6 +13,7 @@ slugs:
   - doc
   - environment
   - angular
+# applicationTemplate: https://github.com/aymericzip/intlayer-angular-template
 ---
 
 # Iniziare con l'internazionalizzazione (i18n) in Angular usando Intlayer