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

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

        <secondary>getting started</secondary>
      </indexterm>比較するファイルとフォルダの選択</title>

    <para>WinMergeをインストールしたら、トピック中の手順と議論を通じて、
      基本的なWinMergeの操作と概念を学んでください。
      その方法は、一つではありません。各タスクを実行するには、通常いくつの方法があります。
      これが完了したら、他のヘルプトピックでカバーされる他の方法やより高度なスキルを学ぶことができます。
    </para>

    <section>
      <title><indexterm><primary>WinMerge window</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 open button</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>project files</primary>
        </indexterm><indexterm>
          <primary>command line</primary>

          <secondary>opening files and folders</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>getting started</secondary>
      </indexterm><indexterm>
        <primary>Folder Compare window</primary>

        <secondary>getting started</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>メニュー、ツールバーボタン、または、コンテキスト(右クリック)メニューなど、
    多くの方法で、ファイルとフォルダを管理できます。
    The most important action is making files or folders identical in both
    sides by selecting one of several Copy items.
    <!-- FIXME
    もっとも重要なアクションは、ファイル、または、フォルダの作成...
    -->
    ファイル、または、フォルダを他方へコピーした時、比較結果は、<literal>同一</literal>に変わります。
    </para>

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

              <guimenuitem>比較(M)</guimenuitem>
            </menuchoice>をクリックする。</simpara>
        </listitem>

        <listitem>
          <simpara>行を右クリックし、
          <guimenuitem>比較(A)</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>Navigator up arrow button</phrase>
        </textobject>
      </inlinemediaobject>をダブルクリックし、親フォルダに戻ることができます。</para>

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

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

        <secondary>getting started</secondary>
      </indexterm><indexterm>
        <primary>File Compare window</primary>

        <secondary>getting started</secondary>
      </indexterm>ファイルの比較</title>

    <mediaobject>
      <imageobject>
        <imagedata contentwidth="600" fileref="screenshots/filecomp1.png"
                   format="PNG" />
      </imageobject>

      <textobject>
        <phrase>ファイル比較ウィンドウ</phrase>
      </textobject>
    </mediaobject>

    <para>ファイル比較ウィンドウは、分割されたファイルペインに、二つの選択されたファイルをとなり同士に表示します。
    異なる行は、背景色がハイライト表示されます。
    ひとつ、または、連続した異なる行は、ひとつの差異(<glossterm>diff</glossterm>)として表されます。
    In the preceding example, a single difference is selected in the File panes and displayed by itself in the Diff Pane.
    WinMerge mainly works with these differences, not separate lines.
    <!-- FIXME 意味不
    前の例において、単一の差異は、ファイルペインで選択されており、Diffペインに単独で表示されます。
    WinMergeは主に、個別の行でなく、これらの差異で効果的です。
    -->    
    差異をマージすると、その差異のすべての行を他方にコピーします。
    </para>

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

    <para>WinMergeは、テキストの基本的な入力、コピー、カット・アンド・ペースト機能を持った、シンプルな実装のエディタを備えています。
    もし、 <guilabel>自動再スキャン</guilabel>が有効なら、WinMergeは、あなたがファイルを編集している間、ファイルの差異を更新します。
    もし、<guilabel>自動再スキャン</guilabel>が無効なら、手動でファイルを更新できます。<menuchoice>
        <!-- NOTE: 誤り？ -->
        <!--<guimenu>編集(E)</guimenu>-->
        <!--<guimenuitem>更新</guimenuitem>-->
        <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>
