При переводе интерфейса с ИИ сохраняйте имена переменных, типы аргументов и значения условий, а формы чисел адаптируйте к целевому языку. Для сообщений ICU MessageFormat одного корректного JSON недостаточно: нужно разобрать внутреннюю строку, проверить аргументы и вывести сообщение с разными входными значениями. Особенно показателен русский вариант: «1 товар», «2 товара», «5 товаров», «21 товар».
FAQ предназначен для разработчика бизнес-приложения и редактора локализации, которые переводят сообщения с английского на русский. Здесь рассматриваем классический синтаксис ICU MessageFormat, используемый FormatJS. У шаблонов i18next, printf и MessageFormat 2 другой контракт; переносить примеры в них без адаптации нельзя.
Материал подготовила AI студия Владимира Ломтева. Документация проверена 18 ноября 2026 года. Вымышленные примеры ниже действительно разобраны и отформатированы локально: Node.js 22.23.5, intl-messageformat 12.2.0, ICU 78.3. Сам перевод моделью и работу интерфейса в браузере редакция не проверяла. В конце есть раздел об услугах издателя; партнёрских ссылок нет.
Содержание
- Что передать ИИ, кроме самой строки?
- Можно ли переводить имена переменных и ключи JSON?
- Почему английских one и other недостаточно для русского?
- Чем one отличается от =1 и зачем нужна =0?
- Нужно ли переводить shipped и cancelled внутри select?
- Почему после перевода пропали скобки или не подставляется аргумент?
- Что написать в промпте и гарантирует ли JSON Schema сохранность ICU?
- Как убедиться, что перевод работает, и что здесь уже проверено?
Что передать ИИ, кроме самой строки?
Передайте сообщение целиком, его идентификатор, место использования, исходный и целевой языки, а также описание аргументов. Например: cart.items — подпись количества товаров в корзине; count — неотрицательное целое число единиц. Для order.status опишите допустимые статусы и формат номера заказа. Тогда модель получает контекст для перевода «заказ» и «товар», а разработчик — явные ограничения для проверки результата.
ICU MessageFormat — формат сообщения, в котором текст соседствует с аргументами в фигурных скобках. Простой аргумент {orderId} подставляет значение; plural выбирает вариант по числу и языку, select — по значению условия. ICU рекомендует передавать переводчику целое сообщение: разрозненные куски затрудняют перестановку слов и согласование. Документация ICU о сообщениях.
Предлагаемая карточка входа для одного сообщения:
| Поле | Пример | Для чего нужно |
|---|---|---|
| Идентификатор | cart.items |
Вернуть перевод в нужное место каталога |
| Контекст | Подпись возле значка корзины | Выбрать короткую формулировку |
| Переменная | count: целое число, от нуля |
Выбрать допустимые формы и тестовые значения |
| Исходный язык | en |
Понять исходную грамматику |
| Целевой язык | ru-RU |
Настроить форматтер и русские формы |
| Ограничение | Не менять ID и имя count |
Сохранить связь с кодом |
Это предлагаемый шаблон входа для команды. Не подставляйте в него реальные персональные данные ради контекста: для имён и номеров обычно достаточно вымышленных значений. Если задача касается терминов компании, их можно подготовить отдельно по FAQ о глоссарии DeepL. Глоссарий помогает с лексикой; контракт ICU всё равно проверяется отдельно.
Можно ли переводить имена переменных и ключи JSON?
Имена переменных сохраняйте. Если код передаёт orderId, а перевод стал ожидать {номерЗаказа}, подстановка не найдёт нужный аргумент. Значения вроде вымышленного номера B-104 поступают при выполнении; переводчик меняет окружающую фразу.
В примерах ниже cart.items и order.status — идентификаторы сообщений во внешнем каталоге JSON. Сама библиотека форматирования получает строку, а выбор строки по ID обеспечивает приложение. Поэтому сохранение ключей каталога — правило интеграции: локализатор не должен самовольно переименовывать их.
Порядок аргументов в предложении менять можно, если этого требует русский язык. Но совпадение набора имён ещё не подтверждает правильность: аргумент может оказаться в другой ветви или потерять формат числа. FormatJS требует передать значения для аргументов, используемых при форматировании. Контракт intl-messageformat.
Для проверки сопоставляйте три вещи: ключи исходного и целевого каталогов, имена и роли аргументов внутри каждого сообщения, а затем фактическую подстановку на примерах. Поиск одинаковых фрагментов регулярным выражением не даёт полного разбора вложенного ICU-сообщения.
Почему английских one и other недостаточно для русского?
В русском выбор формы для количественных числительных зависит от категории one, few, many или other. Например, 1 и 21 относятся к one, 2 и 22 — к few, 5 и 11 — к many; дробное 1,5 относится к other. Это категории языка, а не команды «один» и «всё остальное». Русские правила CLDR.
Поэтому правило «переведи текст, структуру вообще не меняй» для plural слишком жёсткое. В русский перевод может понадобиться добавить категории, которых нет в английском. Для вымышленной корзины исходное сообщение такое:
{count, plural, =0 {Your cart is empty} one {# item in your cart} other {# items in your cart}}
Локализованный каталог содержит:
{
"cart.items": "{count, plural, =0 {Корзина пуста} one {В корзине # товар} few {В корзине # товара} many {В корзине # товаров} other {В корзине # товара}}",
"order.status": "{status, select, shipped {Заказ {orderId} отправлен} cancelled {Заказ {orderId} отменён} other {Заказ {orderId} обрабатывается}}"
}
Символ # внутри plural выводит число с локальным форматированием. В FormatJS ветвь other обязательна. Добавление категорий целевого языка отличается от изменения имён аргументов или бизнес-условий. Синтаксис plural в FormatJS.
У счётчика товаров обычно нет дробных значений. В примере ветвь для дробей оставлена, чтобы показать работу other; разрешённый тип данных нужно определить в приложении. Если продаёте весовой товар, словоформы следует согласовать уже с единицей измерения: килограммы и позиции заказа описывают разные величины.
Чем one отличается от =1 и зачем нужна =0?
=1 проверяет точное число 1. Категория one определяется правилами языка и для русского срабатывает также на 21. Подмена one на =1 оставит другие числа этой категории без нужного текста. Точная ветвь =0 полезна для отдельной фразы «Корзина пуста» и выбирается до категориального варианта. Синтаксис точного совпадения описан в разделе plural документации FormatJS.
Вот часть фактического вывода локальной проверки приведённого сообщения при локали ru-RU:
| Значение count | Категория числа | Результат сообщения |
|---|---|---|
| 0 | many, но выбрана =0 |
Корзина пуста |
| 1 | one |
В корзине 1 товар |
| 2 | few |
В корзине 2 товара |
| 5 | many |
В корзине 5 товаров |
| 11 | many |
В корзине 11 товаров |
| 21 | one |
В корзине 21 товар |
| 22 | few |
В корзине 22 товара |
| 25 | many |
В корзине 25 товаров |
| 1.5 | other |
В корзине 1,5 товара |
Это проверка вымышленной строки, а не показатель качества ИИ-перевода. Для проверки категории использовался Intl.PluralRules, для вывода — intl-messageformat. В среде запуска были данные CLDR 48.0; актуальная таблица CLDR 50 подтверждает перечисленные русские категории.
Если в исходнике есть offset, не удаляйте его при переводе. Он меняет расчёт категории и значение #; точные варианты =n проверяют исходное число. Такой шаблон требует своих входов, включая границы смещения. Простые результаты таблицы относятся к сообщению без offset. Описание сложных аргументов ICU.
Нужно ли переводить shipped и cancelled внутри select?
Нет, если это значения, которые передаёт приложение. Переводятся сообщения внутри ветвей, а shipped, cancelled и имя аргумента status сохраняются. Ветка other принимает значения, для которых нет отдельного варианта; в FormatJS она обязательна. Правила select.
У приведённого выше order.status локальный запуск дал такие результаты при orderId = B-104:
shipped→ «Заказ B-104 отправлен»;cancelled→ «Заказ B-104 отменён»;unknown→ «Заказ B-104 обрабатывается».
Для реального приложения смысл other должен определить владелец процесса. Если неизвестный статус означает ошибку интеграции, фраза «обрабатывается» может вводить клиента в заблуждение. Тогда нужен согласованный запасной текст и отдельная обработка неизвестного значения. Выбор фразы в примере не задаёт правила работы вашего заказа.
Если внутри select вложен plural, проверяйте комбинации условий и чисел. Успешный вывод ветки «отправлен» не подтверждает корректность ветки «отменён». Нельзя механически требовать полного совпадения всех ветвей исходника и перевода: категории plural адаптируются к языку, а значения бизнес-select должны оставаться согласованными с кодом.
Почему после перевода пропали скобки или не подставляется аргумент?
Сначала проверьте, не превратился ли аргумент в буквальный текст из-за экранирования. В классическом ICU синтаксические символы можно заключить в ASCII-апострофы. Например, строка Введите '{name}' в проверенной среде вывела Введите {name} без подстановки. Это уместно для подсказки о синтаксисе, но ошибочно, если интерфейс должен показать имя пользователя.
Различайте обычный типографский апостроф ’ и синтаксический '. Их автоматическая замена при редактуре может изменить поведение шаблона. Специальное значение имеет и # внутри plural; буквальный знак решётки требует учёта контекста. Экранирование в ICU.
Внешнее JSON-экранирование — отдельный слой. Сначала файл должен корректно читаться как JSON, затем извлечённая строка — как ICU-сообщение. Набор сбалансированных фигурных скобок сам по себе не подтверждает ни один из этих контрактов. При поиске ошибки сохраняйте исходный текст и смотрите, на каком именно слое возникло исключение.
Если исходный материал — обычная HTML-страница, используйте другой маршрут: перевод HTML с сохранением разметки. HTML-теги и ICU-аргументы требуют разных правил обработки; режим перевода тегов не доказывает сохранность plural.
Что написать в промпте и гарантирует ли JSON Schema сохранность ICU?
В промпте перечислите разрешённые изменения и контракт возвращаемого файла. JSON Schema может ограничить внешнюю структуру ответа, однако строка с неверным ICU-синтаксисом всё ещё остаётся строкой. Для её проверки нужен отдельный разбор сообщения. FormatJS предоставляет парсер, который строит AST — дерево структуры аргументов и текста. Документация парсера ICU.
Предлагаемый промпт для редакторского процесса:
Переведи каталог сообщений с en на ru-RU.
Формат строк: классический ICU MessageFormat, реализация FormatJS.
Сохрани идентификаторы сообщений, имена и типы аргументов,
точные ветви =n, значения select и offset, если он есть.
Категории plural адаптируй к русскому языку; сохрани other.
Переводи полные сообщения внутри ветвей и учитывай контекст.
Не добавляй новые аргументы и бизнес-статусы.
Верни JSON-объект с теми же ключами, без пояснений.
Если контекста недостаточно, не угадывай: вынеси вопрос отдельно
на этапе подготовки, до запроса финального JSON.
Промпт предложен редакцией и не проверялся на модели. Перед запросом добавьте карточки контекста и собственно каталог; отдельно согласуйте вопросы, затем просите финальный JSON. Даже точное выполнение этих инструкций не подтверждает, что текст соответствует действию кнопки, юридическому смыслу уведомления или ширине элемента.
При автоматизации сравнивайте структуру разобранных сообщений: обязательные аргументы, их типы, точные числовые условия, offset и бизнес-ветви. Для plural допускайте согласованное расширение под целевую локаль. Простое побайтовое равенство деревьев отвергнет допустимый русский перевод; сравнение только числа скобок пропустит смысловую ошибку.
Как убедиться, что перевод работает, и что здесь уже проверено?
Проверьте файл, сообщения и их вывод последовательно. Файл должен читаться как JSON и сохранять ожидаемые идентификаторы. Каждая строка должна разбираться целевым ICU-парсером. Затем выведите её с реальными типами аргументов, выбранной локалью и входами, покрывающими ветви. По документации intl-messageformat строка разбирается при создании экземпляра, а значения передаются в format. Порядок форматирования.
В локальной проверке редакция разобрала четыре строки — по два сообщения на английском и русском. Для русского сообщения корзины выполнены девять входов из таблицы; для статуса — три входа, включая неизвестное значение. Проверены буквальные скобки с апострофами. Отдельно подтверждено, что парсер отвергает plural без other, а форматирование выбранной ветви с отсутствующим orderId завершается ошибкой. Все эти проверки прошли в одной сессии 18 ноября 2026 года.
Предлагаемая проверка в продукте шире локального запуска: покажите перевод в целевом экране, проверьте переносы, обрезание, доступные подписи и связь сообщения с действием. Человек должен прочитать все значимые ветви. Парсер не оценит тональность и не заметит, что строка об отмене попала в экран успешной оплаты.
Результат готов к следующему этапу, когда каталог читается, аргументы и условия согласованы, контрольные значения дают ожидаемые фразы, а экран прошёл проверку в приложении. Последний пункт здесь не выполнен: примеры не подключались к продукту, LLM не вызывалась, скорость и качество автоматического перевода не измерялись.
Как студия помогает связать перевод с приложением
AI студия Владимира Ломтева занимается подготовкой данных, интеграциями и тестированием автоматизированных процессов. В задаче локализации это может включать выделение переводимых сообщений из экспорта, интеграцию этапа ИИ-перевода с возвратом результата в черновой каталог и тестирование сообщений перед загрузкой в приложение. Конкретную библиотеку и способ проверки определяют по устройству проекта.
Первый шаг — выбрать один экран, собрать его текущий каталог и примеры входных данных, описать ограничения и критерий корректного вывода. Обсудить задачу.
Итог: сохраняйте контракт, адаптируйте грамматику
Для перевода интерфейса с ИИ разделите неизменяемые имена и условия от языковых форм. В ICU MessageFormat переменные и бизнес-значения select связаны с кодом, а plural должен учитывать грамматику русского языка. Возьмите одну строку с числом, проверьте её на 0, 1, 2, 5, 11 и 21, затем разберите остальные ветви и покажите результат в целевом экране.






