ワークスペース横断検索を安全に使うコツは、検索語より前に「どのファイルを含め、どのフォルダを除外するか」を決めることです。一致件数と一致ファイル数を別々に読むと、一つの資料に検索語が集中しているのか、多くの章に広がっているのかが分かります。
最初に検索範囲の地図を作る
12章のMarkdown原稿をchaptersフォルダ、調査メモをrefsフォルダに置いているなら、本編検索ではchaptersの.mdだけを対象にし、refsは除外すると先に書きます。資料にある古い表記を本編の修正対象に混ぜないためです。
ファイルの拡張子だけでは不足です。同じ.mdでも、本編、プロット、作業メモ、過去版は役割が違います。フォルダの役割を先に決め、検索範囲を文章で説明できる状態にします。
18件と4件を混ぜない
固定語が本編に18件、refs内に4件ある標本なら、ワークスペース全体を検索すれば22件、除外が効いた本編検索なら18件が予想です。結果件数が合っていても、ファイル数が予想と違う場合は、一章に集中しているか、対象に漏れがあるかを調べます。
横断検索の価値は、件数を一度で数えることだけではありません。ファイル名と行、前後文を並べ、表記がどの章でどんな意味を持つかを読めることにあります。
Rune Studioの検索パネルで結果を二段階に読む
Rune Studioでワークスペースを開き、検索パネルに固定語を入力します。一段階目は件数とファイル数の確認です。二段階目は、各結果の前後文を読んで「修正候補」「正しい使用」「除外すべき資料」に分けることです。
確認用のワークスペースでは、3ファイルにある6件を検索し、置換下見6件、実変更6件、旧表記の逆検索0件を確かめました。この結果は検索と下見の経路を示しますが、文脈の正誤を自動判定するものではありません。
検索だけで終える場面も多い
一致箇所を調べる目的が、伏線の登場章を把握する、人物の呼び方を比べる、設定語の初出を探すことなら、置換は必要ありません。結果一覧を読み、必要な章だけを開いて修正します。
検索と置換を常にセットと考えると、原文のまま正しい箇所まで機械的に変更しやすくなります。検索は「読む場所を集める」独立した作業です。
置換へ進むなら対象リストを固定する
検索結果の一部を置換するなら、対象のファイル名と行をリストにし、除外理由も書きます。下見件数がそのリストと一致してから実行します。実行後は旧表記を逆検索し、残りが意図した除外だけかを確かめます。
ここでも、一致件数と一致ファイル数を分けて記録します。件数が合っていても、想定外のファイルに変更が入っていれば不合格です。
フォルダを絞るだけで誤置換は大きく減る
ワークスペース検索を始める前に、対象フォルダへ無関係なバックアップ、出力物、依存ファイルが混ざっていないかを確認します。たとえば三つの設定ファイルだけを直すなら、その三つを検証用フォルダへ複製し、Rune Studioで開きます。固有の検索語を入れ、三ファイル合計六件という予測と検索結果を比べれば、範囲の取り違えに気づけます。
プレビューでは件数だけでなく、各行の前後を読みます。同名のキーでもコメント、例示、実データでは置換の可否が異なるからです。適用後は旧語を再検索して0件、新語が六件になったことを確認し、さらに変更した三ファイルを開いて構文が壊れていないかを見ます。必要なら逆向きの置換を検証用コピーで試し、戻せることも確かめます。
一括操作の後に個別確認を残す
一括置換は六回の入力を一回に減らしますが、六箇所の意味確認まで省けるわけではありません。重要ファイルでは差分をレビューし、保存後に利用アプリでも読み込みます。この記事はRune Studio開発チームが三ファイル六件のプレビュー、適用、逆操作を確認してまとめました。製品ページからRune Studioをダウンロードし、最初は複製した小さなワークスペースで検索範囲を確定してください。
除外対象を先に一度検索する
バックアップや生成物を除外したつもりでも、設定漏れは起こります。本番語を探す前に、除外フォルダにだけ置いた目印を検索し、結果へ出ないことを確かめる方法があります。Rune Studioの結果一覧へ目印が現れたら、範囲設定を直してから本番検索をやり直します。検索範囲の検査と置換内容の検査を分けることで、正しい語を誤った場所へ適用する事故を防げます。
執筆者：Rune Studio開発チーム。ワークスペースの範囲・件数・プレビューの確認をまとめました。
横断検索の完了は「全件読んだ」と言えること
ワークスペース横断検索が向いているのは、複数章にまたがる固有名詞、用語、伏線を読み比べたい人です。一ファイルだけの短い修正なら、ファイル内検索のほうが範囲を誤りにくくなります。
完了条件は検索パネルに数が出たことではなく、除外を分け、対象の前後文をすべて読み、次の行動を決めたことです。Rune Studioの商品ページで現行版の検索機能を確かめ、まずchaptersとrefsの役割を一行ずつ書くことから始めてください。