# gt: General Translation CLI tool: Lottie
URL: https://generaltranslation.com/it/docs/cli/reference/formats/lottie-files.mdx
Docs index: https://generaltranslation.com/llms.txt
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.

## Panoramica [#overview]

| Argomento                           | Descrizione                                                                |
| ----------------------------------- | -------------------------------------------------------------------------- |
| [Configurazione](#config)           | Configura i percorsi dei file `.lottie` sorgente e tradotti.               |
| [Workflow di traduzione](#workflow) | Prepara le attività asincrone e scarica le animazioni completate.          |
| [Elaborazione del layout](#layout)  | Adatta il testo tradotto preservando il design dell'animazione.        |
| [Espressioni](#expressions)         | Rimuovi le espressioni eseguibili di After Effects prima della traduzione. |
| [Font](#fonts)                      | Carica i font utilizzati durante l'elaborazione del layout tradotto.   |
| [Output binario](#binary)           | Gestisci il trasferimento in base64 e i file `.lottie` decodificati.       |

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

## Elaborazione del layout [#layout]

L'elaborazione del layout preserva le dimensioni dei font dell'animazione. Ridispone il testo e adatta i livelli circostanti alle etichette tradotte. Se un'etichetta continua a non rientrare, il processo può abbreviarla o riformularla nella lingua di destinazione, preservandone il significato. La troncatura con puntini di sospensione è l'ultima risorsa.

I token di codice formattati come testo monospaziato non vengono abbreviati né riformulati. I commenti discorsivi possono invece essere riformulati per adattarsi allo spazio disponibile.

Se non è possibile renderizzare e verificare le modifiche al layout, il job viene completato con l'animazione tradotta di base, senza applicare modifiche non verificate. Esamina l'animazione scaricata prima di pubblicarla.

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

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.