YAML

Переводите строковые значения во вложенных структурах YAML, не меняя ключи каталога. Если корень или схема имеют особое значение, выберите другой обработчик.

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

Подойдёт ли обычный обработчик YAML #

Например, в этом каталоге сообщения об оформлении заказа сгруппированы без обёртки с локалью:

yaml
checkout:
  title: Complete your order
  steps:
    - Review your items
    - Confirm delivery
  retries: 3

Обработчик выбирает checkout.title и обе строки последовательности. retries остаётся числом. Идентификатор в кавычках тоже попадёт в выборку, потому что это строка. Учитывайте это различие, когда решаете, какие данные включить в каталог.

Используйте YAML с локалью в корне для обёртки en: в стиле Rails, которую нужно заменить целевой локалью. Обычный обработчик YAML сохраняет en:, даже если имя файла меняется на es.yml. Из-за этого Rails может проигнорировать содержимое: корневой ключ по-прежнему указывает на английский язык.

Для спецификации API используйте OpenAPI. Обычный обработчик YAML выберет в том числе строковые идентификаторы операций, ссылки и примеры. Само расширение .yml не позволяет определить, как нужно обрабатывать файл.

Повторное использование переводов и восстановление структуры #

Текущий исходный файл задаёт дерево результата. Предыдущая версия позволяет определить, изменилась ли строка по каждому пути, а существующий целевой файл даёт значения для совпадающих путей. Новые переводы заменяют изменённые строки. Неизменённые строки могут сохранить прежний перевод, даже если попали в выборку по ключам или терминам.

CLI передаёт сохранённую базовую версию для --key, поэтому такая выборка не гарантирует повторный перевод неизменённых строк YAML. Добавление --force в ту же команду ничего не меняет. Для точечного исправления отредактируйте целевой файл напрямую. Для повторной генерации сохраните принятые целевые файлы и запустите --force для всего файла с ограничением области обработки, но без --key. После замены проверьте весь файл.

При восстановлении структуры используется синтаксическое дерево YAML: оно позволяет заменять значения, сохраняя комментарии и структуру якорей. Сериализация может привести форматирование к единому виду. Комментарии остаются частью документа, а не инструкциями для перевода. Проверьте псевдонимы в программе, которая читает ваш YAML, особенно если одно значение используется по нескольким ссылкам.

При запуске с ограничением по ключам строка в отображении за пределами выбранной области может исчезнуть, если её значение не удалось определить и в целевом файле нет перевода. Строки последовательностей сохраняют исходное значение, чтобы позиции не сдвигались. Поэтому обработка с частичным охватом не гарантирует, что все строки в файле переведены.

Как настроить и загрузить каталог #

Явно задайте format: "yaml" для исходных файлов .yaml или .yml в конфигурации CLI. При поиске файлов для отправки YAML-файлы без явно указанного формата исключаются. У GitHub App свой механизм выбора файлов в репозитории.

Настройте целевой путь с учётом загрузчика приложения. Для исходного файла вроде config/locales/checkout.en.yml и файла по пути locales/en/checkout.yml путь нужно формировать по-разному. Позиции в последовательности тоже определяют сообщения: если переместить элемент, ему может соответствовать уже другой существующий перевод. После изменений структуры проверьте загруженный каталог. Для поиска сообщений в Rails, выбора локали и подстановки резервных значений используйте руководство Как локализовать приложение Rails и обработчик YAML с локалью в корне.