Как добавлять локали и управлять ими в CLI v0
Выберите нужный вариант языка, добавьте целевую локаль в старой версии и проверьте файлы и работу приложения.
В v0 locale.source задаёт исходный язык, а locale.targets — целевые локали для регулярного перевода. Выберите вариант для ваших читателей, затем проверьте, что конфигурация, имена файлов, бэкенд и приложение используют его единообразно.
Добавьте одну целевую локаль #
Чтобы добавить немецкий к уже поддерживаемым испанскому и французскому, измените i18n.json:
{
"locale": { "source": "en", "targets": ["es", "fr", "de"] }
}Запустите установленный исполняемый файл v0 для этой целевой локали:
lingo run --target-locale deФлаг заменяет список целевых локалей для текущего запуска и позволяет выбрать локаль, которой нет в конфигурации. Для будущих запусков добавьте её в конфигурацию. Шаблон отдельных файлов locales/[locale].json записывает результат в locales/de.json. Проверьте значения и загрузите этот файл в приложение, прежде чем делать немецкий доступным читателям.
Если целевой локали ещё нет, для неё нужно перевести все выбранные ключи. Если она уже есть, существующие значения обычно сохраняются, а недостающие ключи заполняются. Но изменения исходного текста всё же могут потребовать повторного перевода. Не совмещайте первое добавление языка с массовым принудительным обновлением, если другие уже одобренные локали должны остаться без изменений.
Запуск для одной целевой локали не обновляет сохранённую контрольную сумму исходного текста, которая служит точкой отсчёта. Следующий обычный запуск может снова обработать изменённый исходный текст. Поэтому сверьтесь с правилами фиксации изменений, прежде чем считать, что проверка одной локали окончательно фиксирует результат.
Указывайте регион и письменность, когда это важно #
{
"locale": {
"source": "en-US",
"targets": ["en-GB", "es-MX", "pt-BR", "fr-CA"]
}
}Локали с указанием региона помогают выбрать нужные языковые нормы. Английские color/colour, испанские ordenador/computadora и португальские trem/comboio показывают, почему одного лишь языка может быть недостаточно. Выбор слов всё равно зависит от контекста: тег не гарантирует, что каждое сгенерированное выражение подойдёт аудитории. Для китайского тоже может понадобиться уточнение письменности или региона, например zh-Hans или zh-TW.
Посмотрите списки для установленной версии:
lingo show locale sources
lingo show locale targetsЭти списки не гарантируют поддержку и качество перевода для каждого бэкенда. Прежде чем расширять охват, проверьте выбранную пару на небольшом объёме, а не полагайтесь на число языков, заявленное в прошлом.
Разделяйте обозначение языка и структуру файлов #
Старая версия приводит несколько вариантов обозначений, принятых на разных платформах, к единому виду для запросов API. При этом файлам могут требоваться имена с подчёркиваниями или по правилам ресурсов Android. Используйте настройку разделителя и структуру выбранного формата, затем проверьте, куда фактически записан результат.
Перевод не задаёт dir, не отражает элементы управления зеркально и не добавляет маршрутизацию. Для арабского, иврита, персидского и урду обычно нужно отображение справа налево (RTL). Проверьте интерфейс, который использует перевод, включая числа и идентификаторы в тексте. Приложение должно не только загружать содержимое новой локали, но и распознавать её.
Удалите целевую локаль #
Удаление кода из locale.targets исключает локаль из дальнейшего выбора. Существующие файлы остаются. Отдельно решите, сохранить их, перестать отдавать их приложению или удалить. Очистка удаляет данные и может затронуть исходное содержимое. Это не то же самое, что удалить локаль из конфигурации.