Режим отслеживания: автоматический перевод при изменении файлов

Теперь в Lingo.dev CLI появился мощный режим отслеживания для команды run, который позволяет автоматически переводить файлы при каждом изменении исходных файлов.

Как это работает

Когда вы запускаете CLI с флагом --watch, он постоянно следит за вашими исходными файлами (указанными в ваших бакетах i18n.json) на предмет изменений. Если файл добавлен, изменён или удалён, CLI автоматически запускает процесс перевода, обновляя файлы целевой локали и i18n.lock по мере необходимости.

Это идеально подходит для быстрого девелопмента, live-просмотра или любого процесса, где важно, чтобы переводы всегда были синхронизированы с исходным контентом в реальном времени.

Использование

npx lingo.dev@latest run --watch
  • CLI запустится в режиме отслеживания и будет показывать логи об обнаруженных изменениях и ходе перевода.
  • По умолчанию изменения обрабатываются с задержкой в 5 секунд, чтобы избежать лишних запусков при быстрых правках.
  • Процесс будет работать, пока вы его не остановите (Ctrl+C).

Опция задержки (debounce)

Вы можете настроить задержку (в миллисекундах) с помощью флага --debounce:

npx lingo.dev@latest run --watch --debounce 10000

В этом примере устанавливается 10-секундное окно задержки между обнаружением изменений и следующим запуском перевода.

Возможности

  • Автоматический перевод: Мгновенно обновляет переводы при изменении исходных файлов.
  • Задержка (debounce): Предотвращает лишние запросы на перевод при частых изменениях файлов.
  • Обработка ошибок: Режим отслеживания корректно обрабатывает ошибки и продолжает работу после сбоев.
  • Любые типы файлов: Работает с любыми типами файлов, поддерживаемыми вашей конфигурацией i18n.json.

Когда использовать режим отслеживания

  • Во время активной разработки мультиязычных функций
  • При live-просмотре изменений переводов в вашем приложении
  • Для непрерывной интеграции в локальных или облачных dev-средах

Совет: Режим наблюдения предназначен для разработки и быстрой итерации. Для продакшена или CI/CD используйте стандартную команду run без --watch для разового запуска перевода.