Как проверять локализацию React вместе с кодом
Используйте извлечение сообщений, проверки каталогов, TypeScript и сборку приложения, чтобы находить разные ошибки локализации до слияния.
Изменённое сообщение React доходит до читателей через исходный код, извлечение, каталог переводов и загрузчик приложения. Проверяйте всю эту цепочку, а не только формулировку. Даже правильный перевод не появится на экране, если его идентификатор устарел. Подстановка исходного текста может скрыть отсутствие перевода: экран при этом останется рабочим.
Этот метод подходит для текущего пакета React с каталогами JSONC, извлечёнными с помощью CLI. Дополняйте проверки извлечения в CLI проверками сборки и отображения, принятыми в проекте.
Сначала изучите изменения в исходном коде #
Прочитайте новое исходное сообщение как инструкцию или утверждение для пользователя. Затем изучите контекст. «Кнопка» описывает форму, а «Отменить запланированный платёж до отправки» объясняет действие, смысл которого нужно сохранить. И исходный текст, и контекст определяют идентификатор сообщения, поэтому даже правка одного лишь контекста может потребовать новой записи в каталоге переводов.
Проверяйте плейсхолдеры как значения с неизменным назначением. Переводчик должен иметь возможность переставить имя человека или сумму, не меняя идентификатор соответствующего плейсхолдера. В форматированном тексте оставляйте навигацию и поведение компонентов в коде, а предложение вокруг именованных тегов переводите. Точные API описаны в разделах Сообщения и Форматированный текст.
Сначала проверьте извлечение, затем переводы #
Установите CLI и выполните команду из нужного каталога проекта:
lingo extract --check
lingo checkИспользуйте те же параметры --src, --source-locale, --out и --types, что и в команде извлечения проекта. Исходная локаль по умолчанию — en. Настройки локализации не меняют это значение для команды. Затем запустите проверку TypeScript и сборку для рабочей среды, принятые в репозитории. Они должны охватывать и сгенерированные объявления типов.
| Ошибка, которую нужно внести в локальный тестовый пример | Проверка и ожидаемый результат |
|---|---|
| Измените исходное сообщение, не создавая заново каталоги и объявления типов. | extract --check сравнивает сгенерированные результаты и завершается с ошибкой, если они устарели. |
| Не указывайте обязательный контекст в извлекаемом сообщении. | check сообщает о проблеме с извлечением или контекстом. Изучите исходный код, чтобы восстановить смысл. |
| Оставьте запись пустой или не добавляйте её в существующий каталог переводов JSONC. | check сообщает об отсутствующем переводе в найденном каталоге. |
| Не обновляйте сгенерированные объявления типов. | Извлечение или проверка выявляет расхождение в сгенерированных файлах. TypeScript отдельно проверяет их использование в приложении. |
| Нарушьте импорт локали или интеграцию с фреймворком. | Обычная сборка приложения должна выявить сбой интеграции. |
При первой настройке этих проверок используйте локальный тестовый пример. extract --check завершается успешно, даже если исходные файлы не найдены. Поэтому убедитесь, что каталог, указанный в отчёте, содержит нужный код. Иначе успешный результат может означать, что проверять было нечего.
Отдельно проверьте наличие обязательных локалей #
Если шаблоны files в .lingo/config.json соответствуют исходному каталогу (например, locales/en.jsonc), lingo check также требует файл для каждой настроенной целевой локали. Шаблон locales/en.json, который записывает lingo init --yes, не соответствует каталогу .jsonc, поэтому с ним выполняются только проверки React. Проверка сообщает об отсутствующем ключе только в существующих каталогах переводов JSONC. При проверке сопоставьте список обязательных локалей с файлами и импортами. Временно удалите запись перевода в локальном тестовом примере, чтобы увидеть, как на экране выглядит подстановка исходного текста.
Проверьте смысл на характерных парах исходного текста и перевода. Особое внимание уделите изменившимся обещаниям пользователю и терминам продукта. Успешная проверка согласованности JSONC ничего не говорит о смысле. Для ARB, Android XML, каталогов Apple и статических документов нужны соответствующие им средства проверки, а не эта проверка охвата локалей для React.
Разберите изменения, не потеряв проверенные переводы #
Заново создайте устаревшие файлы с помощью lingo extract, изучите добавленные записи и записи без исходного сообщения, затем переведите нужные изменения. Сохраните проверенные формулировки переводов и файл блокировки локализации. Удаление записей без исходного сообщения меняет каталоги, поэтому проверяйте его отдельно от правок исходного сообщения.
Решите, будут ли переводы поступать в ветку с исходными изменениями или через отдельный PR с переводами. В руководстве по CI описаны плюсы и минусы этих способов доставки и отличия управляемого приложения. В обоих случаях отделяйте право на слияние от права на запуск и одобрения содержимого.
В завершение откройте изменённый экран в целевой локали с характерными значениями. Перейдите по ссылкам в форматированном тексте, проверьте подстановку исходного текста и сопоставьте сообщение на экране с действием, которое оно должно описывать. Проверку можно считать завершённой, когда изучены и путь сообщения в программе, и его формулировка.