# gt: General Translation CLI tool: JSON
URL: https://generaltranslation.com/es/docs/cli/reference/formats/json-files.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Traduce archivos JSON con la CLI de General Translation. Referencia de la API del formato de archivo JSON.

La CLI traduce archivos JSON independientemente de la biblioteca de i18n que uses. Las traducciones conservan la sintaxis original de las cadenas.

*Nota: La CLI lee `package.json` para determinar cómo se procesan las cadenas JSON. `next-intl` usa mensajes ICU, al igual que `i18next` cuando está instalado `i18next-icu`. `i18next` por sí solo conserva su propia sintaxis, como la interpolación `{{name}}`. Con otras bibliotecas, las cadenas se traducen como cadenas simples, por lo que la sintaxis personalizada puede traducirse con menos precisión.*

## Configuración [#config]

Agrega una entrada `json` en `files` con un array `include` de patrones glob. Usa el marcador de posición `[locale]` para que la CLI pueda encontrar los archivos fuente y guardar las traducciones en la ruta correcta.

```json title="gt.config.json"
{
  "defaultLocale": "en",
  "locales": ["zh", "es", "ja"],
  "files": {
    "json": {
      "include": ["i18n/[locale]/*.json"],
      "exclude": ["i18n/[locale]/exclude/**/*.json"]
    }
  }
}
```

Con esta configuración, la CLI traduce todos los archivos JSON dentro de `i18n/en/`, guarda los resultados en `i18n/zh/`, `i18n/es/` y `i18n/ja/`, y omite los archivos dentro de `i18n/en/exclude/`. Consulta la [referencia de configuración](/docs/cli/reference/config#files) para ver todas las claves de archivo.

## Orden de salida [#order]

La CLI no ordena las claves en los archivos JSON traducidos. Los archivos de traducción GTJSON configurados con [`files.gt`](/docs/cli/reference/config#files) siguen ordenados por clave para que las diferencias sean estables.

<Callout type="info">
  **Cambio en v2.26.0:** Los archivos JSON traducidos ya no se ordenan alfabéticamente. La salida GTJSON sigue estando ordenada.
</Callout>

## Metadatos por clave [#metadata]

Adjunta instrucciones de traducción por clave con un archivo complementario `.metadata.json` que replique la estructura de tu fuente de origen. Úsalo para añadir contexto, límites de caracteres o contexto del código fuente para claves específicas sin cambiar la fuente.

```json title="translations.metadata.json"
{
  "nav": {
    "bank": {
      "context": "Riverbank — the side of a river. NOT a financial institution."
    },
    "save": {
      "context": "Sports term — a goalkeeper preventing a goal. NOT saving data.",
      "maxChars": 12
    }
  }
}
```

Consulta la [referencia de metadatos por clave](/docs/cli/reference/keyed-metadata) para ver todos los campos admitidos.

## Sitemap

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