長編の階層を見失わない！ローカル型テキストエディタ、ローカルの資料・画像をツリー管理

ローカルの長編原稿は、本文・資料・画像を三つのフォルダへ分け、相対参照の起点を本文ファイルのある場所へ固定すると管理しやすくなります。画像を移動した後は、パスが自動的に直ったと決めつけず、旧パス検索と実ファイルの表示で確認します。

フォルダをきれいに見せることが目的ではありません。半年後にC07.mdを開いたとき、人物表、年表、地図の場所が分かり、リンク切れの原因をたどれることが目的です。

8章・5資料・4画像の役割を分ける

次のような構成を例にします。

命名規則は「用途が分かる英小文字とハイフン」にします。日付が判断に必要な資料ならtimeline-2026-09.mdのように足します。資料1.mdやIMG_1234.pngのままでは、ツリーだけを見ても役割が分かりません。

六つの相対参照を一覧にする

具体例では、本文から資料・画像への相対参照を六つ用意します。

参照元 参照先 用途
C01.md ../refs/characters.md 登場人物確認
C02.md ../refs/timeline.md 時系列確認
C03.md ../refs/places.md 地名確認
C04.md ../images/city-map.png 本文画像
C05.md ../images/room-layout.png 本文画像
C08.md ../refs/sources.md 出典確認

画像には「旧市街と川を示した物語用地図」のような代替文を付けます。代替文はファイル名の読み上げではなく、画像が伝える内容を書きます。

ファイルを移動するときの判断手順

  1. 移動前に対象ファイルの利用箇所数を数え、旧パスを書き留めます。
  2. 原稿と画像の複製で、一ファイルだけを新しいフォルダへ移動します。
  3. エディタのファイル操作が参照更新を案内する場合は、対象一覧を読んでから実行します。
  4. 移動後に旧パスをワークスペース検索し、0件であることを確認します。
  5. 新パスの件数を数え、参照元ファイルを開いて画像表示またはリンク先を確認します。

旧パス0件だけでは不十分です。参照そのものを消しても0件になるため、新パスの件数と実際に開けることを組み合わせます。

Rune Studioで資料と画像を扱う範囲

Rune Studioの現行Mac版の公開資料では、ファイルツリーで原稿・資料・画像を管理し、txt、text、md、markdown内のMarkdown画像・リンク記法を対象に、アプリ内の移動や名前変更後の参照パスを更新すると説明されています。外部URLやページ内リンクは同じ更新対象ではありません。

対象例は、代替テキストと../images/city-map.pngを組み合わせたMarkdown画像参照や、人物表というリンク文と../refs/characters.mdを組み合わせた参照です。すべての文書形式、OSのエイリアス、ワークスペース外の参照へ広げて考えないでください。

今回直接確認できたこと

専用の作業場では、chapters、refs、images、assetsのツリーを取得し、章8件と画像4件を含む構成を使いました。images/I1.pngの利用箇所は1ファイル内の3件でした。

その画像をassets/I1.pngへ移動した後、別の検索・置換操作で../images/I1.pngを../assets/I1.pngへ3件変更しました。結果は旧パス0件、新パス3件でした。

自動更新としては確認していない

今回の記録では、移動操作とパス置換は別々に行っています。そのため、「移動しただけで3参照が自動更新された」とは言えません。公開資料に自動更新機能は記載されていますが、現行画面での移動・更新案内・結果を一続きに観察する必要があります。

また、5資料すべて、六つの相対参照、命名規則、代替文を読み戻したわけではありません。上の一覧は本番前に作る設計例です。自分の複製ワークスペースで六つを作り、移動前後の参照と表示を確かめてください。

自動と手動の境界をそろえる

Rune Studio内の移動で参照更新が表示され、旧0・新3・画像表示まで確認できた場合は、自動更新として利用できます。どこかが合わない場合は、検索・置換で明示的に更新し、その操作を記録します。どちらの方法でも、最終判定は旧パスと新パスの二方向検索です。

現行Mac版の機能はRune Studio公式サイトで確認できます。結論は、三役のフォルダ、意味の分かる名前、六つの参照一覧、移動後の旧0・新件数・表示確認を一組にすることです。ツリーの見た目ではなく、参照がたどれることを合格条件にしてください。

参照一覧を更新したら、変更した章だけでなく、同じ画像名を使う別章も検索します。別フォルダに同名画像がある場合は、件数だけでなくフルパスまで確認してください。

投稿日：