installation.docbook

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

      rare cases, the build will not even compile if we make a
      mistake. In that case we try to fix the error as soon as
      possible.</para>
      <para>&krusader; provides 2 nightly snapshots: 
      <orderedlist numeration="arabic">
        <listitem>
          <para>
          <filename>krusader-cvs-yyyymmdd.tar.gz</filename>: 
          <command>make -f Makefile.cvs</command> must be run before
          the 
          <command>./configure</command> script is available.</para>
        </listitem>
        <listitem>
          <para>
          <filename>krusader-cvs2-yyyymmdd.tar.gz</filename>: for
          users who have problems with the 
          <command>make -f Makefile.cvs</command> command, we have
          already done this for you and the 
          <command>./configure</command> script is included in the
          tarball. This tarball is a bit bigger than the first
          one.</para>
        </listitem>
      </orderedlist></para>
      <para>
      <emphasis role="bold">check out from CVS</emphasis>.
      &krusader; can be checked out through anonymous
      (pserver) CVS with the following instruction set. The module
      you wish to check out must be specified as the module name.
      When prompted for a password for anonymous, press the
      &Enter; key.</para>
      <para>Currently, there are two module options: 
      <itemizedlist>
        <listitem>
          <para>krusader_kde2: the &kde;2 branch, stable
          but it is basically v1.01 and there are no planned
          changes</para>
        </listitem>
        <listitem>
          <para>krusader_kde3: the &kde;3 branch that we
          currently use</para>
        </listitem>
      </itemizedlist></para>
      <para>To check out &krusader; from CVS: 
      <screen><prompt>$</prompt> <userinput><command>cvs</command> <option>-d:pserver:[e-mail]:/cvsroot/krusader login</option></userinput></screen>
      <screen><prompt>$</prompt> <userinput><command>cvs</command> <option>-z3 -d:pserver:[e-mail]:/cvsroot/krusader co krusader_kde3</option></userinput></screen>
      (note: updates from within the modules directory do
      not need the -d parameter)</para>
      <para>If you want to check out a specific version of
      &krusader; from CVS (&eg;
      &krusader;-1.60.0) : 
      <screen><prompt>$</prompt> <userinput><command>cvs</command> <option>-z3 -d:pserver:[e-mail]:/cvsroot/krusader co -rversion_1_60_0 krusader_kde3</option></userinput></screen>
      </para>
      <para>If you want to check out a specific date of
      &krusader; from CVS (&eg;
      &krusader;-2006-10-29) : 
      <screen><prompt>$</prompt> <userinput><command>cvs</command> <option>-z3 -d:pserver:[e-mail]:/cvsroot/krusader co -D2006-10-29 krusader_kde3</option></userinput></screen>
      </para>
      <para>Mostly being &gentoo; users, we provide a
      &gentoo-life-ebuild-url; for all those who want to
      stay on the bleeding edge of file management and do not want
      to miss the advantages of portage. Please take a look at our
      &krucutedge-url; for more installation
      details.</para>
      <para>We also provide &viewcvs-url; to browse the
      CVS repository.</para>
    </sect2>
    <sect2 id="krusader_svn">
      <title>Subversion</title>
      <para>&subversion-url; is used for
      the &krusader; 2.x series for &kde;4.
      it is also possible to
      &browse-svn-repo-url;.</para>
      <para>To check out the latest &krusader; 1.x for
      &kde; 3 from SVN: (NOTE: at moment of writing use CVS for krusader_kde3, since krusader_kde3
      is developed in CVS and NOT in SVN, currently you will get an old version in SVN) 
      <screen><prompt>$</prompt> <userinput><command>svn</command> <option>co https://krusader.svn.sourceforge.net/svnroot/krusader/trunk/krusader_kde3</option></userinput></screen>
      To check out the latest &krusader; 2.x
      for &kde; 4 from SVN:
      <screen><prompt>$</prompt> <userinput><command>svn</command> <option>co https://krusader.svn.sourceforge.net/svnroot/krusader/trunk/krusader_kde4</option></userinput></screen>
      </para>
    </sect2>
    <sect2 id="krusader_old">
      <title>Older Releases</title>
      <para>If you are looking for older releases we recommend the
      &sfmirrors-url;, available from our project
      page.</para>
    </sect2>
  </sect1>
  <sect1 id="compilation">
    <title>Compiling and Installing</title>
    <sect2 id="sourcedownload">
    <title>Compiling &krusader;. What now?</title>
    <para>Check the environment variables
    &kdeqtdir-lnk;.</para>
    <para>To compile and install &krusader; on your
    system, type the following in the base directory of the
    &krusader; package:</para>
    <screen>
      <prompt>$</prompt> <userinput><command>./configure</command></userinput>
      <prompt>$</prompt> <userinput><command>make</command></userinput>
      <prompt>$</prompt> <userinput><command>su -c 'make</command> <option>install'</option></userinput></screen>
    &krusaderui-rc-text; 
    <para>Since &krusader; uses 
    <command>autoconf</command> and 
    <command>automake</command> you should have no trouble compiling
    it. If you run into problems, read the detailed installation
    instructions below.</para></sect2>
 
 
