# gt: General Translation CLI tool: gt stage
URL: https://generaltranslation.com/fr/docs/cli/reference/commands/stage.mdx
Docs index: https://generaltranslation.com/llms.txt
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, [`gt translate`](/docs/cli/reference/commands/translate) ne télécharge que les versions mises en attente. Si aucune version n’est mise en attente, son exécution se termine sans télécharger de fichiers. 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 des versions précédemment mises 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é, [`translate`](/docs/cli/reference/commands/translate) ne télécharge que les versions mises en attente. En l’absence de versions mises en attente, il se termine sans télécharger de fichiers. Téléchargez les traductions terminées avec [`gt download`](/docs/cli/reference/commands/download), ou utilisez [`gt translate`](/docs/cli/reference/commands/translate).

## 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 téléverser ni mettre en file d’attente les traductions.                                                                                         | `boolean`  | Oui        | `false`          |
| `--save-local, --no-save-local` | Active ou désactive l’enregistrement des modifications locales avant la mise en file d’attente. Remplace [`options.saveLocal`](/docs/cli/reference/config#save-local). | `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).

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.