# gt: General Translation CLI tool: gt upload
URL: https://generaltranslation.com/fr/docs/cli/reference/commands/upload.mdx
Docs index: https://generaltranslation.com/llms.txt
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 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 : nécessite un ID de projet ainsi qu’une [connexion enregistrée ou une clé d’outillage explicite](/docs/cli/guides/configuring#credentials), avec les permissions correspondant aux opérations demandées.*

```bash
npx gt upload
```

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

1. Lit `gt.config.json` pour déterminer quels fichiers téléverser.
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. Téléverse les nouveaux fichiers source et ceux qui ont été modifiés, ainsi que tous les fichiers de traduction locaux, vers la branche résolue.
7. Applique les règles de publication et de dépublication configurées pour le CDN. `--publish` définit la publication comme valeur par défaut globale, tandis que les règles explicites `publish: false` par fichier continuent d’exclure ces fichiers.

## Options [#flags]

`upload` enregistre les [options de traduction](/docs/cli/reference/commands/translate#flags) partagées, mais n’utilise que celles pertinentes pour recenser, téléverser et publier des fichiers. Les principales options sont indiquées ci-dessous.

| Paramètre                   | Description                                                                                                                                                                                                         | Type       | Facultatif | Par défaut                                  |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | ---------- | ------------------------------------------- |
| `--api-key <key>`           | Clé d’outillage explicite, qui remplace celle utilisée par défaut.                                                                                                                                                  | `string`   | Oui        | `GT_API_KEY`, sinon la session de connexion |
| `--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`                                        |
| `--publish`                 | Active la publication par défaut à l’échelle globale ; les exclusions explicites par fichier restent applicables.                                                                                                   | `boolean`  | Oui        | `false`                                     |
| `--enable-branching`        | Suit le téléversement sur une branche git.                                                                                                                                                                             | `boolean`  | Oui        | —                                           |
| `--branch <branch>`         | Nom de la branche à utiliser au lieu de la détection automatique. Active la gestion des branches, sauf si la configuration la désactive explicitement ; passez `--enable-branching` pour remplacer ce comportement. | `string`   | Oui        | —                                           |

<Callout type="warn">
  Dans `gt` 2.20.1, `upload` accepte `--dry-run` mais téléverse tout de même les fichiers. Son option partagée `--timeout` contrôle l’attente de la traduction et n’a aucun effet sur cette commande. Pour inspecter les fichiers recensés sans les téléverser, utilisez [`gt stage --dry-run`](/docs/cli/reference/commands/stage).
</Callout>

## 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 locaux.
* Les traductions existantes dont le contenu correspond toujours à `gt-lock.json` sont ignorées. Les autres traductions locales sont téléversées et peuvent remplacer les traductions stockées. En l’absence de fichier de verrouillage, les traductions locales sont téléversées.
* Les fichiers de traduction JSON et YAML qui ne peuvent pas être analysés sont ignorés avec un avertissement, et le reste du lot est tout de même téléversé (`gt` 2.26.7 et versions ultérieures).
* Les traductions locales sont stockées sur la branche résolue par cette commande : la branche par défaut du projet lorsque la gestion des branches est désactivée, ou la branche indiquée par `--branch <name>` ou détectée via git lorsque la gestion des branches est activée. Avant `gt` 2.26.7, elles étaient stockées sur la branche par défaut.
* 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.
* Activez le CDN dans les paramètres de votre projet avant la publication. Si la publication échoue, le téléversement reste réussi et la CLI émet un avertissement.

## Sitemap

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