差分ビューアー

English | 日本語

XeFM には 2 つの差分ビューアーが内蔵されています。2 つのテキストファイルを左右に並べて比較するファイル差分と、2 つのディレクトリツリーを再帰的に比較するディレクトリ差分です。どちらもウィンドウ全体に開き、XeFM を離れずに使えます。

ファイル差分

選択と起動

ちょうど 2 つのファイルを選択して、Select → Compare Selected Files…（選択したファイルを比較、diff_files）を選びます。2 つのファイルは同じペインにあっても、左右のペインに 1 つずつあってもかまいません。XeFM は両方のペインから選択項目を集めます。

1. ファイルにカーソルを合わせて選択します（Select → Toggle Selection）。
2. 2 つ目のファイルも同じように選択します（どちらのペインでもかまいません）。
3. Select → Compare Selected Files… を選ぶと、左右に並んだ差分が開きます。

キーはキーマッププリセットによって異なります。キーマッププリセットを参照してください。

選択に含まれるディレクトリは無視されます。ファイルがちょうど 2 つにならない場合は、XeFM がそう伝えます（Select exactly 2 files to compare）。

バイナリファイル

どちらかのファイルがバイナリ（画像、実行ファイル、アーカイブなど）の場合、比較するテキストがありません。そのときは差分ビューアーの代わりに、diff_files が 2 つのファイルを 1 バイトずつ比較し、結果をメッセージボックスで伝えます。両方のサイズに続けて、Identical（同一）、Different (sizes differ)（サイズが異なる）、または最初に異なるバイトのオフセットが表示されます。

photo.jpg   2,481,152 bytes
photo2.jpg  2,481,152 bytes

Identical

大きなファイルや、リモートサーバー上やアーカイブ内のファイルは、キャンセルできる進捗ダイアログを表示しながら比較します。

差分の読み方

左右それぞれが独自のシンタックスハイライトを保ち（Pygments がインストールされている場合）、各行には元の行番号が付きます。変更箇所は色の帯で示され、帯の色はアクティブなテーマに合わせて変わります（ダークテーマでは暗めの帯、ライトテーマではパステル調の帯）。

• 赤 — 左にだけある行（削除）。
• 緑 — 右にだけある行（挿入／追加）。
• 琥珀色 — 両側で変更された行（置換）。そうした行の中では、実際に異なる文字が同じ色相のより濃い色で示されます。
• ニュートラル／グレー — 挿入や削除の行で、空いている側を埋める詰め物です。これで左右の位置が揃います。
• 変更のない行は通常のテキスト色で表示されます。

操作

isearch と quit はファイル一覧と同じキーで、そのキーはキーマッププリセットによって異なります。ここにあるほかのキーは、どのプリセットでも同じです。

フッターには総行数、変更数、キーのヒントが表示されます。タブはテキストビューアーと同じく 8 桁ごとのタブ位置に展開されます。

ディレクトリ差分

Select → Compare Directories…（ディレクトリを比較、diff_directories）を使うと、左ペインの現在のディレクトリと右ペインの現在のディレクトリを再帰的に比較します。ファイルを選択する必要はありません。それぞれのペインで目的のディレクトリに移動して、実行するだけです。

バックアップと実際に使っているディレクトリとの比較、2 つのツリーが同期しているかの確認、アップデートや移行の後に何が変わったかの確認に便利です。

段階的なスキャン

大きなツリーでも操作が重くならないよう、ビューアーは段階的にスキャンします。

• 両方のディレクトリの最上位はすぐに表示されます。
• より深いディレクトリはバックグラウンドのワーカーがスキャンし、表示中または展開済みのディレクトリが優先されます。見ている部分から先に埋まっていきます。
• まだスキャンしていないディレクトリを展開すると、すぐにスキャンされます。
• スキャンが続いている間も、スキャン済みの部分を移動して見て回れます。フッターには進み具合と完了数が表示されます。

ツリーの読み方

両方のツリーを合わせたものが左右に並べて表示されます。ディレクトリは展開と折りたたみができ、2 つの列の間にある中央の区切り記号が、それぞれのノードの判定結果を示します。

• Only in left — その項目は左にだけあります。
• Only in right — その項目は右にだけあります。
• Content different — 両側にあり、内容が異なるファイル。
• Contains difference — 配下に違いのあるディレクトリ。
• Identical — 両側で同じ（控えめな色で表示）。
• Pending — まだスキャンまたは比較されていません。

フッターの上の行には、フォーカスのある項目の詳細が表示されます。左右それぞれのサイズと更新日時で、新しいほうの側には newer が付きます。差が 2 秒未満の日時は同じとみなされます（FAT/exFAT は日時を 2 秒単位で記録するため）。これはコピーの競合ダイアログの Overwrite older と同じ規則です。

操作

アクションの名前を書いた行（copy_files、move_files、delete_files、edit_file、quit）は、ファイル一覧でのそのアクションのキーを使うので、キーはキーマッププリセットによって異なります。キーマッププリセットを参照してください。ほかのキーは、どのプリセットでも同じです。

コピー／移動／削除のキーはメインのファイルマネージャーと同じで、同じファイル操作エンジンを通して実行されるため、2 つのツリーをその場で揃えられます。edit_file は TEXT_DIFF に設定した外部ツールを起動します（たとえばターミナルでは vimdiff、デスクトップアプリでは code --diff）。

注意事項

• 差分は Python の difflib.SequenceMatcher による行単位の比較です。
• ファイルは UTF-8 として読み込み、だめなら Latin-1、次に CP1252 にフォールバックします。先頭のバイトに NUL が含まれるファイルはバイナリとして扱います。XeFM はバイナリの拡張子の一覧を持っていません。
• edit_file はどのファイルの組み合わせでも TEXT_DIFF ツールを起動するので、バイナリを扱えるツールを明示的に使うこともできます。
• diff_files と diff_directories のキー、ディレクトリ差分の中のファイル操作キーは、どれも設定の KEY_BINDINGS で割り当て直せます。

関連項目

• テキストビューアー — 差分が再利用している単一ファイル用のビューアー
• ディレクトリ同期 — ディレクトリ差分をまとめて適用する
• ファイルの関連付け — TEXT_DIFF とビューアーの設定
• 開発者向けメモ：doc/dev/TEXT_VIEWER_SYSTEM.md