installation.docbook

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

    to compile &kde;. With &fink-url; it is
    rather easy but it takes some CPU cycles.</para>
    <para>Installation Instructions for &krusader;-1.40 
    <orderedlist>
      <listitem>
        <para>Download and install &fink-url; with the
        &kde;3.1 binaries provided by fink and read the
        documentation.</para>
      </listitem>
      <listitem>
        <para>Extract the 
        <filename>
        krusader-1.40.fink.darwin-ppc.tar.bz2</filename> package to 
        <filename>/sw/fink/dist/local/main/</filename> Only root can
        write here. You may have to create 'local' and
        'main'.</para>
      </listitem>
      <listitem>
        <para>Run as root: 
        <command>fink install krusader</command></para>
      </listitem>
    </orderedlist></para>
    <para>Follow these instructions if you wish to compile more
    source code or use a more recent version of
    &krusader;: 
    <orderedlist>
      <listitem>
        <para>Install &apple-x11-url;</para>
      </listitem>
      <listitem>
        <para>Install the &apple-x11-sdk-url;
        developer-tools with X11 headers (gcc is included)</para>
      </listitem>
      <listitem>
        <para>Install the fink-base</para>
      </listitem>
      <listitem>
        <para>Compile kdelibs 3.4.1 or higher (fink provides the
        necessary 
        <filename>.info</filename> files)</para>
      </listitem>
      <listitem>
        <para>Compile the &krusader;-tarball or follow
        steps 2 and 3 of the previous section if a recent
        &krusader;-package &eg; 
        <filename>
        krusader-1.70.0.fink.darwin-ppc.tar.bz2</filename> is
        available</para>
      </listitem>
    </orderedlist></para>

<para>Follow these instructions if you wish to compile &krusader;-1.80.0 : 
    <orderedlist>
      <listitem>
        <para>Install &apple-x11-url;</para>
      </listitem>
      <listitem>
        <para>nstall fink and 
        <ulink url="http://fink.sourceforge.net/faq/usage-fink.php#unstable">enable fink unstable</ulink>.</para>
      </listitem>
      <listitem>
        <para>Compile and install the &kde; bundle in fink: fink install bundle-kde-ssl 
             (if you get “no package found” the previous step did not succeed).</para>
      </listitem>
      <listitem>
        <para>Use <filename>krusader.info</filename> (provided in the &krusader;-sourcecode) and then copy to 
        <filename>/sw/fink/dists/local/main/finkinfo</filename> .</para>
      </listitem>
      <listitem>
        <para>Compile and install &krusader; in fink: <command>fink install krusader</command>
        </para>
      </listitem>
      <listitem>
        <para>Start X11 (startx) and in xterm run &krusader;
        </para>
      </listitem>
    </orderedlist>
    Thanks to <ulink url="http://hritcu.wordpress.com/2006/08/10/krusader-on-intel-mac/">Catalin Hritcu </ulink> for these install instructions.
