# gt: General Translation CLI tool: Administrar traducciones URL: https://generaltranslation.com/es/docs/cli/guides/managing-translations.mdx Docs index: https://generaltranslation.com/llms.txt Description: Cómo subir, encolar, descargar, preparar y sincronizar ediciones de traducciones locales con la CLI de General Translation. 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 versiones preparadas con `stage` anteriormente. Mientras `stageTranslations` esté habilitado, [`translate`](/docs/cli/reference/commands/translate) solo descargará las versiones que hayas preparado con `stage`. Si no hay nada preparado con `stage`, finalizará sin descargar archivos. ## 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. Para realizar este paso automáticamente antes de que [`gt translate`](/docs/cli/reference/commands/translate) o [`gt stage`](/docs/cli/reference/commands/stage) encolen nuevas tareas, pasa `--save-local` o establece [`options.saveLocal`](/docs/cli/reference/config#save-local) en `true` en `gt.config.json`. Para los archivos `.strings` y `.stringsdict` de Apple y los archivos `strings.xml` de Android, la plataforma valida y guarda el documento editado completo. Para `.xcstrings`, la CLI rastrea y envía cada configuración regional por separado aunque todas se almacenen en el mismo archivo. ## Next steps - /docs/cli/guides/generating-translations - /docs/cli/guides/branching - /docs/cli/guides/configuring - /docs/cli/guides/using-autoderive ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.