画像が消える事故を防ぐ!テキストエディタのリンク、ファイル移動後の相対リンク修正

ファイル移動後の相対リンク修正について、移動前に参照元と参照先を列挙し、移動後は相対リンクの到達先を再確認する工程を抽象的に示したアイキャッチ

ファイル移動後に画像や資料へのリンクが切れたら、まず「移動前の本文に書かれた相対パス」と「移動後の実ファイル位置」を照合します。テキストエディタが自動で追従したと決めつけず、壊れた参照だけを洗い出して修正するのが安全です。

この記事は、章ファイルを別フォルダへ移した直後の復旧に限定します。リンクを新規挿入する方法や、URLをブラウザで開く操作は扱いません。

相対リンクは「本文から見た道順」

chapters/01.mdからimages/map.pngを参照する場合、本文に必要なのはファイルシステム全体の住所ではなく、01.mdから画像までの道順です。章をdraft/01.mdへ移すと、画像が同じ場所にあっても道順が変わります。

復旧前に、本文ファイル、参照先、両者の共通フォルダを紙やメモで一本の木として描くと迷いません。絶対パスへ逃げると自分のMacでは開けても、フォルダを渡した先で壊れやすくなります。

三つの参照を一本ずつ直す例

章をdraft/からmanuscript/chapters/へ移し、表紙画像、人物表、参考資料の三つが切れたとします。

  1. 移動後の章ファイルを正本として複製する
  2. 本文から三つのリンク文字列を控える
  3. 参照先ファイルが実在するか確認する
  4. 新しい章位置からの相対パスを一つだけ書き換える
  5. その一つが開けたら、残り二つを同じ考え方で直す

Rune Studioの資料には、対応するテキスト内の画像・リンクを扱い、移動や名前変更後の相対パスを追従修正する機能が記載されています。一方、このガイドの制作時に確認できた変更は、ファイル移動後に明示的な文字列置換を一件行ったものです。これは自動追従の実証ではありません。そのため本文でも、「移動しただけで必ず直る」とは説明しません。

一括置換をする前の境界

同じ古いパスが複数ファイルに残る場合は、置換前に対象件数を数えます。新旧の文字列だけでなく、対象拡張子とフォルダも絞ります。似た名前の別画像まで変わる候補が一件でもあれば、一括置換ではなく個別修正へ戻します。

修正後は逆向きに古いパスを検索します。ゼロ件なら古い参照は消えていますが、それだけで新しい参照先の実在は証明できません。各リンクを開き、画像なら表示、資料なら目的のファイルであることまで確認します。

直らないときの戻り方

移動前にできる予防

フォルダを移す前に、本文内の相対リンクを検索し、参照先の種類と件数を控えます。画像三件、資料二件のように期待値があれば、移動後に一件消えたり余計に増えたりしたことへ気づけます。参照先も一緒に動かすのか、本文だけを動かすのかを先に決めます。

共同作業では、移動担当が新しい場所だけを伝えるのではなく、古い場所、移動した対象、残した対象を一組で記録します。相対パスは二点間の関係なので、片側だけの情報では直せません。

修正完了の判定

完了条件は「古い文字列がゼロ件」ではなく、「期待した全リンクが意図したファイルを開く」です。画像は絵の内容、資料は見出しまで確認します。同名ファイルがあるプロジェクトほど、この最後の目視が重要です。

本番へ進む前の確認票

移動後の相対リンク修復を本番へ広げる前に、次の欄を一つずつ閉じます。結果が空欄のままなら、作業量が多くても完了とはしません。

移動後の相対リンク修復の一覧は成功を飾るためではなく、途中で条件が変わったことへ気づくために使います。二回目に同じ結果を得られない場合は、範囲を増やさず最初の例へ戻ります。資料上の機能、画面上の項目、開始から結果まで終えた操作も、移動後の相対リンク修復では別々の事実として記録します。

Rune Studioを使わない場合の進め方

専用機能を使わなくても、一件を手動で直して開くことで目的へ近づけます。OSのファイル複製、普通の検索、別名保存、生成物の内容確認を組み合わせれば、未確認の自動処理へ賭けずに進められます。

Rune Studioを選ぶ意味は、移動後の相対リンク修復で生じる手間を現行Mac版機能で減らせるか試せる点です。まだ記録のない結果は短い複製で確かめます。移動後の相対リンク修復の結果を自分で読みたい人には向きますが、未確認の自動化を多数の原稿へ即時適用したい人には向きません。

次の一歩は、移動後の相対リンク修復について上の確認票を一行埋められる最小の複製を作ることです。その結果を確かめてから、必要ならRune Studioの商品ページで現行Mac版の対応範囲を確認してください。

結論

ファイル移動後の相対リンク修正は、自動化の有無より「起点・参照先・変更件数」を固定できるかで事故を防げます。Rune Studioを使う場合も、現在の記録で確かめられた明示的な修正と、資料にある自動追従を分けて判断してください。まず切れたリンクを一つ直し、その道順を残してから全体へ広げます。Rune Studioのファイル管理機能を確認する