Как повторно перевести выбранный контент в CLI v0
Обновляйте старые переводы после изменений исходного текста или инструкций, контролируйте объём обработки и сохраняйте принятые правки.
Используйте обычный запуск, когда меняется исходный контент. Принудительный запуск нужен, если исходный текст не изменился, но перевод должен учитывать новые инструкции или заменить неудачный вариант. Оба режима могут перезаписать обычные ручные правки.
Определяйте объём обычной обработки по изменениям исходного текста #
lingo run| Состояние исходного текста и перевода | Результат обычного запуска v0 |
|---|---|
| Контрольная сумма исходного значения отличается от предыдущей | Перевести изменённое значение. |
| Исходный ключ отсутствует в переводе | Перевести недостающий контент. |
| Исходный ключ удалён | Удалить соответствующую управляемую запись перевода. |
| У нового и удалённого ключей совпадают контрольные суммы исходных значений | Повторно использовать перевод в обрабатываемом контексте. |
| Перевод есть, исходный текст не изменился | Сохранить значение перевода. |
Обычная ручная правка сохраняется, пока исходный текст не меняется, но не защищена от всех будущих обновлений. Защищённые ключи сохраняют отдельное значение под управлением человека.
Обновите нужный перевод #
После изменения модели, промпта, глоссария или правила начните с локали и ключа, которых коснулись изменения:
lingo run --force --target-locale es --key welcome/titleЗдесь welcome/title указывает на title внутри welcome. В 0.138.10 команда run принимает точные ключи, префиксы с учётом границ и glob-шаблоны. Заключите --key 'welcome/**' в кавычки, чтобы выбрать вложенные ключи без раскрытия шаблона оболочкой.
Сравните перевод с исходным текстом, затем загрузите его в приложение. Обработка отдельной локали или области видимости ключей не обновляет существующее общее базовое состояние. Следуйте правилам согласования Lockfile, чтобы следующий обычный запуск неожиданно не обработал то же изменение исходного текста повторно.
Выберите посильный объём работы в большом проекте #
Селекторы --target-locale, --bucket, --file и --key можно указывать несколько раз. --source-locale меняет источник для запуска. Начните со списка групп форматов и путей из конфигурации, затем сузьте выборку. Не указывайте произвольный файл, которого нет в конфигурации.
lingo run --target-locale es --bucket json --file 'apps/web/**'Команда run отбирает файлы по подстроке или шаблону minimatch среди найденных путей из конфигурации. Команда purge отбирает файлы только по подстроке. Правила отбора ключей у неё тоже отличаются. Не переносите селекторы между этими командами без проверки выбранных записей.
Чтобы целенаправленно обновить больший объём:
lingo run --force --bucket json --target-locale esТак можно заново создать все выбранные переводы на испанский в формате JSON. lingo run --force без дополнительных параметров охватывает весь проект, заданный в конфигурации. Сохраните принятые результаты, прежде чем расширять область обработки, и оцените тот же объём принудительного перевода, если используете бэкенд Lingo.dev.
При масштабных изменениях обрабатывайте файлы и локали отдельными группами — так проще проверять различия. После сбоя сохраняйте результаты успешно обработанных частей и повторяйте запуск для нужной области, прежде чем принудительно переводить всё заново. Параллельная обработка управляет пропускной способностью, а не выборкой или откатом.
Храните каталоги строк интерфейса и документы в отдельных группах форматов, исключив сгенерированный контент и черновики. Используйте отдельные конфигурации пакетов, если целевые локали или движки локализации различаются. В CI lingo run --frozen проверяет доверенное базовое состояние без перевода. Разбирайтесь в причинах сбоев, а не пересоздавайте контрольные суммы, чтобы скрыть их. Текущий пример настройки среды запуска использует другой пакет и конфигурацию, поэтому перед переходом на него выполните миграцию.
Используйте purge, только если хотите удалить данные #
Старый подход «сначала purge, затем run» удаляет ключи перевода, чтобы обычное заполнение пропусков обработало их заново. При этом результат удаляется ещё до того, как удастся создать его заново, а выигрыш в производительности не подтверждён. Сверьтесь со справкой по purge, чтобы уточнить особенности селекторов и риски для исходной локали. Храните копию для восстановления, пока повторное создание и проверка не завершатся успешно.