# gt: General Translation CLI tool: Lottie
URL: https://generaltranslation.com/it/docs/cli/reference/formats/lottie-files.mdx
---

title: Lottie
description: Traduci i file di animazione dotLottie con la CLI di General Translation. Riferimento API per il formato di file Lottie.

---

La CLI traduce il testo nei file di animazione dotLottie binari (`.lottie`) e salva ogni risultato come file `.lottie` completo. I job Lottie includono una fase asincrona di elaborazione del layout, pertanto utilizzano il workflow separato di staging e download.

## Configurazione [#config]

Aggiungi una voce `lottie` in `files` con un array `include` di pattern glob. Usa il placeholder `[locale]` affinché la CLI possa individuare le animazioni sorgente e salvare i file tradotti per ciascuna impostazione regionale di destinazione.

```json title="gt.config.json"
{
  "defaultLocale": "en",
  "locales": ["es", "fr"],
  "files": {
    "lottie": {
      "include": ["animations/[locale]/**/*.lottie"],
      "exclude": ["animations/[locale]/drafts/**"]
    }
  }
}
```

Con questa configurazione, le animazioni sorgente provengono da `animations/en/`, mentre quelle tradotte vengono salvate in `animations/es/` e `animations/fr/`. Consulta la [documentazione di riferimento sulla configurazione](/docs/cli/reference/config#files) per le chiavi file condivise.

## Workflow di Translation [#workflow]

Esegui [`gt stage`](/docs/cli/reference/commands/stage) per inviare le animazioni, quindi esegui [`gt download`](/docs/cli/reference/commands/download) finché tutte le impostazioni regionali non saranno completate:

```bash
npx gt stage
npx gt download
```

Le traduzioni ancora in elaborazione vengono ignorate. Riesegui [`gt download`](/docs/cli/reference/commands/download) più tardi per scaricarle; la voce in staging rimane in `gt-lock.json` finché non vengono scaricate tutte le impostazioni regionali configurate.

[`gt translate`](/docs/cli/reference/commands/translate) non può completare un job Lottie non in staging in un'unica esecuzione. Quando `stageTranslations` è `false` e la configurazione include file Lottie, termina indicando di usare [`gt stage`](/docs/cli/reference/commands/stage) e [`gt download`](/docs/cli/reference/commands/download).

## Espressioni [#expressions]

I file Lottie con espressioni di After Effects vengono rifiutati perché contengono JavaScript eseguibile. Esporta nuovamente l'animazione rimuovendo le espressioni o convertendole in fotogrammi chiave, quindi sottoponila di nuovo allo staging.

## Font [#fonts]

Aggiungi una configurazione [`fonts`](/docs/cli/reference/config#fonts) al livello superiore quando un'animazione utilizza font che potrebbero non essere disponibili durante l'elaborazione del layout:

```json title="gt.config.json"
{
  "fonts": {
    "include": ["public/fonts/**/*.{ttf,otf}"]
  }
}
```

La CLI carica i font corrispondenti prima di accodare i job di traduzione. Se non è possibile sincronizzare un font, la traduzione prosegue utilizzando font di fallback e viene visualizzato un avviso.

## Output binario [#binary]

La CLI gestisce internamente i file `.lottie` in formato base64, quindi decodifica i risultati scaricati in file binari. Non trattare il contenuto scaricato come testo UTF-8 né modificare manualmente i dati base64 intermedi.