# gt: General Translation CLI tool: gt save-local
URL: https://generaltranslation.com/it/docs/cli/reference/commands/save-local.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Sincronizza con la piattaforma General Translation le modifiche apportate localmente alle traduzioni. Riferimento API per il comando gt save-local.

Invia alla piattaforma General Translation le modifiche locali che hai apportato ai file di traduzione, inviando i diff. Non mette in coda nuove traduzioni: sincronizza solo le modifiche locali. Vedi [Gestire le traduzioni](/docs/cli/guides/managing-translations#save-local).

Usalo quando tu o un traduttore modificate manualmente i file di traduzione scaricati e vuoi che tali modifiche siano riportate nella piattaforma.

*Nota: richiede un ID progetto e un [login salvato o una chiave degli strumenti esplicita](/docs/cli/guides/configuring#credentials), con le autorizzazioni necessarie per le operazioni richieste.*

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

## Come funziona [#how-it-works]

1. Legge i file definiti in `gt.config.json`. Se `files.gt.output` è configurato e `gt-lock.json` registra una versione GTJSON scaricata, include anche i relativi file di traduzione generati.
2. Determina il branch Git corrente.
3. Identifica i file modificati dall'ultimo download confrontando gli hash del contenuto.
4. Recupera il contenuto originale dal server e calcola un diff per ogni file modificato.
5. Invia i diff alla piattaforma. Vengono elaborati solo i file modificati.
6. Se è stato salvato almeno un diff e la pubblicazione è configurata oppure è impostato `--publish`, applica le regole configurate di pubblicazione e annullamento della pubblicazione sulla CDN. In assenza di modifiche locali, la pubblicazione viene saltata.

## Flag [#flags]

| Parametro             | Descrizione                                                                   | Tipo      | Facoltativo | Predefinito                    |
| --------------------- | ----------------------------------------------------------------------------- | --------- | ----------- | ------------------------------ |
| `--api-key <key>`     | Sostituzione esplicita della chiave degli strumenti.                          | `string`  | Sì          | `GT_API_KEY`, altrimenti login |
| `--project-id <id>`   | ID progetto.                                                                  | `string`  | Sì          | `GT_PROJECT_ID`                |
| `-c, --config <path>` | Percorso del file di configurazione.                                          | `string`  | Sì          | `gt.config.json`               |
| `--publish`           | Applica le regole di pubblicazione sulla CDN dopo aver salvato i diff locali. | `boolean` | Sì          | `false`                        |

## Esempio [#example]

```bash
# Invia le modifiche locali ai file di traduzione alla piattaforma
npx gt save-local

# Sincronizza le modifiche e pubblica le traduzioni aggiornate sulla CDN
npx gt save-local --publish
```

## Altre note [#notes]

* La CLI tiene traccia delle traduzioni scaricate in un lock file ed elabora solo i file modificati dall&#39;ultimo download.
* L&#39;output GTJSON generato segue `files.gt.publish`, se impostato, altrimenti ricorre al `publish` di primo livello; i pattern per singolo file non vengono applicati.
* [`gt translate`](/docs/cli/reference/commands/translate) e [`gt stage`](/docs/cli/reference/commands/stage) non salvano le modifiche locali per impostazione predefinita. Attiva questo passaggio per una singola esecuzione con `--save-local`, oppure per tutte le esecuzioni con [`options.saveLocal`](/docs/cli/reference/config#save-local). Usa `gt save-local` quando vuoi sincronizzare le modifiche senza avviare nuove traduzioni.
* I file Apple `.strings` e `.stringsdict`, i file Android `strings.xml` e i file .NET `.resx` e `.resw` vengono validati e salvati come documenti non elaborati completi. Per `.xcstrings`, la CLI tiene traccia e invia separatamente la porzione di ciascuna impostazione regionale, anche se tutte le impostazioni regionali condividono un unico file.
* Non archiviare mai la tua chiave API in `gt.config.json`. La CLI legge automaticamente `GT_API_KEY` dall&#39;ambiente.

### Cronologia delle versioni

| Versione | Modifiche                                                                                                                         |
| -------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `2.25.0` | Aggiunta la sincronizzazione delle modifiche locali e la pubblicazione su CDN, se configurata, per l&#39;output GTJSON scaricato. |

## Sitemap

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