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

title: Administrar traducciones
description: "Cómo administrar traducciones con la CLI de General Translation: esta guía explica cómo dividir el flujo de trabajo en etapas de subida, encolado y descarga, preparar traducciones para revisión y sincronizar ediciones locales."
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` no espera, puedes ejecutar `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.

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

Si tu Proyecto usa revisión humana, utiliza [`gt stage`](/docs/cli/reference/commands/stage) en lugar de traducirlas directamente. Funciona como [`translate`](/docs/cli/reference/commands/translate), pero deja los resultados pendientes de aprobación en lugar de descargarlos o publicarlos.

```bash
npx gt stage
```

Al ejecutar `stage`, se establece `stageTranslations: true` en tu `gt.config.json`. Una vez aprobadas las traducciones, ejecuta `gt translate` para descargarlas. Mientras `stageTranslations` esté habilitado, `translate` solo descargará las versiones que hayas preparado con `stage`; si no has preparado nada con `stage`, no habrá nada que descargar.

## 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. Si, en cambio, quieres incluir los cambios locales como parte de una ejecución de traducción, pasa `--save-local` a `translate`.
## Next steps

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