<sect2 id="install_quickstart">
<title>Quickstart Installation Tutorial</title>

<sect3 id="install_quickstart_debian">
<title>Debian</title>
<para>These instructions should work as well on &debian; based distributions like: 
&ubuntu;, &kubuntu;, &linspire;, &kanotix;, ...</para>

<para>Add the next lines in the <filename>~/.bashrc</filename> configuration file
<screen>
<userinput><command>export</command> <option>QTDIR=/usr</option></userinput>
<userinput><command>export</command> <option>KDEDIR=/usr</option></userinput>
<userinput><command>export</command> <option>export KDEDIRS=/opt/krusader:/usr</option></userinput>
</screen>
</para>

<para>Install the <link linkend="faqi_missing_libs">build dependencies</link> for &krusader;  
<screen>
<prompt>#</prompt> <userinput><command>apt-get</command> <option>build-dep krusader</option></userinput>
</screen>
</para>

<para><link linkend="version_scheme">Download</link> the &krusader; sourcecode, unpack and 
enter the <filename>krusader_kde3</filename> directory.</para>

<para> 
The next command will create <command>./configure</command>
<screen>
<prompt>$</prompt> <userinput><command>make -f</command> <option>Makefile.cvs</option></userinput>
</screen>
NOTE: you might need to upgrade <filename>automake</filename> and/or <filename>autoconf</filename>, if an error message appears. 
</para>

<para>Install &krusader; in the <filename>/opt</filename> directory to not overwrite the official &debian; binary <filename>/usr/bin/krusader</filename>, 
so that <command>krusader</command> will run the official &debian; package and <command>/opt/bin/krusader</command> runs the compiled version. 
It's recommended to use enable the full debug, so that you can possible problems at us. Run configure.  
<screen>
<prompt>$</prompt> <userinput><command>./configure</command> <option>--prefix=/opt/krusader --enable-debug=full</option></userinput>
</screen>
</para>

<para>Compile &krusader;  
<screen>
<prompt>$</prompt> <userinput><command>make</command></userinput>
</screen>
</para>

<para>Install Krusader  
<screen>
<prompt>$</prompt> <userinput><command>su -c</command> <option>"make install"</option></userinput>
</screen>
</para>

<para><command>/opt/bin/krusader</command> runs the compiled &krusader; version.</para>
</sect3>

<sect3 id="install_quickstart_suse">
<title>SuSE</title>
<para>Install the <link linkend="faqi_missing_libs">build dependencies</link> for &krusader;</para>  
<para><link linkend="version_scheme">Download</link> the &krusader; sourcecode, unpack and 
enter the <filename>krusader_kde3</filename> directory. Now you can compile and install &krusader;
<screen>
<prompt>$</prompt> <userinput><command>make -f</command> <option>Makefile.cvs</option></userinput>
<prompt>$</prompt> <userinput><command>./configure</command> <option>--prefix=/opt/krusader --enable-debug=full</option></userinput>
<prompt>$</prompt> <userinput><command>make</command></userinput>
<prompt>$</prompt> <userinput><command>su -c</command> <option>"make install"</option></userinput>
</screen>
</para>
</sect3>

<sect3 id="install_quickstart_others">
<title>For other Linuxes</title>
<para>Ofcource it's impossible to cover all Linuxes, but here are the general installation instructions.</para>

<para>Usually <command>./configure --prefix=/usr</command> should be used, though options like 
<filename>/opt/krusader</filename> are usually better so that you don't overwrite files that 
are installed by your package managment system. 
Please don't use the <filename>/usr/local</filename> directory as it simply won't work.</para> 
<para>Install the <link linkend="faqi_missing_libs">build dependencies</link> for &krusader;</para>  
<para><link linkend="version_scheme">Download</link> the &krusader; sourcecode, unpack and enter the <filename>krusader_kde3</filename> directory. Now you can compile and install &krusader;
<screen>
<prompt>$</prompt> <userinput><command>make -f</command> <option>Makefile.cvs</option></userinput>
<prompt>$</prompt> <userinput><command>./configure</command> <option>--prefix=/usr</option></userinput>
<prompt>$</prompt> <userinput><command>make</command></userinput>
<prompt>$</prompt> <userinput><command>su -c</command> <option>"make install"</option></userinput>
</screen>
</para>    
</sect3>
    
