Режим наблюдения: автоматический перевод при изменении файлов
CLI Lingo.dev теперь поддерживает мощный режим наблюдения для команды run, позволяя автоматически выполнять перевод при каждом изменении исходных файлов.
Как это работает
Когда вы запускаете CLI с флагом --watch, он непрерывно отслеживает изменения в ваших настроенных исходных файлах (как указано в ваших корзинах i18n.json). При добавлении, изменении или удалении файла CLI автоматически запускает процесс перевода, обновляя файлы целевых локалей и i18n.lock по мере необходимости.
Это идеально подходит для быстрого развития, сред с живым предварительным просмотром или любого рабочего процесса, где переводы должны оставаться синхронизированными с вашим исходным контентом в реальном времени.
Использование
npx lingo.dev@latest run --watch
- CLI запустится в режиме наблюдения, отображая логи обнаруженных изменений и прогресса перевода.
- По умолчанию изменения обрабатываются с задержкой в 5 секунд, чтобы избежать избыточных запусков при частых правках.
- Процесс будет продолжаться до тех пор, пока вы его не остановите (Ctrl+C).
Опция задержки
Вы можете настроить задержку обработки изменений (в миллисекундах) с помощью флага --debounce:
npx lingo.dev@latest run --watch --debounce 10000
В этом примере устанавливается 10-секундное окно задержки между обнаруженными изменениями и следующим запуском перевода.
Особенности
- Автоматический перевод: мгновенно обновляет переводы при редактировании исходных файлов.
- Обработка с задержкой: предотвращает избыточные запросы на перевод при частых изменениях файлов.
- Обработка ошибок: режим наблюдения корректно обрабатывает ошибки и продолжает мониторинг после сбоев.
- Все типы файлов: работает с любыми типами файлов, поддерживаемыми вашей конфигурацией
i18n.json.
Когда использовать режим наблюдения
- Во время активной разработки многоязычных функций
- При предварительном просмотре изменений перевода в вашем приложении в реальном времени
- Для непрерывной интеграции с локальными или облачными средами разработки
Совет: Режим наблюдения предназначен для разработки и быстрого внесения изменений. Для продакшена или CI/CD используйте стандартную команду run без параметра --watch для одноразовых запусков перевода.