YAML с локалью в корне
Переводите значения внутри одного корневого узла локали и меняйте его имя на целевую локаль.
Rails определяет локаль по корню YAML-файла. Даже файл с именем checkout.es.yml задаёт ресурсы на английском, если его корневой узел — en:. Обработчик yaml-root-key переводит сообщения внутри этого узла и меняет его имя на целевую локаль. При этом пути поиска остаются одинаковыми для всех языков.
Обёртка локали и пути сообщений #
Исходный каталог может содержать и интерполяцию, и ветви для форм множественного числа:
en:
checkout:
greeting: Hello, %{name}
items:
one: One item
other: "%{count} items"Пути сообщений — checkout.greeting, checkout.items.one и checkout.items.other. Они не включают en, поэтому сообщения в английском оригинале и испанском переводе можно сопоставить по одним и тем же идентификаторам. Целевая обёртка получает имя es, а checkout, one и other остаются ключами.
Синтаксис интерполяции и названия категорий множественного числа — часть контракта приложения. Перевод текста не настраивает правила множественного числа в Rails и не добавляет все категории, нужные целевому языку. Прежде чем принять ресурсы, проверьте в приложении, как отображаются сообщения с нужными количествами и переменными.
Парсер требует ровно одну корневую пару со скалярным ключом и вложенным отображением. Пустая локаль допустима, но скалярное сообщение или список непосредственно под корнем вызовут ошибку. Разделите YAML-файл с несколькими локалями на отдельные файлы для каждой локали или используйте универсальный YAML, если хотите сохранить все корневые узлы без изменений. Не выбирайте этот обработчик для спецификации OpenAPI.
Обновления и ограниченная область перевода #
Вложенные строковые значения сравниваются по путям внутри обёртки локали. Текущий оригинал задаёт структуру, а предыдущий оригинал и существующий перевод позволяют сохранить переводы неизменившихся значений. Комментарии и якоря проходят через сериализацию дерева YAML, которая может привести форматирование к единому виду.
Если задана область видимости ключей или ограничение по терминам, неизменившиеся переводы всё равно могут использоваться повторно при наличии предыдущего оригинала. Команда --key в CLI использует сохранённую базовую версию, и добавление --force не отключает повторное использование. Чтобы точечно исправить формулировку, отредактируйте перевод напрямую. Чтобы заново сгенерировать файл после изменения рекомендаций, сохраните принятые переводы и запустите --force для всего файла с ограничением области перевода, без --key. Затем проверьте каждое изменённое сообщение.
Если используется область видимости ключей, строковые значения в отображениях за её пределами могут быть пропущены, если перевод для них не определён. Элементы последовательностей сохраняют исходные значения, чтобы позиции не сдвигались. Успешный разбор не гарантирует полноту — проверяйте её отдельно, особенно если создаёте новую локаль с узкой областью перевода.
Настройте локаль и целевой путь #
Явно задайте format: "yaml-root-key" для исходных файлов .yml или .yaml. По расширению нельзя определить обёртку локали. Шаблоны файлов и структуру целевых путей вы найдёте в разделах Конфигурация CLI и GitHub.
Для восстановления файла нужна целевая локаль. Без неё процесс завершится ошибкой. Параметр localeFormat в CLI меняет написание пути, а не локаль внутри YAML. Проверьте целевой путь и корневой узел файла, затем загрузите через Rails приветствие и сообщение с формами множественного числа. В руководстве Как локализовать приложение Rails показано, как связать эти файлы с выбором локали запроса, вспомогательными методами и использованием резервной локали.