감시 모드: 파일 변경 시 자동 재번역

Lingo.dev CLI는 이제 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의 경우, 일회성 번역 실행을 위해 --watch 없이 표준 run 명령을 사용하세요.