画像の削除前警告は、ファイルを消すのを止めるためではなく、どの原稿がそのパスに依存するかを判断するためにあります。テキストエディタ 画像挿入後に資産を整理するなら、使用ファイル数、出現数、移動先、書き換え後の新参照を記録します。
削除ではなく移動を使って依存を検証した
検証原稿のMarkdown画像はassets/figure.pngを1回参照していました。使用状況の検査は1ファイル・1出現、移動後の書き換え予定も1ファイル・1出現でした。適用後には旧参照0、moved/renamed-figure.pngへの新参照1が残りました。画像を参照する原稿と参照回数が対応しています。
本番で警告が出たら、どの原稿か分からないまま削除を続けないでください。参照元を開き、本当に不要な画像か、移動後の新パスに直すべきかを決めます。横断置換の件数が予想より多いときは、未保存タブや別の章にも依存があるサインです。
製品資料は、使用中の画像やリンク対象を削除する前に利用ファイル数と出現数を警告すると説明しています。今回はCLIで使用状況を測りましたが、画面の確認ダイアログは未実測です。合格は、対象を消す前にすべての参照元を説明でき、削除または移動後に本文から到達できない参照が0であることです。
削除候補から逆向きに参照元をたどる
画像を消す前に、その画像名を本文、表紙設定、書誌関連ファイルから検索します。今回の参照移動では一つの参照を新パスへ移し、旧0・新1を得ました。これは「新しい場所が一件使われている」という証拠で、ほかの同名画像が未使用だという証明ではありません。画像ハッシュも使い、別ファイルを誤って削除候補にしないようにします。
公開資料の削除警告は有用ですが、今回のCLI試験はダイアログ表示を測っていません。したがって、警告が必ず防いだとは書かず、参照検索の結果を根拠に採否を決めます。参照が残る画像は退避し、すべて0になった後も一度EPUBを生成してから削除を確定します。
表紙設定にだけ残る参照を見落とさない
本文検索で画像名が0件でも、作品設定が表紙として同じ画像を保持している場合があります。削除候補を調べるときは、Markdown、ワークスペース設定、EPUB設定、生成済みmanifestを順に検索します。それぞれの結果を同じ「参照0」にまとめず、場所ごとの件数を残します。
新パスへ移した後は、設定ファイルを閉じて再び開き、保存されたパスを読みます。メモリ上の表示だけを根拠にすると、保存失敗を見逃すからです。旧パス0、新パス1、生成EPUBの画像ありを一つの試行でそろえます。
警告ダイアログを画面で検証していない場合、警告が必ず出るとは結論づけません。参照監査の実値で削除可否を決め、UIの確認は別の検査項目として残します。
route-map.assetを二つの原稿から参照した
削除試験に実画像は不要なので、合成した非画像資産route-map.assetを使いました。二つの原稿ファイルからMarkdown形式で各1回参照し、refs usageを実行するとfileCount=2、occurrenceCount=2でした。削除候補と参照元の対応が一対一で残るため、「使っていそう」という印象ではなく二件の依存として判断できます。
trashはdry-runで止めて候補を保存した
続いてfile trash --dry-runを実行し、実削除へ進まず計画だけを取得しました。候補ファイルが残っていることを再確認し、actual_deletion_performed=falseを記録しています。非ゼロの参照数を見た後の正しい回復は、削除を取り消すことです。警告を試すために使用中資産を本当に捨てる必要はありません。
警告ダイアログの表示はCLIから見えない
製品のUIとCLI対応表には削除前確認画面が示されていますが、今回のコマンドはグラフィカルなダイアログを描画しません。ボタン文言、警告色、表示タイミングは未実測です。本文が証拠にするのは二ファイル二出現と、dry-run後も候補が存在した事実です。
本当に消す日は依存0件から始める
資産を廃止するなら、先に二つの原稿を別の資産へ更新し、旧参照を再検索します。外部URL、CSS、未保存タブなどCLIの対象外も別に確認し、依存0件を得てから承認者が削除します。今回はそこまでの変更を行っていません。
合格は、候補の絶対パスを固定し、参照元が2ファイル2件と読め、削除が実行されず、候補が保存されていることです。削除前警告の目的はダイアログを見ることではなく、リンク切れを作る操作を止めることにあります。
参照0件へ減らした後も、削除予定のSHAを記録し、同名の別資産を対象にしていないか確かめます。ゴミ箱へ移す方式なら復元期限と担当者も作業票へ残します。使用中だった履歴を消さず、置換先と旧資産の関係を記録すれば、後日レイアウト差が見つかったときも戻れます。
削除候補のSHAも保存し、同名の別ファイルと取り違えないようにします。