# gt: General Translation CLI tool: YAML
URL: https://generaltranslation.com/es/docs/cli/reference/formats/yaml-files.mdx
---

title: YAML
description: Traduce archivos YAML con la CLI de General Translation. Referencia de la API para el formato de archivo YAML.

---

La CLI traduce archivos YAML independientemente de la biblioteca de i18n que uses. Se admiten las extensiones `.yaml` y `.yml`, y 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 menor precisión las cadenas con sintaxis personalizada.*

## Configuración [#config]

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

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

Consulta la [referencia de configuración](/docs/cli/reference/config#files) para conocer todas las claves de archivo.

## Metadatos por clave [#metadata]

Adjunta instrucciones de traducción para cada clave con un archivo `.metadata.yaml` complementario que replique la estructura de tu fuente.

```yaml title="translations.metadata.yaml"
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 conocer todos los campos admitidos.