Переход на актуальный CLI
Замените устаревшие бакеты и отпечатки исходного содержимого, сохранив принятые переводы и работоспособность приложения.
Актуальный @lingo.dev/cli выполняет операции push/pull на сервере и использует .lingo для хранения состояния проекта. Старый пакет lingo.dev обрабатывает бакеты локально и использует i18n.json и i18n.lock. При переходе важно сохранить нужное проекту поведение, а не просто переименовать команду.
Сохраните рабочее состояние перед переходом #
Запишите установленную версию и сохраните исходные файлы, принятые переводы, конфигурацию и старый Lockfile в системе контроля версий. Убедитесь, что приложение загружает эти переводы. Оставьте маршрутизатор, провайдер, переключатель языков и загрузчик каталогов из текущей системы локализации, пока замена не заработает на ограниченном участке.
Запишите версии фреймворка и среды выполнения, а также нужные локали: исходную, целевые и локаль по умолчанию. Проверьте типичные маршруты с префиксом локали, первоначальное определение языка, переход на запасной язык и переключение языков. Проводите эти проверки приложения отдельно от перехода на новый способ перевода файлов.
Заново настройте выбор файлов #
Создайте .lingo/config.json, укажите исходную и целевые локали и явно задайте файлы. Затем привяжите организацию, к которой у вас есть доступ, и движок локализации. Старые бакеты и отпечатки нельзя перенести в эту схему простым переименованием.
Текущая конфигурация CLI поддерживает 22 формата, включая HTML (.html и .htm), обычный текст (.txt, по одной единице на строку, как в v0), таблицы CSV с отдельным столбцом для каждой локали в одном файле и файлы Java .properties (по одной единице на ключ, как в v0, с сопоставлением lockedKeys, preservedKeys и ignoredKeys по тем же правилам, что и в v0, и lockedPatterns в синтаксисе RE2, который не поддерживает опережающие и ретроспективные проверки и обратные ссылки). Перед переносом файла набора csv из v0 сверьте его со структурой CSV. Пути набора properties из v0 сверьте с разделом Файлы свойств Java: имя файла [locale], например messages_[locale].properties, превращается в шаблон исходных файлов вида messages_en.properties. Для наборов CSV с отдельным файлом для каждой локали, MJML и других наборов, поддерживаемых только в старой версии, потребуется проверенное преобразование или другой способ перевода. В разделе Конфигурация указаны точные значения перечисления, правила сопоставления и шаблоны вывода. Настройки модели, промпта и базового URL для прямого подключения к провайдеру из v0 не входят в схему этого проекта.
Прежде чем расширять конфигурацию, проверьте один выбранный исходный файл и вычисленные для него пути целевых файлов. Для свойств форматов семейства Markdown используйте translateComponentProps.
Подхватите и обновите переводы #
В актуальной версии планирование в заданной области или при начальной настройке позволяет подхватить существующие переводы. Прежде чем принять их за исходное состояние, проверьте типичные файлы и ручные правки: само наличие файла не подтверждает, что значения в нём соответствуют последней версии исходного содержимого.
Дозаполнение создаёт недостающие обычные файлы, тогда как v0 обычно добавляет недостающие ключи в существующие каталоги. Для последующей работы с такими ключами используйте инкрементальные обновления исходного содержимого в актуальной версии или поддерживаемое обновление ключей. Переименованный ключ JSON обрабатывается как новый путь, даже если его текст совпадает с текстом старого ключа. Не рассчитывайте на повторное использование перевода по отпечатку содержимого при переименовании, как в v0.
При инкрементальном обновлении можно сохранить правки переводов, если ключи не изменились. Явные правила сохранения ключей позволяют отдельно выбрать, кто отвечает за их содержимое. Для форматов с отдельными файлами принудительная обработка всего файла исключает текущий перевод из контекста и может заменить принятые формулировки. Поэтому она не подходит как быстрый способ подхватить существующие переводы.
Завершите первый запуск актуальной версии #
Пройдите шаги из актуального краткого руководства, включая дозаполнение и получение файлов. Обычный первый push без зафиксированного исходного состояния сохраняет байты исходных файлов, а не запрашивает первоначальные переводы. Прежде чем считать рабочий процесс с файлами завершённым, дождитесь результата или выполните pull.
Сохраняйте в одном коммите принятые исходные файлы, файлы перевода, конфигурацию и текущий Lockfile. Указатель на последний запуск хранится только локально в домашнем каталоге и не передаётся через Git. При следующем pull сравниваются хеши. Если закоммитить только расходящееся изменение, конфликт не разрешится. lingo check заменяет прежнюю проверку с замороженным Lockfile на уровне файлов: команда завершается с ошибкой, если исходный файл изменился после .lingo/lock.json или файл перевода отсутствует. При этом она никогда не создаёт недостающий Lockfile. Если Lockfile не сохранён в коммите, команда не может обнаружить изменения исходных файлов и проверяет только наличие файлов перевода.
Переход для React #
Актуальный рабочий процесс React извлекает вызовы с литеральным исходным текстом и контекстом в JSONC и объявления, переводит выбранные каталоги, а затем загружает карту строк во время выполнения. Прежде чем применять изменения шире, проверьте на одном компоненте запасной текст, переменные, переключение локалей и принятые формулировки.
Для работы с конкретным пакетом используйте разделы Перенос существующих сообщений React и React. Входящий в пакет lingo guide migrate отражает установленную версию, но не гарантирует соответствия всем ранее сгенерированным конфигурациям.