# gt: General Translation CLI tool: Administrar traducciones
URL: https://generaltranslation.com/es/docs/cli/guides/managing-translations.mdx
---

title: Administrar traducciones
description: Cómo subir, encolar, descargar, preparar y sincronizar ediciones de traducciones locales con la CLI de General Translation.
related:
  links:
    - /docs/cli/guides/generating-translations
    - /docs/cli/guides/branching
    - /docs/cli/guides/configuring
    - /docs/cli/guides/using-autoderive

---

El comando [`gt translate`](/docs/cli/reference/commands/translate) ejecuta todo el flujo de traducción en un solo paso. Cuando necesitas más control, por ejemplo, etapas de CI separadas o un paso de revisión humana, la CLI expone cada parte de ese flujo como un comando independiente.

*Nota: Estos comandos requieren una clave API de producción. Configura `GT_API_KEY` y `GT_PROJECT_ID` como variables de entorno.*

## Dividir la traducción entre etapas de CI [#split]

En un flujo de CI, a menudo conviene subir contenido, traducirlo y descargar los resultados en trabajos separados. Tres comandos se corresponden con esas etapas.

1. [`gt upload`](/docs/cli/reference/commands/upload) sube archivos fuente (y cualquier traducción existente) a la plataforma.
2. [`gt enqueue`](/docs/cli/reference/commands/enqueue) encola los archivos subidos para su traducción y devuelve el control de inmediato, sin esperar los resultados.
3. [`gt download`](/docs/cli/reference/commands/download) descarga las traducciones completadas y las guarda en las rutas de tu configuración.

```bash
# Etapa 1: subir archivos fuente
npx gt upload

# Etapa 2: encolar traducciones
npx gt enqueue

# Etapa 3: descargar cuando estén listas
npx gt download
```

Como [`enqueue`](/docs/cli/reference/commands/enqueue) no espera, puedes ejecutar [`download`](/docs/cli/reference/commands/download) en un trabajo posterior cuando las traducciones estén listas. Esto evita mantener abierto un trabajo de compilación mientras se realiza la traducción.

## Traduce animaciones de Lottie [#lottie]

Las traducciones de Lottie incluyen procesamiento de diseño asíncrono, por lo que [`gt translate`](/docs/cli/reference/commands/translate) no puede enviarlas y descargarlas en una sola ejecución. Prepara las animaciones y, después, descarga las configuraciones regionales completadas:

```bash
npx gt stage
npx gt download
```

Si algunos locales aún se están procesando, la descarga los omite. Vuelve a ejecutar [`gt download`](/docs/cli/reference/commands/download) más tarde; el archivo preparado permanece en `gt-lock.json` hasta que se hayan descargado todos los locales configurados. Consulta la [referencia del formato Lottie](/docs/cli/reference/formats/lottie-files) para conocer las restricciones de configuración, fuentes y expresiones.

## Prepara las traducciones para su revisión [#review]

Si tu Proyecto usa revisión humana, utiliza [`gt stage`](/docs/cli/reference/commands/stage) para enviar el trabajo de traducción sin descargar ni publicar los resultados en la misma ejecución. Los Proyectos que requieren revisión conservan las traducciones completadas pendientes de aprobación.

```bash
npx gt stage
```

Al ejecutar [`stage`](/docs/cli/reference/commands/stage), se establece `stageTranslations: true` en tu `gt.config.json`. Una vez aprobadas las traducciones, ejecuta [`gt download`](/docs/cli/reference/commands/download). [`gt translate`](/docs/cli/reference/commands/translate) también puede descargar una versión preparada con `stage` anteriormente. Mientras `stageTranslations` esté habilitado, [`translate`](/docs/cli/reference/commands/translate) solo descargará las versiones que hayas preparado con `stage`; si no has preparado nada con `stage`, finalizará con un error.

## Guardar ediciones locales [#save-local]

Si editas manualmente archivos de traducción descargados, o si lo hace un traductor, usa [`gt save-local`](/docs/cli/reference/commands/save-local) para enviar esos cambios de vuelta a la plataforma.

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

El comando compara tus archivos locales con las últimas versiones descargadas, calcula un diff de cualquier cambio y lo envía. No encola ninguna traducción nueva. [`gt translate`](/docs/cli/reference/commands/translate) realiza este paso de guardado de forma predeterminada antes de encolar nuevas tareas; pasa `--no-save-local` para omitirlo en una ejecución.
## Next steps

- /docs/cli/guides/generating-translations
- /docs/cli/guides/branching
- /docs/cli/guides/configuring
- /docs/cli/guides/using-autoderive