ウォッチモード：ファイル変更時の自動再翻訳

Lingo.dev CLIは、runコマンドの強力なウォッチモードをサポートし、ソースファイルが変更されるたびに自動的に再翻訳を実行します。

仕組み

--watchフラグを付けてCLIを実行すると、設定されたソースファイル(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コマンドを使用して、1回限りの翻訳を実行してください。