# gt: General Translation CLI tool: Preparar
URL: https://generaltranslation.com/es/docs/cli/stage.mdx
---
title: Preparar
description: Cómo preparar tus traducciones para su revisión
---

## Resumen

`gt stage` es un comando que genera traducciones para tu proyecto y las prepara para su revisión.

Este comando solo es útil si has habilitado la revisión humana en tu proyecto.

## Uso

<Callout type="error">
  Ejecuta esto en tu pipeline de CI **antes** de compilar tu aplicación para producción.
</Callout>

```bash
npx gt stage
```

<Callout type="info">
  **Nota:**
  Este comando requiere una API key de producción. Consigue una en la [plataforma](https://generaltranslation.com/dashboard).
</Callout>

El comando `gt stage` funciona igual que el comando `translate`, pero en lugar de descargar las traducciones completadas o publicarlas en la CDN, las prepara para revisión.

Después de ejecutar `gt stage`, debes ejecutar `gt translate` para completar el proceso y descargar las traducciones (si está configurado).

<Callout type="warn">
  **¡Solo para uso en producción!**

  Este comando está pensado para compilaciones de producción y **no debe usarse en desarrollo**.
  Antes de ejecutar este comando, asegúrate de estar en la rama que se usará para producción.
  Recuerda también especificar tu API key de producción (`GT_API_KEY`) y el ID del proyecto (`GT_PROJECT_ID`) en las variables de entorno.
</Callout>

***


## Opciones

| Parámetro                       | Descripción                                                                                                      | Tipo       | Opcional | Predeterminado                                                                                                                  |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------- | ---------- | -------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `--api-key`                     | Especifica una API key de producción                                                                             | `string`   | `true`   |                                                                                                                                 |
| `--project-id`                  | Especifica el ID del proyecto                                                                                    | `string`   | `true`   |                                                                                                                                 |
| `--version-id`                  | Especifica un ID de versión (de forma predeterminada, un hash del contenido)                                     | `string`   | `true`   |                                                                                                                                 |
| `--config <path>`               | Especifica la ruta al archivo de configuración de GT                                                             | `string`   | `true`   | `"gt.config.json"`                                                                                                              |
| `--tsconfig, --jsconfig <path>` | Especifica la ruta al archivo de configuración de TS o JS                                                        | `string`   | `true`   |                                                                                                                                 |
| `--src <paths>`                 | Lista de patrones glob separados por espacios para buscar archivos fuente. Debe ser relativa al directorio raíz. | `[string]` | `true`   | `[  'src/**/*.{js,jsx,ts,tsx}', 'app/**/*.{js,jsx,ts,tsx}', 'pages/**/*.{js,jsx,ts,tsx}', 'components/**/*.{js,jsx,ts,tsx}', ]` |
| `--dictionary <path>`           | Especifica la ruta al archivo de diccionario                                                                     | `string`   | `true`   |                                                                                                                                 |
| `--inline`                      | Incluye etiquetas `<T>` en línea además del diccionario                                                          | `boolean`  | `true`   | `true`                                                                                                                          |
| `--timeout`                     | Tiempo de espera de la solicitud de traducción, en segundos                                                      | `number`   | `true`   | `900`                                                                                                                           |
| `--new, --locales <locales>`    | Configuraciones regionales a las que traducir el proyecto                                                        | `[string]` | `true`   |                                                                                                                                 |
| `--default-locale <locale>`     | La configuración regional de origen del proyecto                                                                 | `string`   | `true`   | `en`                                                                                                                            |
| `--ignore-errors`               | Ignora los errores y fuerza la traducción del contenido válido                                                   | `opción`   | `true`   | `false`                                                                                                                         |
| `--tag [value]`                 | Etiqueta esta ejecución de traducción (se resuelve automáticamente desde git si no se proporciona ningún valor)  | `string`   | `true`   |                                                                                                                                 |
| `-m, --message <message>`       | Mensaje para adjuntar a la etiqueta de traducción                                                                | `string`   | `true`   |                                                                                                                                 |
| `--dry-run`                     | Ejecuta el comando en modo de prueba                                                                             | `opción`   | `true`   | `false`                                                                                                                         |

Todos estos parámetros son opcionales.

<Callout type="warn">
  No agregues tu API key al archivo `gt.config.json`.
  En su lugar, debes configurarla como una variable de entorno. La CLI leerá automáticamente `GT_API_KEY` si está configurada.
</Callout>

Hay algunos parámetros clave:

| Parámetro                    | Descripción                                                                                                                                           |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--dry-run`                  | Esta opción hace que la CLI analice y valide tu proyecto, pero no se comunique con la API de GT. Esto resulta útil para validar tu base de código.    |
| `--api-key`                  | A menos que uses `--dry-run`, debes proporcionar una API key de producción.                                                                           |
| `--project-id`               | Del mismo modo, a menos que uses `--dry-run`, debes proporcionar un ID del proyecto.                                                                  |
| `--new, --locales <locales>` | Configuraciones regionales a las que traducir el proyecto. Se añadirán a las configuraciones regionales especificadas en tu archivo `gt.config.json`. |

### Archivo de configuración

Al ejecutar `gt stage`, la CLI añadirá automáticamente la propiedad `stageTranslations : true` a tu archivo `gt.config.json`.

Esta propiedad garantiza que, si se ejecuta `translate` sin haber ejecutado antes `stage` para una versión de despliegue específica,
la herramienta de CLI mostrará un error y se cerrará.