installation.docbook

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

<chapter id="installation">
  <!-- **********************************************************************
                               installation.docbook
                            ++++++++++++++++++++++++++
  copyright            : (C) 2000 - 2008
                          Rafi Yanai, Shie Erlich, Frank Schoolmeesters
                          & the Krusader Krew
  e-mail               : [e-mail]
  web site             : http://www.krusader.org
  description          : a Krusader Documentation File

***************************************************************************
* Permission is granted to copy, distribute and/or modify this            *
* document under the terms of the GNU Free Documentation License,         *
* Version 1.1 or any later version published by the Free Software         *
* Foundation; with no Invariant Sections, no Front-Cover Texts and        *
* no Back-Cover Texts.  A copy of the license is available on the         *
* GNU site http://www.gnu.org/licenses/fdl.html or by writing to:         *
* Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,    *
* MA 02111-1307, USA.                                                     *
*********************************************************************** -->
  <title>Installation on KDE3.x</title>
  <indexterm>
    <primary>Installation</primary>
  </indexterm>
  <sect1 id="requirements">
    <title>Requirements</title>
    <para>In order to successfully use the most recent
    &krusader;, you need &kde;libs
    &gt;= 3.4</para>
    <para>Required &kde; version: 
    <itemizedlist>
      <listitem>
        <para>&krusader; v1.01: &kde;
        2</para>
      </listitem>
      <listitem>
        <para>&krusader; v1.02 - 1.40: &kde;
        3.0 - &kde; 3.2</para>
      </listitem>
      <listitem>
        <para>&krusader; 1.40: prefers &kde;
        3.2 (otherwise all features will not be available)</para>
      </listitem>
      <listitem>
        <para>&krusader; v1.50 - v1.51: &kde;
        3.2 - &kde; 3.3 (Konfigurator crash on
        &kde; 3.4)</para>
      </listitem>
      <listitem>
        <para>&krusader; v1.60.0 - v1.70.0:
        &kde; 3.3 - &kde; 3.5</para>
      </listitem>
      <listitem>
        <para>&krusader; 1.70.x: prefers
        &kde; &gt;= 3.4 (otherwise all
        features will not be available)</para>
      </listitem>
      <listitem>
        <para>&krusader; 1.80.0: &kde; 3.4 -
        &kde; 3.5</para>
      </listitem>
      <listitem>
        <para>&krusader; v2.xx.x: &kde; 4 -
        &Qt; 4 The big challenge, a first release in
        2008</para>
      </listitem>
    </itemizedlist>
    NOTE: there are no installation instructions for &kde;4 yet available since at moment of writing &krusader; 
    was not ported yet to &kde;4.</para>
    <para>Platforms: 
    <itemizedlist>
      <listitem>
        <para>All POSIX
        (&Linux;/BSD/&UNIX;-like OSes),
        &Solaris;</para>
      </listitem>
      <listitem>
        <para>All BSD Platforms
        (&freebsd;/&netbsd;/&openbsd;/&MacOS;)</para>
      </listitem>
    </itemizedlist></para>
    <para>&krusader; uses about 3-4 Mbyte of memory to
    run and about 15 Mbyte of shared memory, which is also used by
    other processes, but this may vary depending on your platform
    and configuration. In order to handle archives the archivers
    must be configured 
    <link linkend="konfig-dependencies">here</link>.</para>
    <para>A package of popular (un)packers, &krusader;
    itself and add-ons can be found on the
    &krudownload-url;.</para>
    <para>For more requirements, see below. Have a look at the
    &faq-lnk; section as well.</para>
  </sect1>
  <sect1 id="getting-krusader">
    <title>Obtaining &krusader;</title>
    <para>The latest information about &krusader; can be
    found on the &kruwebsite-url; .</para>
    <sect2 id="krusader-download">
      <title>&krusader; Downloads</title>
      <para>it is recommended to use the &krusader; package
      that is provided by your distribution.
      &distrowatch-com-url; is a great resource to check
      the availability. If your distribution does not offer
      &krusader;, please contact the creators of your
      distribution and ask them to provide a &krusader;
      package</para>
      <para>The latest version, as well as the older versions, can
      be found on the &krudownload-url; and on the
      &sfmirrors-url;. It contains the source tarballs,
      RPM and DEB packages to whatever distro the
      &krusader;-Krew is using and packages build by
      &krusader; users and third parties.</para>
      <para>Distributions who provide &krusader;: 
      <itemizedlist>
        <listitem>
          <para>&suse-download-url; &gt;=
          9.3, Note: please use &krusader;-1.60.0
          instead of &krusader;-1.51 (might be unstable
          on &SuSE;9.3-&kde;3.4).</para>
        </listitem>
        <listitem>
          <para>&fedora; via
          &fedora-extras-url; 
          <command># yum install krusader</command> will do the job,
          thanks to Marcin Garski. &RedHat; RPM packages
          can usually found on the &krudownload-url; or
          at &dag-wiers-download-url; and
          &dries-verachtert-download-url; .</para>
        </listitem>
        <listitem>
          <para>&debian-download-url;, on our
          &krudownload-url; you might find more recent
          DEB packages. Note: usually &debian; packages
          work also on distributions that are "based on
          &debian;", and some of these provide their own
          (incompatible) packages.
          &ubuntu-kubuntu-download-url;,
          &linspire-download-url;, &knoppix;
          4.x DVD, &kanotix;, etc.</para>
        </listitem>
        <listitem>
          <para>&mandriva-download-url; via the contrib
          repository 
          <command># urpmi krusader</command> will do the job,
          &gentoo-download-url;,
          &yoper-download-url;.</para>
        </listitem>
        <listitem>
          <para>&archlinux-download-url;,
          &frugalware-linux-download-url;,
          &pclinuxos-download-url;,
          &altlinux-download-url;.</para>
        </listitem>
        <listitem>
          <para>&freebsd-download-url;, the port is
          maintained by 
          <link linkend="credits">Heiner Eichmann</link>.</para>
        </listitem>
        <listitem>
          <para>&netbsd-download-url;,
          &lunarlinux-download-url;
          ,&arklinux;, &openlx;,
          &sourcemage;.</para>
        </listitem>
        <listitem>
          <para>Even more distributions can be found with
          &distrowatch-com-url;.</para>
        </listitem>
      </itemizedlist>Use the installation tools included in your
      distro to install the &krusader; package. You
      might need an internet connection if &krusader; is
      not included on the &CD; or DVD. There are
      probably other distributions which include
      &krusader;. If you know of one, please send
      feedback so that we can include it on the distrolist.</para>
      <para>Others 
      <itemizedlist>
        <listitem>
          <para>&slackware; tgz binaries can usually be
          found on the &krudownload-url;. You can also
          use &portpkg-url; that contains a
          &kru-slackbuild-url;, 
          <command># portpkg krusader</command> will do the
          job.</para>
        </listitem>
        <listitem>
          <para>There is a &macosx-port-url; 
          with the help of &fink-url; , the port is
          maintained by <ulink url="http://hritcu.wordpress.com/about/">Catalin Hritcu</ulink>.</para>
        </listitem>
      </itemizedlist></para>
      <para>Installation via the &klik-protocol-url; 
      <itemizedlist>
        <listitem>
          <para>&klik-krusader-url; downloads
          &krusader; provided by &debian;
          stable, more information is
          &klik-available-url; .</para>
        </listitem>
        <listitem>
          <para>&klik-krusader-latest-url; downloads the
          latest &klik-stable-krusader-url; provided by
          the &krusader; Krew.</para>
        </listitem>
        <listitem>
          <para>&klik-krusader-cvs-url; downloads a
          &klik-cvs-krusader-url; provided by the
          &krusader; Krew.</para>
        </listitem>
      </itemizedlist></para>
      <para>Search engines 
      <itemizedlist>
        <listitem>
          <para>You can also find packages on &Linux;
          software archives such as &freshmeat-url; or
          &kde-apps-url; .</para>
        </listitem>
        <listitem>
          <para>If you can notfind a package for your distribution,
          we recommend searching for it with
          &rpmfind-url;, &rpmpbone-url; or
          &rpmseek-url;.</para>
        </listitem>
      </itemizedlist>If you enjoy using &krusader;, we
      would appreciate it if you went to one of these sites and
      rated it.</para>
      <para>If you still can not find a package, follow the
      installation procedure on how to compile
      &krusader; from source. This very thorough HowTo
      describes the process in such detail that even newcomers
      should not have any problems.</para>
    </sect2>
    <sect2 id="version_scheme">
      <title>Version Scheme</title>
      <para>A new version scheme has been used since
      &krusader;-1.60.0 
      <itemizedlist>
        <listitem>
          <para>First digit - the major version</para>
        </listitem>
        <listitem>
          <para>Second digit(s) - percentage of features completed
          for this major version</para>
        </listitem>
        <listitem>
          <para>Third digit(s) - bugfixes.</para>
        </listitem>
      </itemizedlist>In essence, releasing
      &krusader;-1.60.0 means that we believe that
      &krusader; is about 60% done with all the features
      we had scheduled for the 1.x.x series. Series 2.x.x will be
      &kde; 4.x releases. Hopefully, it is easy to
      understand.</para>
    </sect2>
    <sect2 id="krusader_stable">
      <title>Stable Version</title>
      <para>
        <filename>krusader-x.xx.tar.gz</filename>
      </para>
      <note>
        <para>&krusader; is released under the
        &gpl-lnk;. This means that THE PROGRAM IS
        PROVIDED "AS IS" WITH NO WARRANTY OF ANY KIND, even when it
        is marked as a stable release.</para>
      </note>
    </sect2>
    <sect2 id="krusader_devel">
    <title>Development Version (beta release)</title>
    <para>
      <filename>krusader-x.xx-betax.tar.gz</filename>
    </para>
    <para>Before every stable release we release at least one
    development version in order to hunt down the bugs.</para>
    <warning>
      <para>These releases are beta releases and will probably
      contain some bugs.</para>
    </warning>&dev-cvs-note; 
    <para>The beta release has 3 goals: 
    <itemizedlist>
      <listitem>
        <para>Apply a feature-freeze until the stable is released,
        only bugs will be fixed. New features have to wait until
        the stable is released.</para>
      </listitem>
      <listitem>
        <para>Obtain feedback from &krusader; users so
        that we can fix the bugs.</para>
      </listitem>
      <listitem>
        <para>Give translators time to update the translations for
        the coming stable. Please read the
        &i18n-page-url;.</para>
      </listitem>
    </itemizedlist></para></sect2>
    <sect2 id="krusader_cvs">
      <title>CVS Builds</title>
      <para>
        <filename>krusader-cvs-yyyymmdd.tar.gz</filename>
      </para>
      <warning>
        <para>These builds are untested and come without any
        warranty. They may contain bugfixes, new features, or even
        new bugs.</para>
      </warning>
      <para>We provide daily snapshots of &krusader;'s
      CVS version. For those who are interested, the 
      <emphasis role="bold">nightly tarball</emphasis> can be found
      on the &krucutedge-url;. Depending on the stage of
      development, this version will either be stable or unstable.
      Just before a stable release, the CVS version is almost
      stable. After a stable release new features will be committed
      into CVS, which might lead to the appearance of bugs. In some