Как использовать готовые переводы в CLI v0
Добавьте недостающие ключи в старые каталоги, сохранив существующие значения и создав надёжную базовую версию исходного текста.
V0 может работать с каталогами, созданными в других инструментах. В обычном режиме он сравнивает ключи исходного и целевого каталогов и добавляет недостающие записи, не генерируя существующие значения заново. Это отличается от добавления недостающих файлов в текущей версии CLI.
Сохраните готовые переводы #
Настройте бакет каталога в i18n.json и сохраните резервную копию принятых переводов. Убедитесь, что существующие значения действительно переведены: заглушки на исходном языке могут скрывать пропуски, которые вы хотите заполнить.
Например, в этом исходном каталоге три ключа:
{
"welcome": "Welcome back",
"button.save": "Save",
"button.cancel": "Cancel"
}В существующем испанском переводе их два:
{
"welcome": "Te damos la bienvenida de nuevo",
"button.save": "Guardar"
}Обычный запуск для заполнения пропусков добавляет button.cancel и сохраняет существующие значения. Исключение — случаи, когда предыдущие контрольные суммы указывают на изменение исходного текста, требующее повторного перевода.
Обработайте одну локаль и проверьте различия #
lingo run --target-locale esПроверьте добавленные ключи, удаление ключей, которых больше нет в исходном каталоге, и заново сгенерированные значения для изменённых ключей. Проверьте язык переводов и их загрузку в приложении, затем сохраните принятый результат в коммите вместе с состоянием Lockfile.
Запуск с ограниченной областью обработки не обновляет существующий базовый набор контрольных сумм исходного текста. Если Lockfile не изменился, это ещё не значит, что все локали соответствуют текущему исходному тексту. Следующий обычный запуск может повторно обработать изменённый исходный текст. Следуйте инструкциям по согласованию базовой версии.
Если для существующего ключа нет предыдущей контрольной суммы, 0.138.10 не помечает его как обновлённый лишь из-за её отсутствия. Поэтому отсутствие Lockfile не вызывает принудительный повторный перевод всего содержимого, но и не подтверждает актуальность существующих переводов. Проверьте пары исходного текста и перевода, в которых сомневаетесь, прежде чем полагаться на новую базовую версию.
Исправьте известные проблемы отдельно #
Если существующее значение неверно, исправьте его вручную или запросите выборочное обновление:
lingo run --force --target-locale es --key button.cancelПринудительное обновление может перезаписать ручные правки. Используйте сохраняемые ключи, если значение должно оставаться под контролем человека. Такой контроль должен включать и проверку последующих изменений исходного текста.