# gt: General Translation CLI tool: Gestion des traductions
URL: https://generaltranslation.com/fr/docs/cli/guides/managing-translations.mdx
---
title: Gestion des traductions
description: Comment upload, enqueue, download, mettre en attente et synchroniser les modifications locales de traduction avec la CLI General Translation.
related:
  links:
    - /docs/cli/guides/generating-translations
    - /docs/cli/guides/branching
    - /docs/cli/guides/configuring
    - /docs/cli/guides/using-autoderive

---

La commande [`gt translate`](/docs/cli/reference/commands/translate) exécute l’ensemble du processus de traduction en une seule étape. Lorsque vous avez besoin de plus de contrôle — par exemple avec des étapes de CI distinctes ou une étape de relecture humaine — la CLI expose chaque étape de ce processus sous forme de commande distincte.

*Remarque : ces commandes nécessitent une clé API de production. Définissez `GT_API_KEY` et `GT_PROJECT_ID` comme variables d’environnement.*

## Répartir la traduction sur plusieurs étapes du CI [#split]

Dans un pipeline CI, vous avez souvent besoin d’importer du contenu, de le traduire, puis de télécharger les résultats dans des jobs distincts. Trois commandes correspondent à ces étapes.

1. [`gt upload`](/docs/cli/reference/commands/upload) importe les fichiers source (ainsi que les traductions existantes) sur la plateforme.
2. [`gt enqueue`](/docs/cli/reference/commands/enqueue) place les fichiers importés en file d’attente pour la traduction et renvoie immédiatement, sans attendre les résultats.
3. [`gt download`](/docs/cli/reference/commands/download) télécharge les traductions terminées et les enregistre aux emplacements définis dans votre configuration.

```bash
# Étape 1 : téléverser les fichiers source
npx gt upload

# Étape 2 : mettre en attente les traductions
npx gt enqueue

# Étape 3 : télécharger quand prêt
npx gt download
```

Comme [`enqueue`](/docs/cli/reference/commands/enqueue) n’est pas bloquant, vous pouvez exécuter [`download`](/docs/cli/reference/commands/download) dans un job ultérieur une fois les traductions prêtes. Cela évite de garder un job de build ouvert pendant l’exécution de la traduction.

## Traduire les animations Lottie [#lottie]

La traduction des animations Lottie inclut un traitement asynchrone de la mise en page. [`gt translate`](/docs/cli/reference/commands/translate) ne peut donc pas les soumettre et les télécharger en une seule exécution. Mettez les animations en attente, puis téléchargez les paramètres régionaux terminés :

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

Si certains paramètres régionaux sont encore en cours de traitement, ils sont ignorés lors du téléchargement. Relancez [`gt download`](/docs/cli/reference/commands/download) ultérieurement ; le fichier mis en attente reste dans `gt-lock.json` jusqu’à ce que tous les paramètres régionaux configurés aient été téléchargés. Consultez la [référence du format Lottie](/docs/cli/reference/formats/lottie-files) pour connaître les restrictions relatives à la configuration, aux polices et aux expressions.

## Mettre les traductions en attente pour relecture [#review]

Si votre projet utilise la relecture humaine, utilisez [`gt stage`](/docs/cli/reference/commands/stage) pour soumettre le travail de traduction sans télécharger ni publier les résultats lors de la même exécution. Les projets soumis à relecture conservent les traductions terminées en attente d’approbation.

```bash
npx gt stage
```

L’exécution de [`stage`](/docs/cli/reference/commands/stage) active `stageTranslations: true` dans votre `gt.config.json`. Une fois les traductions approuvées, exécutez [`gt download`](/docs/cli/reference/commands/download). [`gt translate`](/docs/cli/reference/commands/translate) peut également télécharger une version précédemment mise en attente. Tant que `stageTranslations` est activé, [`translate`](/docs/cli/reference/commands/translate) ne télécharge que les versions que vous avez mises en attente ; si rien n’a été mis en attente, il se termine par une erreur.

## Enregistrer les modifications locales [#save-local]

Lorsque vous ou un traducteur modifiez manuellement des fichiers de traduction téléchargés, utilisez [`gt save-local`](/docs/cli/reference/commands/save-local) pour renvoyer ces modifications sur la plateforme.

```bash
npx gt save-local
```

La commande compare vos fichiers locaux aux dernières versions téléchargées, calcule les différences pour tout ce qui a changé et les soumet. Elle ne met aucune nouvelle traduction en file d’attente. [`gt translate`](/docs/cli/reference/commands/translate) effectue cette étape d’enregistrement par défaut avant de mettre de nouvelles tâches en file d’attente ; passez `--no-save-local` pour l’ignorer lors d’une exécution.
## Next steps

- /docs/cli/guides/generating-translations
- /docs/cli/guides/branching
- /docs/cli/guides/configuring
- /docs/cli/guides/using-autoderive