Практика системного анализа · 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?
Они проверяют, что правило не сведено к последней цифре без учёта исключений.
Ноль обязательно требует отдельной фразы?
Нет. Здесь так решил владелец сценария.
Что сравнивать после перевода?
Набор переменных, смысл действия и итоговые строки на выбранных входах.
Проверялась ли работа реальной библиотеки?
Нет. Таблица задаёт ожидания для будущей проверки интерфейса.
Автор: Иннокентий Бодров, автор Аналитической мастерской.