</sect2>
    
    <sect2 id="install_tutorial">
      <title>Detailed Installation Tutorial</title>
      <para>The next section will explain how to install
      &krusader; step by step. Questions about the
      installation process have been asked many times and
      especially users new to &Linux; often have
      problems compiling software from source. Therefore, we are
      trying to keep the explanations as detailed as possible even
      if they are mostly not &krusader; specific.
      Experienced users may easily skip most of the steps.</para>
      <para>Unfortunately, because not all &Linux;
      distributions follow the &fhs-url; it is impossible
      to write a tutorial that would cover all circumstances.
      However, these guidelines will help you in the right
      direction.</para>
      <note>
        <para>If you encountered problems, please read first this
        installation procedure and the &faq-lnk;. If the
        problem persists, use the &help-request-lnk; to
        ask for help.</para>
      </note>
      <orderedlist>
        <listitem>
          <para>Install all packages and libraries that are needed
          for the compilation, please read the
          &faq-lnk;. 
          <tip>
            <para>If you install &kdevelop;, (almost)
            everything that you need to compile
            &krusader; will be installed on your
            computer. However, if you are not a developer, please
            follow the instructions and do not use
            &kdevelop; to compile
            &krusader;.</para>
          </tip></para>
          <para></para>
          <!-- Empty line to make it more readable -->
        </listitem>
        <listitem>
          <para>Open your favourite terminal emulator
          (&eg; &konsole;).</para>
          <para></para>
          <!-- Empty line to make it more readable -->
        </listitem>
        <listitem>
          <para>We recommend you create a separate directory to
          keep all the sources you compile in. This way you will
          have a better overview of the installed programs and it
          will be easier to uninstall them later. 
          <screen><prompt>$</prompt> <userinput><command>mkdir</command> ~/source</userinput></screen>
          The chosen directory is just an example, any
          other will work.</para>
          <para></para>
          <!-- Empty line to make it more readable -->
          <para></para>
          <!-- Empty line to make it more readable (second line is needed) -->
        </listitem>
        <listitem>
          <para>Copy the sources to the 
          <filename>~/source</filename> directory and unpack them. 
          <screen><prompt>$</prompt> <userinput><command>cp</command> /<replaceable>"your_dir"</replaceable> /krusader-x.xx.tar.gz ~/source</userinput></screen>
          <screen><prompt>$</prompt> <userinput><command>cd</command> ~/source</userinput></screen>
          <screen><prompt>$</prompt> <userinput><command>tar</command> <option>-xzvf</option> krusader-x.xx.tar.gz</userinput></screen>
          </para>
          <para></para>
          <!-- Empty line to make it more readable -->
        </listitem>
        <listitem>
          <para>Optional step: if you wish you can delete the
          tarball at this point as it is no longer needed. 
          <screen><prompt>$</prompt> <userinput><command>rm</command> krusader-x.xx.tar.gz</userinput></screen>
          </para>
          <para></para>
          <!-- Empty line to make it more readable -->
        </listitem>
        <listitem>
          <para>Change to the directory containing the sources. 
          <screen><prompt>$</prompt> <userinput><command>cd</command> krusader-x.xx</userinput></screen>
          </para>
          <para></para>
          <!-- Empty line to make it more readable -->
        </listitem>
        <listitem id="kde_qt_dir">
          <para>Check the environment variables 
          <envar>QTDIR</envar>and 
          <envar>KDEDIR</envar>. &krusader;'s 
          <command>./configure</command> script needs to know where
          the &Qt; and &kde; directories
          are.</para>
          <para>
          <envar>QTDIR</envar>: 
          <replaceable>&lt;path to your Qt
          installation&gt;</replaceable> &eg; 
          <filename>/usr/lib/qt3</filename> or 
          <filename>/usr/qt3</filename></para>
          <para>
          <envar>KDEDIR</envar>: 
          <replaceable>&lt;path to your KDE
          installation&gt;</replaceable> &eg; 
          <filename>/usr</filename> or 
          <filename>/opt/kde3</filename></para>
          <para>Normally your distribution will set them for you,
          but experience has shown that some do not. You can easily
          check the values with the 
          <command>echo</command> command. 
          <screen><prompt>$</prompt> <userinput><command>echo</command> $QTDIR</userinput>/usr/lib/qt3
                  <prompt>$</prompt> <userinput><command>echo</command> $KDEDIR</userinput>/usr</screen>

          If both commands give an output, the enviroment variables
          are set (the above example are the settings of
          &mandriva;-&Linux;). In case you
          receive empty lines, the variables are not set and you
          have to set them manually. If you do not know what to set