Справочник по CLI v0
Поддерживайте существующий проект с i18n.json, сохраняя принятые переводы и базовое состояние исходного текста.
В этом руководстве описаны прежний пакет lingo.dev и его рабочий процесс i18n.json/i18n.lock. Примеры рассчитаны на 0.138.10. Пока вы планируете миграцию, сохраняйте версию, указанную в Lockfile существующего проекта. Установка последней версии не обеспечивает воспроизводимое восстановление: эта версия со временем меняется.
Для нового проекта начните с актуального CLI. Его серверный рабочий процесс push/pull использует другие правила управления состоянием и отбора данных.
Как проходит запуск установленной версии v0 #
Конфигурация бакета определяет парсер и позволяет найти исходные и целевые файлы, при необходимости раскрывая [locale]. Парсер извлекает содержимое и отделяет значения, которые распознал как непереводимые. Затем сравниваются исходные значения, существующие переводы и прежние контрольные суммы исходного текста. Так определяются новые, изменённые, удалённые и переименованные записи.
Выбранный текст обрабатывает движок локализации Lingo.dev или настроенный провайдер с прямым подключением. Из полученных переводов собираются целевые файлы или разделы локалей в общем файле. Одни задачи могут записать успешные результаты до того, как другая завершится с ошибкой. Обработка всего проекта — не атомарная транзакция.
Храните базовое состояние вместе с содержимым #
Сохраняйте i18n.json, принятые переводы для локалей и i18n.lock в одном коммите. Lockfile хранит состояние исходного текста, а не каждую правку перевода или утверждение переводов для языка. Обычные запуски обновляют контрольные суммы исходного текста. Запуски для отдельных целевых локалей или ключей могут записывать результат, не обновляя существующее базовое состояние.
В справочнике по Lockfile объясняется, почему после запуска для отдельных локалей или ключей обычный запуск может снова обработать изменение исходного текста. Раздел «Существующие переводы» поможет начать работу без замены всех имеющихся значений.
Выберите следующий шаг #
Воспользуйтесь инструкцией для первого файла, чтобы воспроизвести небольшой запуск прежней версии. Разделы «Конфигурация» и «Форматы» описывают, что читает и записывает установленное поколение CLI.
В дальнейшей работе раздел «Локали» поможет добавить целевую локаль, «Управление ключами» — отличить обычные правки от значений, которыми управляют люди, а «Повторный перевод» — выбрать, что нужно целенаправленно обновить. Разделы «Монорепозитории» и «Параллельная обработка» описывают зоны ответственности и пропускную способность, не предполагая, что увеличение числа обработчиков снимает ограничения провайдера.