# gt: General Translation CLI tool: gt upload
URL: https://generaltranslation.com/fr/docs/cli/reference/commands/upload.mdx
---
title: gt upload
description: Importer les fichiers source et les traductions vers la plateforme General Translation. Référence de l’API pour la commande gt upload.

---

Importe les fichiers source de votre projet ainsi que toutes les traductions existantes vers la plateforme General Translation, en synchronisant les fichiers locaux pour permettre leur gestion, leur mise en file d’attente et leur suivi. Associez-la à [`gt enqueue`](/docs/cli/reference/commands/enqueue) et [`gt download`](/docs/cli/reference/commands/download) pour répartir la traduction sur plusieurs étapes de CI. Consultez [Gérer les traductions](/docs/cli/guides/managing-translations#split).

*Remarque : à utiliser uniquement en production. Nécessite un `GT_API_KEY` et un `GT_PROJECT_ID` de production.*

```bash
npx gt upload
```

## Comment ça marche [#how-it-works]

1. Lit `gt.config.json` pour déterminer quels fichiers importer.
2. Collecte tous les fichiers source traduisibles.
3. Calcule le hachage de chaque fichier pour générer un `fileId` (à partir de son chemin) et un `versionId` (à partir de son contenu).
4. Interroge l’API pour déterminer quels fichiers sont nouveaux ou modifiés.
5. Détecte les déplacements de fichiers — même contenu, chemin différent — et conserve les traductions existantes.
6. Envoie les nouveaux fichiers source et ceux qui ont été modifiés, ainsi que tous les fichiers de traduction locaux.

## Options [#flags]

`importer` accepte les mêmes options que [`gt translate`](/docs/cli/reference/commands/translate#flags). Les options les plus couramment utilisées avec cette commande sont indiquées ci-dessous ; la référence liée ci-dessus présente la liste complète.

| Paramètre                   | Description                                                                             | Type       | Facultatif | Par défaut       |
| --------------------------- | --------------------------------------------------------------------------------------- | ---------- | ---------- | ---------------- |
| `--api-key <key>`           | Clé d’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`             |
| `--timeout <seconds>`       | Délai d’expiration de la requête, en secondes.                                          | `number`   | Oui        | `900`            |
| `--dry-run`                 | Recense les fichiers et les affiche sans les importer.                                | `boolean`  | Oui        | `false`          |

## Exemple [#example]

```bash
# Étape 1 : importer des fichiers source (cette commande)
npx gt upload

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

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

## Autres remarques [#notes]

* `upload` collecte les fichiers source traduisibles de chaque type configuré (JSON, YAML, Markdown, MDX, etc.), ainsi que tous les fichiers de traduction locale.
* Comme il calcule un hachage pour chaque fichier à partir de son chemin et de son contenu, les fichiers déplacés (même contenu, nouveau chemin) conservent leurs traductions existantes au lieu d’être retraduits.