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

title: YAML
description: Traduci i file YAML con la CLI di General Translation. Riferimento API per il formato di file YAML.

---

La CLI traduce i file YAML indipendentemente dalla libreria i18n utilizzata. Sono supportate sia le estensioni `.yaml` che `.yml` e le traduzioni mantengono la sintassi originale delle stringhe.

*Nota: La sintassi e la formattazione personalizzate delle stringhe — ad esempio i messaggi ICU — sono supportate per `next-intl` e `i18next`. Con altre librerie, la traduzione delle stringhe con sintassi personalizzata potrebbe essere meno accurata.*

## Configurazione [#config]

Aggiungi una voce `yaml` in `files`, con un array `include` di pattern glob. Usa il segnaposto `[locale]` così la CLI può trovare i file sorgente e salvare le traduzioni nel percorso corretto.

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

Consulta il [riferimento della configurazione](/docs/cli/reference/config#files) per tutte le chiavi del file.

## Metadati per chiave [#metadata]

Allega istruzioni di traduzione per ogni chiave con un file associato `.metadata.yaml` che rispecchia la struttura del sorgente.

```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 il [riferimento per i metadati per chiave](/docs/cli/reference/keyed-metadata) per tutti i campi supportati.