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

title: Lottie
description: Traduisez des fichiers d’animation dotLottie avec la CLI de General Translation. Référence d’API du format de fichier Lottie.

---

La CLI traduit le texte des fichiers d’animation binaires dotLottie (`.lottie`) et enregistre chaque résultat sous la forme d’un fichier `.lottie` complet. Les tâches Lottie comprennent une phase asynchrone de traitement de la mise en page ; elles utilisent donc le workflow distinct de mise en attente et de téléchargement.

## Configuration [#config]

Ajoutez une entrée `lottie` sous `files` avec un tableau `include` de motifs glob. Utilisez le placeholder `[locale]` afin que la CLI puisse trouver les animations source et enregistrer les fichiers traduits dans chaque paramètre régional cible.

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

Avec cette configuration, les animations source proviennent de `animations/en/`, tandis que les animations traduites sont enregistrées dans `animations/es/` et `animations/fr/`. Consultez la [référence de configuration](/docs/cli/reference/config#files) pour les clés de fichiers communes.

## Workflow de traduction [#workflow]

Exécutez [`gt stage`](/docs/cli/reference/commands/stage) pour soumettre les animations, puis exécutez [`gt download`](/docs/cli/reference/commands/download) jusqu’à ce que chaque paramètre régional soit terminé :

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

Les traductions encore en cours de traitement sont ignorées. Exécutez de nouveau [`gt download`](/docs/cli/reference/commands/download) ultérieurement pour les récupérer ; l’entrée mise en attente reste dans `gt-lock.json` jusqu’à ce que tous les paramètres régionaux configurés aient été téléchargés.

[`gt translate`](/docs/cli/reference/commands/translate) ne peut pas terminer une tâche Lottie non mise en attente en une seule exécution. Lorsque `stageTranslations` est défini sur `false` et que la configuration inclut des fichiers Lottie, la commande se termine en indiquant d’utiliser [`gt stage`](/docs/cli/reference/commands/stage) et [`gt download`](/docs/cli/reference/commands/download).

## Expressions [#expressions]

Les fichiers Lottie contenant des expressions After Effects sont refusés, car ces expressions contiennent du JavaScript exécutable. Réexportez l’animation après avoir supprimé les expressions ou les avoir converties en images clés, puis mettez-la à nouveau en attente.

## Polices [#fonts]

Ajoutez une configuration [`fonts`](/docs/cli/reference/config#fonts) au niveau supérieur lorsqu'une animation utilise des polices susceptibles de ne pas être disponibles lors du traitement de la mise en page :

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

La CLI téléverse les polices correspondantes avant de mettre les tâches de traduction en file d’attente. Si une police ne peut pas être synchronisée, la traduction se poursuit avec des polices de secours et un avertissement est émis.

## Sortie binaire [#binary]

La CLI encode les fichiers `.lottie` en base64 en interne, puis décode les résultats téléchargés pour les restaurer en fichiers binaires. Ne traitez pas le contenu téléchargé comme du texte UTF-8 et ne modifiez pas manuellement les données base64 intermédiaires.