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

title: JSON
description: Traduci file JSON con la CLI di General Translation. API Reference per il formato di file JSON.

---

La CLI traduce i file JSON indipendentemente dalla libreria i18n che utilizzi. Le traduzioni preservano 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 `json` in `files` con un array `include` di pattern glob. Usa il segnaposto `[locale]` in modo che la CLI possa trovare i file sorgente e salvare le traduzioni nel percorso corretto.

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

Con questa configurazione, la CLI traduce tutti i file JSON in `i18n/en/`, salva i risultati in `i18n/zh/`, `i18n/es/` e `i18n/ja/` e ignora i file in `i18n/en/exclude/`. Consulta il [riferimento della configurazione](/docs/cli/reference/config#files) per tutte le chiavi dei file.

## Metadati per chiave [#metadata]

Aggiungi istruzioni di traduzione per singola chiave con un file `.metadata.json` associato che rispecchia la struttura sorgente. Usalo per aggiungere contesto, limiti di caratteri o contesto del codice sorgente per chiavi specifiche senza modificare la sorgente.

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