<?xml version="1.0" encoding="UTF-8"?>
<article id="Quick_start">
  <title>クイックスタート</title>

  <section>
    <title><indexterm>
        <primary>WinMergeを始めよう</primary>
      </indexterm><indexterm>
        <primary>ファイルとフォルダーの選択</primary>

        <secondary>はじめる</secondary>
      </indexterm>比較するファイルとフォルダーの選択</title>

    <para>WinMergeをインストールしたら、このトピックで基本操作と概念を学んでください。操作方法はいくつかあり、同じ作業でも複数の方法で実行できます。基本を理解した後は、他のトピックで応用や高度な使い方を学べます。</para>

    <section>
      <title><indexterm><primary>WinMergeウィンドウ</primary></indexterm>WinMerge ウィンドウの起動</title>

      <para>いくつかの方法をご紹介します:</para>

      <itemizedlist>
        <listitem>
          <para>デスクトップにあるWinMergeのショートカットをダブルクリックします。</para>
        </listitem>

        <listitem>
          <para>スタートメニューにあるWinMergeのランチャーから操作します。</para>
        </listitem>

        <listitem>
          <para>コマンドプロンプトで、WinMergeをインストールしたディレクトリへ移動し、 <command>WinMergeU</command>と入力します。</para>
        </listitem>

        <listitem>
          <para><keycombo><keycap>Windows</keycap><keycap>R</keycap></keycombo>キーを押下し、<command>winmerge</command>と入力します。</para>
        </listitem>
      </itemizedlist>
    </section>

    <section>
      <title><guilabel>ファイルまたはフォルダーの選択</guilabel> ダイアログを開く</title>

      <para>WinMergeウィンドウにて以下の方法で、<guilabel>ファイルまたはフォルダーの選択</guilabel> ダイアログを開きます:</para>

      <itemizedlist>
        <listitem>
          <para><menuchoice><guimenu>ファイル(F)</guimenu><guimenuitem>開く(O)</guimenuitem></menuchoice>をクリックします。</para>
        </listitem>

        <listitem>
          <para>ツールバーの開くボタン <inlinemediaobject>
<imageobject> <imagedata contentwidth="16"
fileref="screenshots/open_icon.png" /> </imageobject><textobject><phrase>WinMerge の「開く」ボタン</phrase></textobject>
            </inlinemediaobject> をクリックします。</para>
        </listitem>

        <listitem>
          <para><keycombo><keycap>Ctrl</keycap><keycap>O</keycap></keycombo>を押下します。</para>
        </listitem>
      </itemizedlist>
    </section>

    <section>
      <title><indexterm><primary>ファイルまたはフォルダーの選択ダイアログ</primary></indexterm> <guilabel>ファイルまたはフォルダーの選択</guilabel>
ダイアログ</title>

      <para>
<mediaobject>
<imageobject> <imagedata fileref="screenshots/OpenDlg1.png" format="PNG" />
</imageobject><textobject>
            <phrase>ファイルまたはフォルダー選択画面</phrase>
          </textobject>
        </mediaobject></para>

      <section>
        <title>ファイルとフォルダーの指定</title>

        <para><guilabel>1番目</guilabel>と<guilabel>2番目</guilabel>
のフィールドに、次のいくつかの方法で、比較するファイルやフォルダーを指定してください。</para>

        <para><itemizedlist>
            <listitem>
              <para>このフィールドに、直接、パスを入力してください。</para>
            </listitem>

            <listitem>
              <para><guibutton>参照</guibutton>ボタンをクリックし、望みのパスを ナビゲートしてください。</para>

              <para>開くダイアログの中の、<guilabel>開く(M)</guilabel>フィールドの 初期状態は、<literal>Folder
Selection.</literal>と表示されています。 あなたがどれを選択するかは、比較したい形式によります。</para>

              <itemizedlist>
                <listitem>
                  <para>ファイルを比較するなら、目的のファイルを選択してください。 <literal>Folder
Selection</literal>という文字が、選択したファイル名で上書きされます。</para>
                </listitem>

                <listitem>
                  <para>フォルダーを比較するなら、(ファイルを選択せずに)目的のフォルダーを開いてください。 <literal>Folder
Selection</literal>という文字は、きちんと残ったままになります。</para>
                </listitem>
              </itemizedlist>

              <para><guibutton>開く</guibutton>ボタンをクリックして、開くダイアログを閉じ、
選択した項目を<guilabel>1番目</guilabel>、または、<guilabel>2番目</guilabel>フィールドに読み込んでください。
もし、フォルダーを選択したなら、パスの最後にバックスラッシュ ( \ )を含んでいます。</para>
            </listitem>

            <listitem>
              <para>コンボボックスをクリックして、以前使用したパスを選択してください。</para>

              <tip>
                <para>よく使うパスを、より簡単に選択するには、<guilabel>開くダイアログのオートコンプリート(O)</guilabel>
