Как добавить язык, не переводя всё заново

Добавьте новую целевую локаль, сохраните принятые переводы и проверьте, что приложение может использовать новые ресурсы.

Чтобы добавить язык, нужно сделать три вещи: выбрать его для перевода, создать ресурсы и настроить их загрузку в приложении. Новый пункт в списке языков интерфейса не создаёт каталог переводов. А переведённый каталог ещё не означает, что маршрут его использует.

Начните с исходных текстов и принятых переводов, которые можно восстановить. Зафиксируйте нужную локаль, при необходимости указав регион или письменность. pt-BR и pt-PT обозначают разные аудитории, и требования к формулировкам у них могут различаться.

Изучите текущую структуру и рекомендации #

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

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

Добавьте целевую локаль в текущий проект CLI #

Текущие целевые локали CLI задаются в targetLocales в .lingo/config.json. У push нет параметров --target-locale и --locale. В монорепозитории проверьте, какая конфигурация проекта выбирается с учётом рабочего каталога.

Прежде чем добавлять целевую локаль, обработайте все ещё не переведённые обычные изменения исходных текстов для существующих языков с помощью lingo push --wait. Завершите проверку, получите результат и сверьте переводы с текущими исходными текстами. Не меняйте эту версию исходных текстов, пока добавляете новый язык.

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

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

sh
lingo push --backfill-missing --estimate
lingo push --backfill-missing --wait

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

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

Если запрос должен затрагивать только одну локаль, ограничьте список targetLocales в контролируемой ветке или конфигурации задания, а затем восстановите полный список. Не включайте принудительный режим только ради нового языка: он заново переводит существующие переводы в выбранной области и может заменить проверенные формулировки. Эти различия описаны в разделе «Отправка», а флаги предыдущего поколения — в справочнике по локалям CLI v0.

Задайте помощнику те же ограничения #

Агент может изучить структуру, предложить рекомендации для локали и подготовить изменения конфигурации. Укажите, что ему разрешено менять: локальные файлы, настройки движка локализации организации или и то и другое. Различия между этими полномочиями описаны в разделе «Делегирование».

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

Проверьте результат для новой аудитории #

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

Загрузите типичные примеры контента в новой локали. Проверьте не только смысл, но и подстановку резервного языка, выход текста за границы и направление письма. Прежде чем расширять охват, сохраните версию исходных текстов и результат для измерения.

Если удалить локаль из конфигурации, она больше не будет выбираться для новых заданий, но ресурсы и маршруты приложения останутся. Решайте отдельно, нужно ли менять и их, — особенно если один общий каталог содержит исходные тексты и переводы на несколько языков.