# gt: General Translation CLI tool: gt save-local
URL: https://generaltranslation.com/es/docs/cli/reference/commands/save-local.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Sincroniza de vuelta a la plataforma de General Translation las ediciones locales hechas en las traducciones. Referencia de API del comando `gt save-local`.

Envía a la plataforma de General Translation las ediciones locales que hayas hecho en los archivos de traducción mediante diffs. No pone en cola traducciones nuevas; solo sincroniza tus cambios locales. Consulta [Administrar traducciones](/docs/cli/guides/managing-translations#save-local).

Úsalo cuando tú o un traductor editen manualmente archivos de traducción descargados y quieras que esos cambios se reflejen en la plataforma.

*Nota: Requiere un ID del Project y un [inicio de sesión guardado o una clave de herramientas explícita](/docs/cli/guides/configuring#credentials), con permisos para las operaciones solicitadas.*

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

## Cómo funciona [#how-it-works]

1. Lee los archivos configurados en `gt.config.json`. Cuando `files.gt.output` está configurado y `gt-lock.json` registra una versión descargada de GTJSON, también incluye esos archivos de traducción generados.
2. Determina la rama actual de Git.
3. Identifica los archivos que cambiaron desde la última descarga comparando sus hashes de contenido.
4. Obtiene el contenido original del servidor y calcula un diff para cada archivo modificado.
5. Envía los diffs a la plataforma. Solo se procesan los archivos modificados.
6. Cuando se ha guardado al menos un diff y la publicación está configurada o se ha indicado `--publish`, aplica las reglas configuradas de publicación y despublicación en el CDN. Si no hay cambios locales, omite la publicación.

## Opciones [#flags]

| Parámetro             | Descripción                                                                | Tipo      | Opcional | Predeterminado                           |
| --------------------- | -------------------------------------------------------------------------- | --------- | -------- | ---------------------------------------- |
| `--api-key <key>`     | Clave de herramientas explícita que reemplaza la predeterminada.           | `string`  | Sí       | `GT_API_KEY`; si no, el inicio de sesión |
| `--project-id <id>`   | ID del Project.                                                           | `string`  | Sí       | `GT_PROJECT_ID`                          |
| `-c, --config <path>` | Ruta al archivo de configuración.                                          | `string`  | Sí       | `gt.config.json`                         |
| `--publish`           | Aplica las reglas de publicación en la CDN tras guardar los diffs locales. | `boolean` | Sí       | `false`                                  |

## Ejemplo [#example]

```bash
# Enviar ediciones locales de los archivos de traducción de vuelta a la plataforma
npx gt save-local

# Sincronizar ediciones y publicar las traducciones actualizadas en el CDN
npx gt save-local --publish
```

## Otras notas [#notes]

* La CLI registra las traducciones descargadas en un archivo de bloqueo y solo procesa los archivos que cambiaron desde la última descarga.
* La salida GTJSON generada usa `files.gt.publish` si está definido y, de lo contrario, recurre al valor `publish` de nivel superior; los patrones por archivo no se aplican.
* [`gt translate`](/docs/cli/reference/commands/translate) y [`gt stage`](/docs/cli/reference/commands/stage) no guardan las ediciones locales de forma predeterminada. Activa este paso para una sola ejecución con `--save-local`, o para todas las ejecuciones con [`options.saveLocal`](/docs/cli/reference/config#save-local). Usa `gt save-local` cuando quieras sincronizar las ediciones sin iniciar nuevas tareas de traducción.
* Los archivos `.strings` y `.stringsdict` de Apple, los archivos `strings.xml` de Android y los archivos `.resx` y `.resw` de .NET se validan y se guardan como documentos raw completos. Para `.xcstrings`, la CLI registra y envía por separado la porción de cada configuración regional, aunque todas compartan un mismo archivo.
* Nunca guardes tu clave de API en `gt.config.json`. La CLI lee `GT_API_KEY` del entorno automáticamente.

### Historial de versiones

| Versión  | Cambios                                                                                                                   |
| -------- | ------------------------------------------------------------------------------------------------------------------------- |
| `2.25.0` | Se añadieron la sincronización de ediciones locales y la publicación en CDN configurada para la salida GTJSON descargada. |

## Sitemap

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