オプションを有効にすることを考慮に入れてください。
このオプションにより、WinMergeは、あなたがこのフィールドに入力する時に、有効なパスの一覧を表示します。 詳しくは、<xref
linkend="Configuration" />を参照してください。</para>
              </tip>
              <para></para>
            </listitem>

            <listitem>
              <para>ファイル、フォルダーをダイアログ、または、<guilabel>1番目</guilabel>、
または、<guilabel>2番目</guilabel>のフィールドへドラッグ・アンド・ドロップしてください。</para>
            </listitem>
          </itemizedlist></para>

        <para><note><para>あなたは、一組のファイル、または、フォルダーを比較することができます。
もし、ファイルとフォルダーを選択するか、または、ファイルやフォルダーが存在しない場合、
WinMergeは、ダイアログの<guibutton>比較</guibutton>ボタンを使用不可にします。</para>

            <para>ダイアログ下部のステータス・メッセージでも、 もし、パスが不正な場合は、通知します。</para>
</note></para>
      </section>

      <section>
        <title>フォルダー比較範囲の制御</title>

        <para>もし、フォルダーを比較しているなら、その操作からファイルを除外するために、
<guilabel>フィルター</guilabel>フィールドを使用することができます。
そのフィールドには、選択されたパスの中にあるファイルの一部を指定します。 すべての明示していないファイルは、除外されます。</para>

        <para>ファイルをフィルターするための、ファイル・マスクを入力することができます。
例えば、この式は、CとC++のソースファイルだけを含みます(他のすべてのファイル形式は除外されます)。</para>

        <para><filename><userinput>*.cpp;*.hpp;*.c;*.h</userinput></filename></para>

        <para>より強固なフィルタリングのため、ファイルマスクの代わりに、フィルターファイルを入力してください。
<guilabel>フィルター(F)</guilabel>フィールドの次にある、<guibutton>選択</guibutton>ボタンをクリックして、
有効なフィルターの中から選択してください。 ファイルフィルターは、いくつかの含めるか、除外するかのルールから成ります。
WinMergeは、フィルターファイルのセットをインストールします。 それらは、編集、または、強化することができます。</para>

        <para>ファイル・マスクとファイル・フィルターについての、完全な詳細は、<xref linkend="Filters" /> を参照してください。</para>

        <para><guilabel>サブフォルダーを含む(I)</guilabel>チェックボックスは、 フォルダー比較の範囲を制御する、もう一つの方法です。
このオプションをチェックすると、WinMergeは、サブフォルダーを再帰的に比較し、すべてのファイルとフォルダーを一覧表示します。
このオプションを無効にした場合は、カレントフォルダーのみが比較されます。
サブフォルダーは名前で一覧表示(フォルダーの中身は除く)され、フォルダーの中を閲覧することができます。</para>
      </section>

      <section>
        <title>展開プラグインの使用</title>
        <para>展開プラグイン(U)フィールドは、プラグインを使用した比較操作を可能にします。</para>
      </section>
    </section>

    <section>
      <title>ファイルとフォルダーを開く他の方法<indexterm>
          <primary>プロジェクトファイル</primary>
        </indexterm><indexterm>
          <primary>コマンドライン</primary>

          <secondary>ファイルとフォルダーを開く</secondary>
        </indexterm></title>

      <para><guilabel>ファイルまたはフォルダーの選択</guilabel>ダイアログは、ファイルやフォルダーを開くための主要なインターフェイスです。
しかし、他の多くの方法も使用することができます。</para>

      <itemizedlist>
        <listitem>
          <simpara><xref linkend="OpenPaths_project" />は、よく使うパスを、もっとも簡単かつ高速に開く方法です。</simpara>
        </listitem>

        <listitem>
          <simpara><xref linkend="OpenPaths_shell-integ" />。</simpara>
        </listitem>

        <listitem>
          <simpara><xref linkend="Command_line" />インターフェイスを使用して、
他のアプリケーション、コマンド・プロンプト、バッチ、または、スクリプトファイルから WinMergeを起動してください。</simpara>
        </listitem>

        <listitem>
          <simpara>ファイルやフォルダーを、WinMergeのウィンドウかデスクトップのショートカットへ直接、ドラッグ・アンド・ドロップしてください。</simpara>
        </listitem>
      </itemizedlist>
    </section>
  </section>

  <section>
    <title><indexterm>
        <primary>フォルダーの比較</primary>

        <secondary>はじめる</secondary>
      </indexterm><indexterm>
        <primary>フォルダー比較ウィンドウ</primary>

        <secondary>はじめる</secondary>
      </indexterm>フォルダーの比較</title>

    <para>もし、開くダイアログで、2つのフォルダーを選択したなら、フォルダー比較ウィンドウが開かれます。フォルダー比較ウィンドウは、比較対象フォルダー中で見つかった項目の表です。それぞれの行は、見つかったファイルについて、左の列にファイル名、その他の列に付加的な情報を表示します。</para>

    <mediaobject>
<imageobject> <imagedata contentwidth="600"
fileref="screenshots/foldercomp1.png" format="PNG" /> </imageobject><textobject>
        <phrase>フォルダー比較ウィンドウ</phrase>
      </textobject>
    </mediaobject>

    <para>WinMergeは、<wordasword>変更元</wordasword>と<wordasword>変更後</wordasword>
