synchronizer.docbook

LINUX 下, 以 QT/KDE 写的档案管理员

<sect1 id="synchronizer">
  <title>Synchronizer</title>
  <indexterm>
    <primary>Synchronizer</primary>
  </indexterm>
  
<sect2 id="synchronizer_introduction">
  <title>Introduction</title>    
  <para>This function compares two directories with all subdirectories and shows the differences between them.
  After selecting some options and the 
  <guilabel>Compare</guilabel> function you can synchronize the
  files and directories. One panel could be an &FTP;
  server. Do not forget the 
  <guilabel>Compare by content</guilabel> option if the file size
  stays equal. Choose 
  <emphasis role="bold">
    <menuchoice>
      <guimenu>Commands</guimenu>
      <guimenuitem>Synchronize Directories</guimenuitem>
    </menuchoice>
  </emphasis>or 
  <keycombo action="simul">&Ctrl;
  <keycap>Y</keycap></keycombo> to start this feature. The 
  <link linkend="konfig-color">colors</link> are
  configurable.</para>
  <note>
    <para>For local files: The synchronizer changes the date
    information to the original dates.</para>
  </note>
  <!-- OLD
<screenshot>
  <screeninfo>Synchronizer</screeninfo>
  <mediaobject>
  <imageobject><imagedata fileref="syncdir.png" format="PNG"/></imageobject>
  <imageobject><imagedata fileref="syncdir.png" format="EPS"/></imageobject>
  <textobject><phrase>Synchronizer: Synchronize files and directories.</phrase></textobject>
  <caption><para>Synchronizer: Synchronize files and directories.</para></caption>
  </mediaobject>
</screenshot>
-->
  <figure id="screenshot-syncdir" float="1">
    <title>Synchronizer</title>
    <mediaobject>
      <imageobject>
        <imagedata fileref="syncdir.png"></imagedata>
      </imageobject>
      <textobject>
        <phrase>Synchronizer</phrase>
      </textobject>
    </mediaobject>
  </figure>
  <para>
  <orderedlist>
    <title>Procedure:</title>
    <listitem>
      <para>Set the 
      <guilabel>Left directory</guilabel> and the 
      <guilabel>Right directory</guilabel> that you want to compare.</para>
    </listitem>
    <listitem>
      <para>Configure the optional 
      <guilabel>File Filter</guilabel>, 
      <guilabel>General Filters</guilabel> and 
      <guilabel>Advanced filters</guilabel>. The 
      <guilabel>General Filters</guilabel> includes a 
      <guilabel>don't search in</guilabel> option which lets you
      exclude directories from comparision.</para>
    </listitem>
    <listitem>
      <para>Set the 
      <link linkend="synccomp_checkb_options">Checkbox
      options</link>: 
      <guilabel>Recurse subdirectories</guilabel>, 
      <guilabel>Follow symlinks</guilabel>, 
      <guilabel>Compare by content</guilabel>, 
      <guilabel>Ignore Date</guilabel>, 
      <guilabel>Asymmetric</guilabel>,  
      <guilabel>Ignore Case</guilabel> and
      <guilabel>Hidden hidden files</guilabel>.
      </para>
    </listitem>
    <listitem>
      <para>Click on the 
      <guibutton>Compare</guibutton> button to compare the
      directories.</para>
    </listitem>
    <listitem>
      <para>By using
      <link linkend="synccomp_show_options">Show options</link>,
      you can include/exclude particular file types. The files that
      are not on the list will be untouched by
      synchronization.</para>
    </listitem>
    <listitem>
      <para>If needed, you can change the 
      <guilabel>Task</guilabel> operations determined by the
      Comparator with the 
      <link linkend="synccomp_right-click">right click
      menu</link>.</para>
    </listitem>
    <listitem>
      <para>When you agree with the 
      <guibutton>Compare</guibutton> results, click on the 
      <guibutton>Synchronize</guibutton> button to show the
      synchronize dialog.</para>
    </listitem>
    <listitem>
      <para>After selecting the options of the 
      <link linkend="synchronizer">Synchronizer</link>, click on
      the 
      <guibutton>Start</guibutton> button to start the
      synchronization process.</para>
    </listitem>
  </orderedlist>A detailed explanation of all the functions and
  buttons is described in the following text.</para>