</para>


  </sect1>
  <sect1 id="starting-krusader">
    <title>Starting &krusader;</title>
    <para>Type 
    <userinput>
      <command>krusader</command>
    </userinput> (lower case) at a command prompt. You can create
    shortcut on your desktop or create an entry in the
    (&kde;) menu. Read the previous page and the
    &faq-lnk; if &krusader; doesn't
    start.</para>
    <para>When &krusader; is started from the
    command line, various options can be specified to modify its
    behavior.</para>
    <screen>
    	<prompt>$</prompt> <userinput><command>krusader</command></userinput>
    	WARNING: Mt.Man: Born, looking around to get familiar. foo</screen>
    <note>
      <para>Do not worry about the messages you get in the
      &konsole;. These messages are log messages that
      can be used for debugging &krusader;.</para>
    </note>
    <para>You can also use 
    <keycombo action="simul">&Alt;
    <keycap>F2</keycap></keycombo> to open the Run Command dialog
    box, type 
    <userinput>
      <command>krusader</command>
    </userinput> (lower case) and press &Enter; or click
    on the 
    <guibutton>Run</guibutton> button.</para>
    <para>If &krusader; is installed by an RPM or DEB
    package then usually &krusader; can be started from
    the &kmenu;. &eg; on
    &Mandrake;-&Linux; 10.0 click on the
    &kicon; button and choose 
    <emphasis role="bold">
      <menuchoice>
        <guimenuitem>Applications</guimenuitem>
        <guimenuitem>File tools</guimenuitem>
        <guimenuitem>&krusader;</guimenuitem>
      </menuchoice>
    </emphasis>.</para>
    <variablelist>
      <title>Command-line options:</title>
      <varlistentry>
        <term>
          <option>--left</option>
          <replaceable>
          &lt;path&gt;</replaceable>
        </term>
        <listitem>
          <para>
            <action>start left panel at
            &lt;path&gt;</action>
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>--right</option>
          <replaceable>
          &lt;path&gt;</replaceable>
        </term>
        <listitem>
          <para>
            <action>start right panel at
            &lt;path&gt;</action>
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>--left</option>
          <replaceable>
          &lt;path1&gt;,&lt;path2&gt;,&lt;path3&gt;</replaceable>
        </term>
        <listitem>
          <para>
            <action>start left panel at
            &lt;path1&gt;,&lt;path2&gt;,&lt;path3&gt;,
            with tabs.</action>
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>--profile</option>
          <replaceable>
          &lt;panel-profile&gt;</replaceable>
        </term>
        <listitem>
          <para>
            <action>load a 
            <link linkend="panel_profiles">panel-profile</link> on
            startup (this overrides the 
            <link linkend="konfig-startup">default startup
            profile</link>).</action>
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
    <para>Examples: 
    <screen><prompt>$</prompt> <userinput><command>krusader</command> <replaceable>--left=&lt;path&gt; --right=&lt;path&gt;</replaceable></userinput></screen>
    <screen><prompt>$</prompt> <userinput><command>krusader</command> <replaceable>--left=/mnt/cdrom --right=ftp://[e-mail]</replaceable></userinput></screen>
    <screen><prompt>$</prompt> <userinput><command>krusader</command> <replaceable>--left=&lt;path1&gt;,&lt;path2&gt; --right=&lt;path1&gt;,&lt;path2&gt;,&lt;path3&gt;</replaceable></userinput></screen>
    <screen><prompt>$</prompt> <userinput><command>krusader</command><replaceable>--profile &lt;panel-profile&gt;</replaceable></userinput></screen>
    <screen><prompt>$</prompt> <userinput><command>krusader</command> <replaceable>--profile ftp-managment</replaceable></userinput></screen>
    </para>
    <para>The standard &Qt; and &kde;
    command-line options are available, and can be listed by
    entering 
    <userinput>
      <command>krusader</command>
      <option>--help</option>
    </userinput>.</para>
    <variablelist>
      <title>Other command-line options:</title>
      <varlistentry>
        <term>
          <option>--help-qt</option>
        </term>
        <listitem>
          <para>
            <action>List Qt-specific options</action>
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>--help-kde</option>
        </term>
        <listitem>
          <para>
            <action>List KDE-specific options</action>
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>--help-all</option>
        </term>
        <listitem>
          <para>
            <action>List all options</action>
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>--author</option>
        </term>
        <listitem>
          <para>
            <action>Show the authors names</action>
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>-v,--version</option>
        </term>
        <listitem>
          <para>
            <action>Show the version number</action>
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>--license</option>
        </term>
        <listitem>
          <para>
            <action>Show license information</action>
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
  </sect1>
  <sect1 id="configuration">
    <title>Configuring &krusader;</title>
    <para>When you run &krusader; for the first time,
    the &krusader; configuration module 
    <link linkend="konfigurator">Konfigurator</link> will show up
    and allow you to configure &krusader; as well as
    detect installed packers and tools. You can always run
    Konfigurator again from the
    &settingsmenu-lnk;.</para>
  </sect1>
  <sect1 id="default-file-manager">
    <title>Making &krusader; the default file
    manager</title>
    <para>To make &krusader; the default file manager in
    Gnome, <ulink url="http://psychocats.net/ubuntu/nonautilusplease">click here</ulink> for more information.
    </para>
    <para>To make &krusader; the default file manager in
    &kde;, <ulink url="http://groups.google.com/group/krusader-devel/browse_thread/thread/8209d785d3ba0ac6">click here</ulink> for more information. 
    </para>
  </sect1>
</chapter>

<chapter id="krusader_kde4_install">
<title>Installation on KDE4.x</title>
<sect1 id="kde4_install">
   <title>Krusader installation instructions on KDE4.0</title>
      <note>
        <para>From version &krusader;-2.0.0 and higher is &kde;-4 only.</para>
      </note>
      <note>
        <para>At moment of writing &krusader;-2.0.0 is still under development, though it works :)</para>
      </note>

<para>"krusader_kde4.tar.gz" is the supposed name of the krusader tarball (it will be probably a different one ;)</para>

<para>You can download the latest available krusader-2.x <link linkend="krusader_svn">from SVN</link>.</para>

<para><command>DCMAKE_INSTALL_PREFIX</command> is the location of the KDE DQT_INCLUDES</para>
<para>
    <screen>
      <prompt>$</prompt> <userinput><command>tar -xzvf</command> <option>krusader_kde4.tar.gz</option></userinput>
      <prompt>$</prompt> <userinput><command>cd </command> <option>krusader_kde4</option></userinput>
      <prompt>$</prompt> <userinput><command>cmake </command> <option>-DCMAKE_INSTALL_PREFIX=/usr/ -DQT_INCLUDES=/usr/share/qt4/include</option></userinput>
      <prompt>$</prompt> <userinput><command>make</command></userinput>
      <prompt>$</prompt> <userinput><command>su -c </command> <option>"make install"</option></userinput>
     </screen>
</para>

 </sect1>
</chapter>