# gt: General Translation CLI tool: gt save-local
URL: https://generaltranslation.com/fr/docs/cli/reference/commands/save-local.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Synchronise les modifications locales apportées aux traductions avec la plateforme General Translation. Référence API de la commande gt save-local.

Envoie à la plateforme General Translation les modifications locales que vous avez apportées aux fichiers de traduction en soumettant des diffs. Ne met aucune nouvelle traduction en file d’attente — synchronise uniquement vos modifications locales. Voir [Gérer les traductions](/docs/cli/guides/managing-translations#save-local).

Utilisez-la lorsque vous ou un traducteur modifiez manuellement des fichiers de traduction téléchargés et que vous souhaitez que ces changements soient répercutés sur la plateforme.

*Remarque : nécessite un ID de projet et une [connexion enregistrée ou une clé d’outillage explicite](/docs/cli/guides/configuring#credentials), avec les autorisations requises pour les opérations demandées.*

```bash
npx gt save-local
```

## Fonctionnement [#how-it-works]

1. Lit les fichiers configurés dans `gt.config.json`. Lorsque `files.gt.output` est configuré et que `gt-lock.json` consigne une version GTJSON téléchargée, la commande inclut également ces fichiers de traduction générés.
2. Détermine la branche Git actuelle.
3. Identifie les fichiers modifiés depuis le dernier téléchargement en comparant les hachages de contenu.
4. Récupère le contenu d’origine sur le serveur et calcule un diff pour chaque fichier modifié.
5. Soumet les diffs à la plateforme. Seuls les fichiers modifiés sont traités.
6. Lorsqu’au moins un diff a été enregistré et que la publication est configurée ou que `--publish` est défini, applique les règles de publication et de dépublication CDN configurées. En l’absence de modifications locales, la publication est ignorée.

## Options [#flags]

| Paramètre             | Description                                                                                | Type      | Facultatif | Par défaut                                  |
| --------------------- | ------------------------------------------------------------------------------------------ | --------- | ---------- | ------------------------------------------- |
| `--api-key <key>`     | Clé d&#39;outillage explicite, prioritaire sur la valeur 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 du fichier de configuration.                                                        | `string`  | Oui        | `gt.config.json`                            |
| `--publish`           | Applique les règles de publication sur le CDN après l&#39;enregistrement des diffs locaux. | `boolean` | Oui        | `false`                                     |

## Exemple [#example]

```bash
# Envoyer les modifications locales des fichiers de traduction vers la plateforme
npx gt save-local

# Synchroniser les modifications et publier les traductions mises à jour sur le CDN
npx gt save-local --publish
```

## Autres remarques [#notes]

* Le CLI consigne les traductions téléchargées dans un fichier de verrouillage et ne traite que les fichiers modifiés depuis le dernier téléchargement.
* La sortie GTJSON générée suit `files.gt.publish` lorsque cette option est définie et, à défaut, se replie sur l&#39;option `publish` de premier niveau ; les motifs par fichier ne s&#39;appliquent pas.
* [`gt translate`](/docs/cli/reference/commands/translate) et [`gt stage`](/docs/cli/reference/commands/stage) n&#39;enregistrent pas les modifications locales par défaut. Activez cette étape pour une seule exécution avec `--save-local`, ou pour toutes les exécutions avec [`options.saveLocal`](/docs/cli/reference/config#save-local). Utilisez `gt save-local` lorsque vous souhaitez synchroniser les modifications sans lancer de nouveaux travaux de traduction.
* Les fichiers Apple `.strings` et `.stringsdict`, les fichiers Android `strings.xml` ainsi que les fichiers .NET `.resx` et `.resw` sont validés et enregistrés comme des documents bruts complets. Pour `.xcstrings`, le CLI suit et soumet séparément la portion de chaque paramètre régional, même si tous les paramètres régionaux partagent un même fichier.
* Ne stockez jamais votre clé API dans `gt.config.json`. Le CLI lit automatiquement `GT_API_KEY` depuis l&#39;environnement.

### Historique des versions

| Version  | Modifications                                                                                                                       |
| -------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| `2.25.0` | Ajout de la synchronisation des modifications locales et de la publication configurée sur le CDN pour la sortie GTJSON téléchargée. |

## Sitemap

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