# gt: General Translation CLI tool: JSON
URL: https://generaltranslation.com/ru/docs/cli/reference/formats/json-files.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Переводите JSON-файлы с помощью CLI General Translation. Справочник API по формату JSON-файлов.

CLI переводит JSON-файлы независимо от того, какую библиотеку i18n вы используете. При переводе сохраняется синтаксис исходной строки.

*Примечание: CLI считывает `package.json`, чтобы определить, как обрабатывать строки JSON. `next-intl` использует сообщения ICU, как и `i18next`, если установлен `i18next-icu`. Без него `i18next` сохраняет синтаксис i18next, например интерполяцию `{{name}}`. Строки для других библиотек переводятся как обычные строки, поэтому пользовательский синтаксис может переводиться менее точно.*

## Конфигурация [#config]

Добавьте в `files` запись `json` с массивом `include`, содержащим glob-шаблоны. Используйте плейсхолдер `[locale]`, чтобы CLI мог находить исходные файлы и сохранять переводы по нужному пути.

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

С этой конфигурацией CLI переводит каждый JSON-файл в каталоге `i18n/en/`, сохраняет результаты в `i18n/zh/`, `i18n/es/` и `i18n/ja/`, а файлы из `i18n/en/exclude/` пропускает. Все файловые ключи см. в [справочнике по конфигурации](/docs/cli/reference/config#files).

## Порядок вывода [#order]

CLI не сортирует ключи в переведённых JSON-файлах. Файлы перевода GTJSON, настроенные через [`files.gt`](/docs/cli/reference/config#files), по-прежнему сортируются по ключу — так различия между версиями остаются стабильными.

<Callout type="info">
  **Изменено в v2.26.0:** переведённые JSON-файлы больше не сортируются по алфавиту. Вывод в формате GTJSON по-прежнему сортируется.
</Callout>

## Метаданные по ключам [#metadata]

Добавляйте инструкции по переводу для отдельных ключей с помощью сопутствующего файла `.metadata.json`, который повторяет структуру исходного файла. Используйте его, чтобы добавлять контекст, ограничения по числу символов или контекст исходного кода для конкретных ключей, не изменяя исходный текст.

```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
    }
  }
}
```

См. [справочник по метаданным для ключей](/docs/cli/reference/keyed-metadata), где перечислены все поддерживаемые поля.

## Sitemap

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