サクラエディタ アウトライン抽出・一覧の作り方：ルールファイルとタグジャンプ

先に結論：アウトラインは表示、タグジャンプは移動、テキスト出力は別操作

サクラエディタで「アウトライン一覧を抽出したい」とき、最初に決めるのは一覧を画面で使うのか、行番号付きの結果を保存するのかです。アウトライン解析は見出し・関数などをツリー表示して文書内を移動する機能です。タグジャンプはキーワードを含むタグ一覧から移動する機能で、アウトラインのツリーをそのままテキストファイルへ書き出す機能とは別です。

最初にファイル種別と解析規則を確認する

アウトラインが空のときは、いきなりルールファイルを編集せず、現在の文書に適用されているタイプ別設定を確認します。拡張子が想定と違う、種類が「テキスト」のまま、または対象言語の解析規則がない場合、ツリーに項目が出ないことがあります。まず複製した小さなファイルを開き、見出しや関数を2〜3個だけ用意して再現させます。

公式ヘルプにはファイル種別ごとのキーワード、色、アウトライン解析ルールが収録されています。解析できる構文はすべての言語で同じとは限らないため、Markdownの見出しをC++用のルールで読ませるような組み合わせは避けます。対象ファイルの拡張子、選択中のタイプ、ルールファイル名を記録しておくと、別PCで同じ表示を作りやすくなります。

1. 1. 複製ファイルを用意本番ファイルではなく、見出しや関数を少数含むコピーで確認します。
2. 2. タイプを照合拡張子とタイプ別設定が意図した言語・文書種別になっているか見ます。
3. 3. 解析表示を開くアウトラインまたはテキストトピックツリーを表示し、項目が生成されるか確認します。
4. 4. ルールを記録表示された規則名や設定先を控え、必要な場合だけカスタム規則へ進みます。

アウトライン一覧をテキスト出力したいときの考え方

「アウトライン一覧をテキスト出力」という検索では、画面のツリーをそのまま保存したいケースと、見出しや関数名を行番号付きで抜き出したいケースが混ざります。標準のアウトライン表示が自動的にMarkdownやCSVを生成するとは限らないため、必要な出力形式を先に決めます。画面から選択・コピーできる範囲、タグジャンプ一覧のコピー、マクロや外部処理による抽出は、同じ結果になりません。

アウトラインの階層を記録するだけなら、画面のスクリーンショットや項目の手動コピーで足りる場合があります。再利用する一覧が必要なら、対象記法を決めて正規表現やマクロで抽出し、元ファイルとの差分を確認します。行番号は編集後に変わるため、出力に含める場合は作成日時と対象ファイルの版も一緒に残してください。

まとめ：目的に合わせてアウトラインを使い分ける

サクラエディタのアウトライン抽出は、見出しや関数をツリーで見渡し、元の文書へ移動するための機能です。表示を作る前にファイル種別と解析規則をそろえ、必要な場合だけルールファイルを小さく調整します。タグジャンプ一覧はキーワードから移動する別の機能で、アウトラインをそのままテキストへ書き出す処理とは分けて考えます。

保存できる一覧や定期レポートが必要なら、出力形式、行番号の扱い、文字コード、対象ファイルの版を決めてからコピー・マクロ・外部処理を選びます。標準表示を確認し、複製ファイルでテストし、差分を読んでから本番の設定や文書へ反映してください。