# 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 sintaxis y el formato personalizados de las cadenas —por ejemplo, los mensajes ICU— son compatibles con `next-intl` e `i18next`. Otras bibliotecas pueden traducir con menos precisión las cadenas con sintaxis personalizada.*

## 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.

## 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.