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

title: YAML
description: Переводите YAML-файлы с помощью CLI General Translation. Справочник по API для формата YAML-файлов.

---

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

*Примечание: Пользовательский синтаксис строк и форматирование — например, сообщения ICU — поддерживаются для `next-intl` и `i18next`. Для других библиотек точность перевода строк с пользовательским синтаксисом может быть ниже.*

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

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

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

См. [справочник по конфигурации](/docs/cli/reference/config#files), где приведён полный список ключей файлов.

## Метаданные для ключей [#metadata]

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

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

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