# gt: General Translation CLI tool: gt stage
URL: https://generaltranslation.com/fr/docs/cli/reference/commands/stage.mdx
---

title: gt stage
description: Soumet un projet pour une traduction asynchrone et un téléchargement ultérieur. Référence API de la commande gt stage.

---

Soumet votre projet à la traduction asynchrone sans télécharger ni publier les résultats au cours de la même exécution. Utilisez cette commande lorsque la relecture humaine est activée pour votre projet ou lorsqu’un format tel que Lottie ne peut pas être traité en une seule exécution de [`gt translate`](/docs/cli/reference/commands/translate). Pour les deux workflows, consultez [Gérer les traductions](/docs/cli/guides/managing-translations).

L’exécution de `stage` définit `stageTranslations: true` dans votre `gt.config.json`. Une fois cette option activée, si vous exécutez [`gt translate`](/docs/cli/reference/commands/translate) sans d’abord avoir mis en attente une version donnée, la CLI se ferme avec une erreur. Lorsque les traductions sont prêtes — et approuvées lorsqu’une relecture est requise — 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.

*Remarque : pour une utilisation en production uniquement. Nécessite un `GT_API_KEY` de production et un `GT_PROJECT_ID`.*

```bash
npx gt stage
```

## Fonctionnement [#how-it-works]

1. Lit `gt.config.json`, analyse votre code source à la recherche de contenu inline dans les projets basés sur un framework et collecte les fichiers, de la même manière que [`gt translate`](/docs/cli/reference/commands/translate).
2. Envoie le contenu à l’API de General Translation sans télécharger ni publier les résultats au cours de cette même exécution. Les projets soumis à approbation conservent les traductions terminées en attente d’approbation.
3. Définit `stageTranslations: true` dans votre `gt.config.json` afin que les prochaines exécutions nécessitent une mise en attente.

Une fois `stageTranslations` activé, exécuter [`translate`](/docs/cli/reference/commands/translate) sans avoir d’abord mis cette version en attente fait échouer la CLI avec une erreur. Téléchargez les traductions terminées avec [`gt download`](/docs/cli/reference/commands/download), ou utilisez [`gt translate`](/docs/cli/reference/commands/translate) pour toute version précédemment mise en attente.

## Options [#flags]

`stage` accepte les mêmes options que [`gt translate`](/docs/cli/reference/commands/translate#flags), y compris les options d’analyse du source pour les projets basés sur un framework. Les options les plus couramment utilisées sont indiquées ci-dessous ; la référence ci-dessus donne la liste complète.

| Paramètre                   | Description                                                                                              | Type       | Facultatif | Par défaut       |
| --------------------------- | -------------------------------------------------------------------------------------------------------- | ---------- | ---------- | ---------------- |
| `--api-key <key>`           | Clé API de production.                                                                                   | `string`   | Oui        | `GT_API_KEY`     |
| `--project-id <id>`         | ID du projet.                                                                                            | `string`   | Oui        | `GT_PROJECT_ID`  |
| `-c, --config <path>`       | Chemin vers le fichier de configuration.                                                                 | `string`   | Oui        | `gt.config.json` |
| `--locales <locales...>`    | Paramètres régionaux cibles supplémentaires, ajoutés aux `locales` de la configuration.                  | `string[]` | Oui        | —                |
| `--default-locale <locale>` | Paramètre régional source du projet.                                                                     | `string`   | Oui        | `en`             |
| `--dry-run`                 | Analyse et valide sans appeler l’API.                                                                    | `boolean`  | Oui        | `false`          |
| `--tag [value]`             | Ajoute un tag à l’exécution ; est résolu automatiquement à partir de git si aucune valeur n’est fournie. | `string`   | Oui        | —                |
| `-m, --message <message>`   | Message associé au tag de traduction.                                                                    | `string`   | Oui        | —                |

## Exemple [#example]

```bash
# Mettre les traductions en attente pour la relecture humaine
npx gt stage

# Mettre en attente et tagger l'exécution pour le suivi dans le tableau de bord
npx gt stage --tag v2.1.0 -m "Q3 release"

# Lorsque les traductions sont prêtes, les télécharger
npx gt download
```

## Autres notes [#notes]

* Utilisez `stage` lorsque la relecture humaine est activée ou lors de la traduction de formats asynchrones tels que [Lottie](/docs/cli/reference/formats/lottie-files).
* La mise en attente définit la clé de configuration [`stageTranslations`](/docs/cli/reference/config#stage). Voir [Mettre les traductions en attente pour relecture](/docs/cli/guides/managing-translations#review).