Как проверять локализацию React вместе с кодом

Используйте извлечение сообщений, проверки каталогов, TypeScript и сборку приложения, чтобы находить разные ошибки локализации до слияния.

Изменённое сообщение React доходит до читателей через исходный код, извлечение, каталог переводов и загрузчик приложения. Проверяйте всю эту цепочку, а не только формулировку. Даже правильный перевод не появится на экране, если его идентификатор устарел. Подстановка исходного текста может скрыть отсутствие перевода: экран при этом останется рабочим.

Этот метод подходит для текущего пакета React с каталогами JSONC, извлечёнными с помощью CLI. Дополняйте проверки извлечения в CLI проверками сборки и отображения, принятыми в проекте.

Сначала изучите изменения в исходном коде #

Прочитайте новое исходное сообщение как инструкцию или утверждение для пользователя. Затем изучите контекст. «Кнопка» описывает форму, а «Отменить запланированный платёж до отправки» объясняет действие, смысл которого нужно сохранить. И исходный текст, и контекст определяют идентификатор сообщения, поэтому даже правка одного лишь контекста может потребовать новой записи в каталоге переводов.

Проверяйте плейсхолдеры как значения с неизменным назначением. Переводчик должен иметь возможность переставить имя человека или сумму, не меняя идентификатор соответствующего плейсхолдера. В форматированном тексте оставляйте навигацию и поведение компонентов в коде, а предложение вокруг именованных тегов переводите. Точные API описаны в разделах Сообщения и Форматированный текст.

Сначала проверьте извлечение, затем переводы #

Установите CLI и выполните команду из нужного каталога проекта:

sh
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 описаны плюсы и минусы этих способов доставки и отличия управляемого приложения. В обоих случаях отделяйте право на слияние от права на запуск и одобрения содержимого.

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