という概念を持っていません。 代わりに、選択された二つのフォルダー間の差異を、単に表示します。
一方でしか見つからなかったファイル、または、フォルダーは、単に見つかった方にのみ存在する項目として表示されます。
例えば、上の図の<guilabel>比較結果(Comparison Result)</guilabel>カラムにある、
<filename>Merge.aps</filename>と<filename>Merge.rc.bak</filename>は、
どちらも比較されたフォルダーの一方でしか見つかりませんでした。</para>

    <para><guimenu>マージ(M)</guimenu>メニュー、ツールバーボタン、または、コンテキスト(右クリック)メニューなど、
多くの方法で、ファイルとフォルダーを管理できます。 最も重要な操作は、コピー操作を使って、左右のファイルまたはフォルダーを同一にすることです。
ファイル、または、フォルダーを他方へコピーした時、比較結果は、<literal>同一</literal>に変わります。</para>

    <para>もし、ファイル、または、フォルダーが、左右両方に存在した(かつ、バイナリファイルでない)場合、
これらのうち一つの方法で、比較するために、ファイルを開くことができます。<itemizedlist>
        <listitem>
          <simpara>WinMergeメニューから、<menuchoice> <guimenuitem>マージ(M)</guimenuitem>
<guimenuitem>比較(M)</guimenuitem> </menuchoice>をクリックする。</simpara>
        </listitem>

        <listitem>
          <simpara>行を右クリックして、<guimenuitem>比較</guimenuitem>ショートカットを選択してください。</simpara>
        </listitem>

        <listitem>
          <simpara>行をダブルクリックする。</simpara>
        </listitem>

        <listitem>
          <simpara>行を選択し、<keycap>Enter</keycap>を入力してください。</simpara>
        </listitem>
      </itemizedlist>サブフォルダーを比較する場合、新しいフォルダー比較テーブルが、 現在のフォルダー比較ウィンドウ内に読み込まれます。
フォルダー比較を完了したら、ファイル名列の一番上の上矢印ボタン <inlinemediaobject>
<imageobject> <imagedata contentwidth="23"
fileref="screenshots/nav_uparrow_btn.png" /> </imageobject><textobject>
          <phrase>ナビゲータの上矢印ボタン</phrase>
        </textobject>
      </inlinemediaobject>をダブルクリックし、親フォルダーに戻ることができます。</para>

    <para>ファイルを比較する場合、WinMergeは、次のセクションで説明される、ファイル比較ウィンドウを開きます。ファイル比較ウィンドウ内で、ファイルを変更するなら、フォルダー比較ウィンドウに戻った時、ファイルのデータが更新されていることを確認できるでしょう。</para>
  </section>

  <section id="QuickStart_comparingfiles">
    <title><indexterm>
        <primary>ファイルの比較</primary>

        <secondary>はじめる</secondary>
      </indexterm><indexterm>
        <primary>ファイル比較ウィンドウ</primary>

        <secondary>はじめる</secondary>
      </indexterm>ファイルの比較</title>

    <mediaobject>
<imageobject> <imagedata contentwidth="600"
fileref="screenshots/filecomp1.png" format="PNG" /> </imageobject><textobject>
        <phrase>ファイル比較ウィンドウ</phrase>
      </textobject>
    </mediaobject>

    <para>ファイル比較ウィンドウは、分割されたファイルペインに、二つの選択されたファイルをとなり同士に表示します。 異なる行は、背景色がハイライト表示されます。
ひとつ、または、連続した異なる行は、ひとつの差異(<glossterm>diff</glossterm>)として表されます。
例では、ファイルペインで1つの差異が選択され、Diff
ペインにその差異のみが表示されています。WinMergeは主に個々の行ではなく、このような差異単位で動作します。
差異をマージすると、その差異のすべての行を他方にコピーします。</para>

    <para><important>
        <para>同じ行が、いつも隣同士に並べられるように、WinMergeが、どのように無くなった行を埋めるかに、
注意してください。これは、他のほとんどの、比較/マージプログラムと異なり、学ぶためにしばらく時間がかかります。</para>
      </important></para>

    <para>WinMergeは、テキストの基本的な入力、コピー、カット・アンド・ペースト機能を持った、シンプルな実装のエディターを備えています。 もし、
<guilabel>自動再スキャン</guilabel>が有効なら、WinMergeは、あなたがファイルを編集している間、ファイルの差異を更新します。
もし、<guilabel>自動再スキャン</guilabel>が無効なら、手動でファイルを更新できます。<menuchoice>
<guimenu>表示(V)</guimenu> <guimenuitem>最新の情報に更新(S)</guimenuitem>
</menuchoice>をクリックしてください。<inlinemediaobject>
<imageobject> <imagedata contentwidth="16"
fileref="screenshots/refresh_btn.png" /> </imageobject><textobject>
          <phrase>表示更新ボタン</phrase>
        </textobject>
      </inlinemediaobject>をクリックするか、 <keycap>F5</keycap>を押してください。</para>
  </section>
</article>
