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

## Vue d’ensemble [#overview]

| Sujet                                    | Description                                                                       |
| ---------------------------------------- | --------------------------------------------------------------------------------- |
| [Configuration](#config)                 | Configurez les chemins des fichiers `.lottie` source et traduits.                 |
| [Workflow de traduction](#workflow)      | Mettez les tâches asynchrones en attente et téléchargez les animations terminées. |
| [Traitement de la mise en page](#layout) | Ajustez le texte traduit tout en préservant la conception de l’animation.         |
| [Expressions](#expressions)              | Supprimez les expressions exécutables d’After Effects avant la traduction.        |
| [Polices](#fonts)                        | Téléversez les polices utilisées lors du traitement de la mise en page traduite.  |
| [Sortie binaire](#binary)                | Gérez le transfert en base64 et les fichiers `.lottie` décodés.                   |

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

## Traitement de la mise en page [#layout]

Le traitement de la mise en page préserve la taille des polices de l’animation. Il redispose le texte et ajuste les calques adjacents pour adapter les libellés traduits. Lorsqu’un libellé ne tient toujours pas, le processus peut le raccourcir ou le reformuler dans la langue cible tout en préservant son sens. La troncature avec des points de suspension est le dernier recours.

Si les modifications de mise en page ne peuvent pas être affichées et vérifiées, la tâche se termine avec l’animation traduite de base au lieu d’appliquer des modifications non vérifiées. Vérifiez l’animation téléchargée avant de la publier.

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