# gt: General Translation CLI tool: gt stage
URL: https://generaltranslation.com/es/docs/cli/reference/commands/stage.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Envía un proyecto para traducción asíncrona y descarga posterior. Referencia de API para el comando gt stage.

Envía tu proyecto para su traducción asíncrona sin descargar ni publicar los resultados en la misma ejecución. Úsalo cuando tu proyecto tenga habilitada la revisión humana o cuando un formato como Lottie no pueda completarse en una sola ejecución de [`gt translate`](/docs/cli/reference/commands/translate). Para ambos flujos de trabajo, consulta [Administrar traducciones](/docs/cli/guides/managing-translations).

Ejecutar `stage` establece `stageTranslations: true` en tu `gt.config.json`. Una vez habilitado, [`gt translate`](/docs/cli/reference/commands/translate) solo descarga versiones preparadas. Si no hay nada preparado, finaliza sin descargar archivos. Cuando las traducciones estén listas —y aprobadas si se requiere revisión—, ejecuta [`gt download`](/docs/cli/reference/commands/download). [`gt translate`](/docs/cli/reference/commands/translate) también puede descargar versiones preparadas anteriormente.

*Nota: Solo para uso en producción. Requiere un `GT_API_KEY` y `GT_PROJECT_ID` de producción.*

```bash
npx gt stage
```

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

1. Lee `gt.config.json`, analiza tu código fuente en busca de contenido inline en proyectos con frameworks y recopila archivos, igual que [`gt translate`](/docs/cli/reference/commands/translate).
2. Envía el contenido a la API de General Translation sin descargar ni publicar los resultados en la misma ejecución. Los proyectos con revisión obligatoria retienen las traducciones completadas para su aprobación.
3. Establece `stageTranslations: true` en tu `gt.config.json` para que las ejecuciones futuras requieran preparar.

Una vez que `stageTranslations` está habilitado, [`translate`](/docs/cli/reference/commands/translate) solo descarga versiones preparadas. Si no hay versiones preparadas, se completa sin descargar archivos. Descarga las traducciones completadas con [`gt download`](/docs/cli/reference/commands/download), o usa [`gt translate`](/docs/cli/reference/commands/translate).

## Opciones [#flags]

`stage` acepta las mismas opciones que [`gt translate`](/docs/cli/reference/commands/translate#flags), incluidas las opciones de escaneo del código fuente para proyectos con frameworks. A continuación se muestran las opciones que más se usan; la referencia enlazada arriba incluye la lista completa.

| Parámetro                       | Descripción                                                                                                                                   | Tipo       | Opcional | Predeterminado   |
| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | -------- | ---------------- |
| `--api-key <key>`               | Clave de API de producción.                                                                                                                   | `string`   | Sí       | `GT_API_KEY`     |
| `--project-id <id>`             | ID del proyecto.                                                                                                                              | `string`   | Sí       | `GT_PROJECT_ID`  |
| `-c, --config <path>`           | Ruta al archivo de configuración.                                                                                                             | `string`   | Sí       | `gt.config.json` |
| `--locales <locales...>`        | configuraciones regionales de destino adicionales, añadidas a `locales` de la configuración.                                                  | `string[]` | Sí       | —                |
| `--default-locale <locale>`     | configuración regional de origen del proyecto.                                                                                                | `string`   | Sí       | `en`             |
| `--dry-run`                     | Analiza y valida sin subir ni encolar traducciones.                                                                                           | `boolean`  | Sí       | `false`          |
| `--save-local, --no-save-local` | Activa o desactiva el guardado de las ediciones locales antes de encolar. Anula [`options.saveLocal`](/docs/cli/reference/config#save-local). | `boolean`  | Sí       | `false`          |
| `--tag [value]`                 | Etiqueta la ejecución; se obtiene automáticamente de Git cuando no se proporciona ningún valor.                                               | `string`   | Sí       | —                |
| `-m, --message <message>`       | Mensaje adjunto a la etiqueta de traducción.                                                                                                  | `string`   | Sí       | —                |

## Ejemplo [#example]

```bash
# Preparar traducciones para revisión humana
npx gt stage

# Preparar y etiquetar la ejecución para seguimiento en el panel de control
npx gt stage --tag v2.1.0 -m "Q3 release"

# Cuando las traducciones estén listas, descargarlas
npx gt download
```

## Otras notas [#notes]

* Usa `stage` cuando la revisión humana esté habilitada o al traducir formatos asíncronos como [Lottie](/docs/cli/reference/formats/lottie-files).
* Al preparar, se establece la clave de configuración [`stageTranslations`](/docs/cli/reference/config#stage). Consulta [Preparar traducciones para revisión](/docs/cli/guides/managing-translations#review).

## Sitemap

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