Lingo clean

ソースメッセージが使われなくなったことを確認してから、不要になったJSONCカタログのエントリを削除します。

ソースコードからメッセージが削除されると、抽出処理によって対応するカタログエントリが孤立したエントリとしてマークされます。lingo cleanは、これらのソースエントリと、現在有効なソースに存在しなくなったターゲットキーを削除します。編集するのは個々のエントリであり、ロケールファイル全体ではありません。欠落している値の翻訳も行いません。

削除してよいか事前に確認する #

抽出を実行し、警告と孤立したエントリを確認してください。動的な呼び出しや分割代入を使った呼び出しは、アプリケーションで引き続き使われていても、認識されなくなる場合があります。必要なメッセージを削除するのではなく、抽出の問題を修正してください。

クリーンアップの前に、元に戻せるよう差分を保存してください。このコマンドは、ソースと検出されたすべてのターゲットのJSONCカタログを即座に書き換えます。試行実行、確認フラグ、ターゲットロケールによる絞り込みは利用できません。

sh
lingo clean --source-locale en

--source-localeの既定値はenです。優先順位は--out、設定済みのi18n.messagesPath、localesの順で、パスはプロジェクトルートを基準に解決されます。ソースの<locale>.jsoncは存在し、空でない必要があります。この条件を満たさない場合、コマンドは失敗し、先に抽出を実行するよう案内します。

カタログのメンテナンスを完了する #

ソースとターゲットごとに報告される削除件数を確認してから、差分を確認してください。クリーンアップではTypeScriptの宣言は再生成されません。同じパスとソースロケールを指定してextractとcheckを実行し、その後、アプリケーションのチェックを実行してください。

ターゲットファイルやベースラインを意図的に削除する場合は、purgeを使ってください。孤立したカタログエントリを削除する場合は、cleanを使ってください。