<?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>

    <orderedlist>
      <listitem>
        <para>WinMergeのウィンドウを開いてください。
          ここに、あなたが使用できる、いくつかの方法があります:
          <indexterm>
            <primary>WinMerge window</primary>
          </indexterm>
        </para>

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

          <listitem>
            <para>スタートメニューにあるWinMergeのランチャから操作してください。</para>
          </listitem>

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

      <listitem>
        <para>WinMergeのウィンドウ内で、あなたが操作したいファイル、または、フォルダを選択してください。例えば</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>

        <para>
          <indexterm>
            <primary>ファイルまたはフォルダの選択ダイアログ</primary>
            <secondary>さあ、はじめよう</secondary>
          </indexterm>
          ファイルまたはフォルダ選択ダイアログを開く
        </para>

        <mediaobject>
          <imageobject>
            <imagedata fileref="screenshots/OpenDlg1.png" format="PNG" />
          </imageobject>

          <textobject>
            <phrase>ファイルまたはフォルダ選択画面</phrase>
          </textobject>
        </mediaobject>
      </listitem>

      <listitem>
        <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>
            </listitem>

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

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

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

      <listitem>
        <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>

        <!--
        <variablelist>
          <varlistentry>
            <term>File masks</term>

            <listitem>
              <para>In this method, you specify the types of files to include in
                the operation; all other files are excluded (filtered). With no
                file mask or the default mask of <literal>*.*</literal>, all files
                in the paths are included, so no filtering is performed. To add
                filtering, enter one or more masks. Separate multiple masks with
                spaces, commas, colons or semicolons.</para>

              <para>For example, this expression filters all files from the
                operation except C and C++ source files:</para>

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

              <para>File names cannot be filtered: they are represented in the
                masks only by the <literal>*</literal> wildcard character. For
                example, these expressions are not valid masks:</para>

              <para><userinput>mybook.xml</userinput></para>

              <para><userinput>yourbook.*</userinput></para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>File filtering</term>

            <listitem>
              <para>File filtering is more powerful than extension filtering.
                Click the <guibutton>Select</guibutton> button next to the
                <guilabel>Filters</guilabel> field to choose from a list of
                available filters. </para>
            </listitem>
          </varlistentry>
        </variablelist>
        -->
      </listitem>

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

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

    <section>
      <title>ファイルとフォルダを開く他の方法<indexterm>
          <primary>project files</primary>
        </indexterm><indexterm>
          <primary>command line</primary>

          <secondary>opening files and folders</secondary>
        </indexterm></title>

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

      <itemizedlist>
        <listitem>
          <para><xref linkend="OpenPaths_project" />は、よく使うパスを、もっとも簡単かつ高速に開く方法です。
            これらの方法のうちのどれかで、プロジェクトファイルを開いてください。
          </para>

          <itemizedlist>
            <listitem>
              <para>WinMergeのウィンドウの、<menuchoice>
                  <guimenuitem>ファイル(F)</guimenuitem>

                  <guimenuitem>プロジェクトを開く(J)</guimenuitem>
                </menuchoice>とクリックしてください。</para>
            </listitem>

            <listitem>
              <para>コマンドラインから。</para>
            </listitem>

            <listitem>
            <para>「ファイルまたはフォルダの選択」ダイアログから、プロジェクトファイルを、
              <guilabel>左(1)</guilabel>フィールドに指定してください。</para>

              <note>
                <para>プロジェクトファイルを
                <guilabel>左(1)</guilabel>と<guilabel>右(2)</guilabel>フィールドの両方に指定した場合、
                WinMergeは、どちらのプロジェクトファイルも開きません。(単に2つのXMLファイルの中身を比較します)
                </para>
              </note>
            </listitem>
          </itemizedlist>
        </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>

