# gt: General Translation CLI tool: Gestion des traductions URL: https://generaltranslation.com/fr/docs/cli/guides/managing-translations.mdx Docs index: https://generaltranslation.com/llms.txt Description: Comment upload, enqueue, download, mettre en attente et synchroniser les modifications locales de traduction avec la CLI General Translation. 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 des versions précédemment mises 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’est mis en attente, il se termine sans télécharger de fichiers. ## 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. Pour effectuer cette étape automatiquement avant que [`gt translate`](/docs/cli/reference/commands/translate) ou [`gt stage`](/docs/cli/reference/commands/stage) ne mette de nouvelles tâches en file d’attente, passez `--save-local` ou définissez [`options.saveLocal`](/docs/cli/reference/config#save-local) sur `true` dans `gt.config.json`. Pour les fichiers Apple `.strings` et `.stringsdict` ainsi que les fichiers Android `strings.xml`, la plateforme valide et enregistre l’intégralité du document modifié. Pour `.xcstrings`, la CLI suit et soumet chaque paramètre régional séparément, même si tous les paramètres régionaux sont stockés dans le même fichier. ## Next steps - /docs/cli/guides/generating-translations - /docs/cli/guides/branching - /docs/cli/guides/configuring - /docs/cli/guides/using-autoderive ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.