</sect2>

<sect2 id="synchronizer_comparator">
  <title>Comparator</title>  

  <variablelist>
    <varlistentry>
      <term>Panel elements</term>
      <listitem>
        <itemizedlist>
          <listitem>
            <para>
            <guilabel>Left Directory</guilabel>: The left side base
            directory.</para>
          </listitem>
          <listitem>
            <para>
            <guilabel>Right Directory</guilabel>: The right side
            base directory.</para>
          </listitem>
          <listitem>
            <para>
            <guilabel>File Filter</guilabel>: Filters the filenames
            at synchronizing. &eg; 
            <literal role="extension">*.png</literal> selects only
            files the names of which end with 
            <literal role="extension">.png</literal> Directories are
            listed if the directory name ends with 
            <literal role="extension">.png</literal> or if the
            directory contains files which end with 
            <literal role="extension">.png</literal> Multiple
            include/exclude example: 
            <literal role="extension">'*.cpp *.h |
            *.moc.cpp'</literal>includes 
            <literal role="extension">*.cpp *.h</literal> and
            exclude 
            <literal role="extension">*.moc.cpp</literal></para>
          </listitem>
          <listitem>
            <para>
            <guilabel>General filters</guilabel>: Search for,
            containing text</para>
          </listitem>
          <listitem>
            <para>
            <guilabel>Advanced filters</guilabel>: Size, date,
            ownership</para>
          </listitem>
        </itemizedlist>
      </listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <varlistentry>
      <term>Filename filtering criteria</term>
      <listitem>
        <itemizedlist>
          <listitem>
            <para>You can make use of wild cards. Multiple patterns
            are separated by space (means logical OR) and patterns
            are excluded from the search using the pipe symbol. If
            the pattern is ended with a slash (*pattern*/), it
            means that pattern relates to recursive search of
            directories.</para>
          </listitem>
          <listitem>
            <para>pattern - means to search those files/directories
            whose name is a pattern, recursive search goes through
            all subdirectories independently of the value of the
            pattern.</para>
          </listitem>
          <listitem>
            <para>pattern/ - means to search all files/directories,
            but recursive search goes through/excludes the
            directories whose name is a pattern.</para>
          </listitem>
          <listitem>
            <para>You can use quotation marks for names
            that contain spaces. Filter "Program Files" searches
            out those files/directories the name of which is <filename>Program
            Files</filename>.</para>
          </listitem>
          <listitem>
            <para>Examples:</para>
          </listitem>
          <listitem>
            <para>
              <literal role="extension">*.o</literal>
            </para>
          </listitem>
          <listitem>
            <para>
              <literal role="extension">*.h *.c??</literal>
            </para>
          </listitem>
          <listitem>
            <para>
              <literal role="extension">*.cpp *.h |
              *.moc.cpp</literal>
            </para>
          </listitem>
          <listitem>
            <para>
              <literal role="extension">* | CVS/ .svn/</literal>
            </para>
          </listitem>
          <listitem>
            <para>Note: the search term 'text' is equivalent to
            '*text*'.</para>
          </listitem>
        </itemizedlist>
      </listitem>
    </varlistentry>
    <varlistentry id="synccomp_checkb_options">
      <term>Checkbox options</term>
      <listitem>
        <itemizedlist>
          <listitem>
            <para>
            <guilabel>Recurse subdirectories</guilabel>: The
            Synchronizer walks through subdirectories when
            comparing.</para>
          </listitem>
          <listitem>
            <para>
            <guilabel>Follow symlinks</guilabel>: The Synchronizer
            follows the symbolic links to directories (not the
            files!).</para>
          </listitem>
          <listitem>
            <para>
            <guilabel>Compare by content</guilabel>: The files
            the sizes of which are equal will be compared by content as
            well.</para>
          </listitem>
          <listitem>
            <para>
            <guilabel>Ignore Date</guilabel>: Ignores the date
            information (useful for &FTP;, smb, archive,
            ... ) the date information is relevant *only* in the
            local file system.</para>
          </listitem>
          <listitem>
            <para>
            <guilabel>Asymmetric</guilabel>: The 
            <guilabel>Left Directory</guilabel> is the target
            directory, the 
            <guilabel>Right Directory</guilabel> is the source
            directory. This functions synchronizes the content of
            the left directory to the right directory. 
            <itemizedlist>
              <listitem>
                <para>The files that exist only on the left side
                will be deleted.</para>
              </listitem>
              <listitem>
                <para>The files that exist only on the right side
                will be copied to left.</para>
              </listitem>
              <listitem>
                <para>The files considered to be equal will be
                untouched.</para>
              </listitem>
              <listitem>
                <para>Those files considered to be different will
                be copied to left. Use this feature with
                care!</para>
              </listitem>
            </itemizedlist>This function is useful if the date
            information is unusable, or to synchronize the left
            directory to the content of a file server (like a
            download). Alternatively, it is useful to make a backup
            from the right directory to the left directory. NOTE:
            Do NOT use this option to synchronize a desktop and a
            notebook (&eg; files that exist only on the
            left side will be deleted!).</para>
          </listitem>
          <listitem>
            <para>
            <guilabel>Automatic Scrolling</guilabel>: This is for
            slow &FTP; servers, ... When the
            Synchronizer has finished comparing a file, it puts the
            file into the end of the list at once and scrolls the
            window, if necessary. It is important, if you want to
            know what the Synchronizer is doing. If the
            &FTP; server is slow, the comparison of a
            directory may take a lot of time. By turning this
            option on, you can see that the comparator is "alive",
            but slow. For fast file systems, it can reduce the
            speed of comparing slightly.</para>
          </listitem>
          <listitem>
            <para>
            <guilabel>Ignore Case</guilabel>: Case insensitive filename compare, 
            this is useful when synchronizing &Windows; filesystems.</para>
          </listitem>
          <listitem>
            <para>
            <guilabel>Ignore hidden files</guilabel>: Ignores files that start with a dot.</para>
          </listitem>
        </itemizedlist>
      </listitem>
    </varlistentry>
  </variablelist>
  <para>When everything mentioned above is done, click on the 
  <guibutton>Compare</guibutton> button to compare the directories,
  the results are displayed in the <guilabel>File List</guilabel>.</para>
  <variablelist>
    <varlistentry>
      <term>File List</term>
      <listitem>
        <para>The 
        <guilabel>File List</guilabel> has the following columns:
        "Left name | Left size | Left time | Task | Right time |
        Right size | Right name".
        Here you can check the compare results and modify the synchronisation actions if desired.
        The text color defines the default copy direction determined by the comparator.
        <itemizedlist>
              <listitem>
                <para>Green: Copy from left to right.</para>
              </listitem>
              <listitem>
                <para>Blue: Copy from right to left or delete on the right side in asymmetric mode.</para>
              </listitem>
              <listitem>
                <para>Red: Files which are different by the given criteria (no copy direction).</para>
              </listitem>
              <listitem>
                <para>Black: Files which are identical (no copy direction).</para>
              </listitem>
            </itemizedlist>
            A double click on a file calls the &krusader;s <guilabel>Compare by content</guilabel> function.
            The Tasks (&lt;=&gt;) column defines the default copy direction, which can be modified by the user if needed.
            The results window supports dragging items to other windows ( drag [left], SHIFT+drag [right] )
            and copy left/right selected items to clipboard (<keycombo action="simul">&Ctrl;<keycap>c</keycap></keycombo>).
        </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term><guilabel>File List</guilabel>: Tasks (&lt;=&gt;) column</term>
      <listitem>
        <para>This column displays the task that is planned for the
        Synchronizer, this task can be modified with the 
        <link linkend="synccomp_right-click">right click menu</link>.</para>
        <itemizedlist>
          <listitem>
            <para>
            <guibutton>-&gt;</guibutton>: Copy from the
            left side to the right side. For directories: 
            <command>mkdir</command> in the right side.</para>