---
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.

## Punti chiave:

- Divide i file markdown grandi in parti per rimanere entro i limiti della finestra di contesto del modello AI.
- Riprova la traduzione se il formato di output è errato.
- Incorpora il contesto specifico dell'applicazione e del file per migliorare l'accuratezza della traduzione.
- Preserva le traduzioni esistenti non sovrascrivendole.
- Elabora file, parti e locali in parallelo utilizzando un sistema di code per aumentare la velocità.

```bash packageManager="npm"
npx intlayer doc translate
```

```bash packageManager="yarn"
yarn intlayer doc translate
```

```bash packageManager="pnpm"
pnpm intlayer doc translate
```

```bash packageManager="bun"
bun x 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.
- **`--data-serialization [dataSerialization]`**: Il formato di serializzazione dei dati da utilizzare per le funzionalità AI di Intlayer. Opzioni: `json` (standard, affidabile), `toon` (meno token, meno coerente).
- **`--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.
