# gt: General Translation CLI tool: Texto
URL: https://generaltranslation.com/es/docs/cli/formats/txt.mdx
---
title: Texto
description: Cómo usar General Translation para configurar la traducción automática de los archivos de texto de tu proyecto
---

## Descripción general

`gt` puede usarse para traducir automáticamente cualquier archivo de texto.

Seguiremos estos 4 pasos:

<Steps>
  <Step>
    Agrega tus variables de entorno
  </Step>

  <Step>Instala [`gt`](/docs/cli)</Step>

  <Step>
    Configura el archivo [`gt.config.json`](/docs/cli/reference/config) de tu proyecto
  </Step>

  <Step>Ejecuta [`gt translate`](/docs/cli/translate#translate)</Step>
</Steps>

***

## Paso 1: Agrega tus variables de entorno

Agrega la clave de API de producción y el ID del proyecto a tus variables de entorno.
Esto es necesario para usar la herramienta `gt`.
Puedes obtenerlos en el dashboard de [General Translation](https://generaltranslation.com/dashboard).

```bash title=".env"
GT_API_KEY=<your-api-key>
GT_PROJECT_ID=<your-project-id>
```


## Paso 2: Instala `gt`

Instala la herramienta `gt` en tu proyecto.

<Tabs items={['npm', 'yarn', 'bun', 'pnpm']}>
  <Tab value="npm">
    ```bash
    npm i gt
    ```
  </Tab>

  <Tab value="yarn">
    ```bash
    yarn add --dev gt
    ```
  </Tab>

  <Tab value="bun">
    ```bash
    bun add --dev gt
    ```
  </Tab>

  <Tab value="pnpm">
    ```bash
    pnpm add --save-dev gt
    ```
  </Tab>
</Tabs>

## Paso 3: Configura el archivo `gt.config.json` de tu proyecto

Crea un archivo `gt.config.json` en la raíz de tu proyecto con el siguiente contenido:

```json title="gt.config.json"
{
  "defaultLocale": "en",
  "locales": ["es", "fr"],
  "files": {
    "txt": {
      "include": ["docs/[locale]/**/*.txt"]
    }
  }
}
```

Cambia `defaultLocale` y `locales` para que coincidan con las configuraciones regionales de tu proyecto.

La matriz de cadenas de la clave `include` debe ser un patrón glob que coincida con todos tus archivos de texto.

Debe usar el marcador de posición `[locale]` para coincidir con la configuración regional del archivo.

Consulta la documentación de [configuración](/docs/cli/reference/config) para obtener más información sobre el archivo `gt.config.json`.

## Paso 4: Agrega el comando `gt translate` a tu proceso de compilación

Agrega el comando `gt translate` a tu proceso de compilación o CI antes del comando de compilación para agregar automáticamente las traducciones a tu proyecto.

```json title="package.json"
{
  "scripts": {
    "translate": "npx gt translate",
    "build": "npm run translate && <your build command>"
  }
}
```

Esto generará traducciones para todas tus configuraciones regionales y las guardará en tu proyecto.
Si quieres hacer commit de estos archivos en tu repositorio, puedes ejecutar este comando antes de hacer commit.

¡Listo! Ahora tus archivos de texto se traducirán automáticamente cada vez que cambien tus archivos fuente.

***


## Notas

* Puedes añadir traducciones a tu proyecto automáticamente con el comando [`gt translate`](/docs/cli/translate).
* Si quieres hacer commit de tus archivos de traducción, debes ejecutar el comando `gt translate` antes.
* Para configurar la ruta de salida de tus traducciones, consulta la documentación de [configuración](/docs/cli/reference/config).

## Próximos pasos

* Consulta el [comando traducir](/docs/cli/translate) para obtener más detalles sobre el uso de la CLI.