# gt: General Translation CLI tool: YAML
URL: https://generaltranslation.com/es/docs/cli/reference/formats/yaml-files.mdx
Docs index: https://generaltranslation.com/llms.txt
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.

## Sitemap

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