← Назад к блогу

Практика системного анализа · 4 минуты

Один ключ, разные формы: как проверить перевод с переменными

Как проверить перевод с переменными: сверить подстановку, формы для 0, 1, 2, 5, 11 и 21, отдельно определить пустое состояние и запасную локаль.

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

Сообщение о результатах поиска

В вымышленном интерфейсе текст зависит от числа найденных документов. Для учебного набора команда выбрала русскую локаль и четыре ожидаемых вывода. Каталог переводов и строки ниже не относятся к рабочему продукту.

Вход countОжидаемый текстЧто проверяем
0Документы не найденыОтдельное сообщение пустого состояния
1Найден 1 документФорма для одного
2Найдено 2 документаФорма для двух
5Найдено 5 документовФорма для пяти

Ввод нуля в этом интерфейсе выбирает другую фразу. Это решение продукта, а не общее правило русского языка или свойство любой библиотеки переводов. Если разработчик использует одну заготовку «Найдено {count} документ», переменная сохранится, но текст в таблице не совпадёт.

Что проверять помимо чисел

Перед переводом зафиксируйте список переменных и их смысл. Например, заголовок «Документы для {project}» должен содержать название проекта, а не название организации. Замена имени переменной на красивый русский текст внутри фигурных скобок может оставить на экране буквальный шаблон. Проверьте готовый вывод с синтетическим названием, в том числе с пробелом.

Четыре входа дают основу, но не доказывают охват всех форм. Добавьте 11 и 21: учебные ожидания «Найдено 11 документов» и «Найден 21 документ» различаются. Согласуйте и поведение при отсутствующем переводе. Если продукт показывает запасную локаль, проверяйте её отдельно; нельзя выдавать её появление за готовность русской версии.

LLM может предложить варианты фраз и отметить исчезнувшие переменные. Применение шаблонов нужно сверить независимо по контрольным входам. Артефакт приёмки — ключ сообщения, допустимые переменные, локаль, входы и ожидаемые строки.

Сравните подход с примерами контракта API по тому же принципу «вход и ожидаемый выход». Способ фиксировать решения описан в Decision Log.

Вопросы по переводу

Достаточно ли вычитать текст в каталоге?

Нет. Часть ошибок становится видна после выбора формы и подстановки значений.

Зачем тестировать 11 и 21?

Они проверяют, что правило не сведено к последней цифре без учёта исключений.

Ноль обязательно требует отдельной фразы?

Нет. Здесь так решил владелец сценария.

Что сравнивать после перевода?

Набор переменных, смысл действия и итоговые строки на выбранных входах.

Проверялась ли работа реальной библиотеки?

Нет. Таблица задаёт ожидания для будущей проверки интерфейса.

Автор: Иннокентий Бодров, автор Аналитической мастерской.