# 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 gérer les traductions avec la CLI General Translation : ce guide explique comment scinder le workflow en étapes d’upload, d’enqueue et de download, mettre les traductions en attente pour relecture humaine et synchroniser les modifications locales."
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` n’est pas bloquant, vous pouvez exécuter `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.

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

Si votre projet utilise la relecture humaine, utilisez [`gt stage`](/docs/cli/reference/commands/stage) au lieu de traduire directement. Cette commande fonctionne comme [`translate`](/docs/cli/reference/commands/translate), mais met les résultats en attente d’approbation au lieu de les télécharger ou de les publier.

```bash
npx gt stage
```

L’exécution de `stage` active `stageTranslations: true` dans votre `gt.config.json`. Une fois les traductions approuvées, exécutez `gt translate` pour les télécharger. Tant que `stageTranslations` est activé, `translate` ne télécharge que les versions que vous avez mises en attente ; si rien n’a été mis en attente, il n’y a rien à télécharger.

## 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 n’ajoute aucune nouvelle traduction à la file d’attente. Pour inclure plutôt les modifications locales dans le cadre d’une exécution de traduction, passez `--save-local` à `translate`.
## Next steps

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