lingo purge
ターゲットファイルの削除をプレビューし、Lockfileから削除されるエントリを確認します。
lingo purgeは、生成されたターゲットファイルを意図的に削除するためのコマンドです。通常のファイルモードでは選択したパスをプレビューし、--yesを指定すると削除を実行します。--fileまたは--localeを指定した場合は、選択したターゲットと対応するLockfileのエントリだけを削除し、ソースの基準情報と他のターゲットのエントリは保持します。フィルターを指定しない場合は、プロジェクトのLockfile全体も削除します。
通常のターゲットをプレビューする#
JSONを個別のファイルに保存する構成の場合:
lingo purge --locale de --file locales/en.json表示されたターゲットが、削除してよい意図したファイルであることを確認してください。--yesを追加する前に、採用済みの出力を保存しておいてください。後で再生成に失敗しても、その時点ではすでにファイルは削除されています。
| オプション | 動作 |
|---|---|
--locale <locale> | 複数回指定できるターゲットフィルターです。既定では設定済みのターゲットを使用します。ソースロケールは指定できません。 |
--file <value> | 複数回指定できるソースパスフィルター、またはグロブで指定されたエントリに対する具体的なソースパスです。 |
--lockfile-only | .lingo/lock.jsonのみを削除します。--yesが必須で、--fileまたは--localeとは併用できません。 |
--yes, -y | ファイルモードのプレビューではなく、削除を実行します。 |
導出されたパスがプロジェクトルートの外を指す場合は拒否されます。シンボリックリンクを介してルートの外や.git内を指すパスも対象です。パージは、--yesを指定しなくてもこれらのパスを報告します。ルート内のファイルでも、重要なソースや共有データである可能性があります。保存場所だけでなく、ファイルの用途や内容も確認してください。
ファイルの選択#
パージは、設定内で具体的に指定されたソースと--fileの具体的な値からパスを導出します。具体的なソースパスを指定しない限り、設定内のグロブはスキップします。具体的な設定エントリに対して、--fileは部分文字列の一致で絞り込みます。一般的なグロブ展開を行うものではありません。
パージは、ソースと同じパスを持つターゲットをスキップし、翻訳がソースファイル内にあることを報告します。共有のXCStringsカタログはこの構成のため、パージで特定のロケールだけを削除することはできません。代わりに文字列カタログの修正ワークフローを使用してください。
Lockfileの変更#
フィルターを指定したパージは、対象のターゲットファイルがすでに存在しなくても、選択したターゲットのエントリを削除します。ソースのハッシュは保持されるため、未反映のソース変更は後でプッシュした際に他の言語へ反映できます。Lockfileの形式が不正な場合は、ターゲットを削除する前に停止します。再試行する前に、Lockfileを復元または修復してください。
フィルターを指定しないlingo purge --yesとlingo purge --lockfile-only --yesは、Lockfile全体を削除します。--yesを指定せずにLockfileのみを対象にする場合は、通常のファイルプレビューではなく、確認が求められます。
Lockfileがないと差分処理の計画が変わります。ただし、サーバー側での再利用は別の仕組みのため、モデルが新しい出力を生成するとは限りません。通常のファイル欠落にはbackfillを使用してください。不要になったReactのエントリにはcleanを使用してください。作業が中断した場合は、利用可能な状態を保持しながら、まず復旧から始めてください。