installation.docbook

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

          the variables to, or if you want to check if the
          variables are correctly set, ask your distributor or use
          the 
          <command>find</command> command. 
<screen><prompt>$</prompt> <userinput><command>find</command> <option>/usr /opt -name</option> qtconfig <option>-type f 2>/dev/null</option></userinput>
/usr/lib/qt3/bin/qtconfig
<prompt>$</prompt> <userinput><command>find</command> <option>/usr /opt -name</option> kdeinit <option>-type f 2>/dev/null</option></userinput>
/usr/bin/kdeinit</screen>
          In this case 
          <filename>/usr/lib/qt3</filename> is your 
          <envar>QTDIR</envar> and 
          <filename>/usr</filename> is your 
          <envar>KDEDIR</envar>. The installed binaries will go to 
          <filename>/usr/bin</filename>. Now we will set the
          enviroment variables with the 
          <command>export</command> command. 
          <screen><prompt>$</prompt> <userinput><command>export</command> QTDIR=<replaceable>&lt;replace with your QTDIR&gt;</replaceable></userinput></screen>
          <screen><prompt>$</prompt> <userinput><command>export</command> KDEDIR=<replaceable>&lt;replace with your KDEDIR&gt;</replaceable></userinput></screen>
          </para>
          <note>
            <para>These enviroment variables are only set for the
            lifetime of your current shell. When you close your
            terminal and open a new one they will be gone. Assuming
            &krusader; is not the only
            &Qt;/&kde; program you want to
            compile, we recommend to make these settings permanent
            (&eg; append both export commands to your 
            <filename class="directory">/etc/profile</filename>)
            file.</para>
          </note>
          <para>If you can notdetermine your KDEDIR, 
          <command>kde-config --prefix</command> might help
          you.</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>If you have downloaded a stable version 
          <filename>"krusader-x.xx.tar.gz"</filename> or a beta
          version 
          <filename>"krusader-x.xx-betax.tar.gz"</filename>, you
          can skip this step. In this case the 
          <filename>./configure</filename> script is
          provided.</para>
          <para>If you have downloaded a CVS build or nightly
          tarball 
          <filename>"krusader-cvs-yyyy-mm-dd.tar.gz"</filename>",
          you will have to run the following command to create the 
          <filename>./configure</filename> script: 
          <screen><prompt>$</prompt> <userinput><command>make</command> <option>-f</option>Makefile.cvs</userinput></screen>
          </para>
          <para>If everything is OK you will see the following
          output on your screen: 
<screen><prompt>$</prompt> <userinput><command>make</command> <option>-f</option> Makefile.cvs</userinput>
This Makefile is only for the CVS repository
This will be deleted before making the distribution
*** Creating acinclude.m4
*** Creating list of subdirectories
*** Creating configure.in
*** Creating aclocal.m4
*** Creating configure
*** Creating config.h template
*** Creating Makefile templates
*** Postprocessing Makefile templates
*** Creating date/time stamp
*** Finished
Don't forget to run ./configure
If you haven't done so in a while, run ./configure --help
<prompt>$</prompt></screen>
          </para>
          <note>
            <para>You will need to have 
            <application>autoconf 2.52, 2.53 or
            2.54</application> and 
            <application>automake 1.6</application> (or higher) to
            run the 
            <command>make -f Makefile.cvs</command> command</para>
          </note>
          <tip>
            <para>If you encounter problems with this command click
            <link linkend="krusader_cvs">here</link>.
            &krusader; provides two nightly builds
            (snapshots) one with a 
            <filename>./configure</filename> script and one
            without.</para>
          </tip>
          <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>Your &Linux; distro
          &krusader; RPM or DEB package will normally
          install &krusader; in the 
          <filename>KDEDIR/bin</filename> directory. According to
          the &fhs-url;, any user installed files go to
          the 
          <filename>/usr/local</filename> directory. If you wish
          &krusader; to be installed in another
          directory, it can be determed with the prefix option. If
          you do not have root access, 
          <filename>/home/YOUR_USERNAME/.kde</filename> is probably
          a good choice. 
<screen>
foo

Krusader Project:
-----------------
Source code location: .
C Compiler:           gcc
C Compiler flags:     -ansi -W -Wall -pedantic -Wchar-subscripts -Wshadow -Wpointer-arith
-Wmissing-prototypes -Wwrite-strings -D_XOPEN_SOURCE=500 -D_BSD_SOURCE -O2
-Wformat-security -Wmissing-format-attribute
C++ Compiler:         g++
prefix:               /usr/local
kde_libraries:        /usr/include
kde_includes:         /usr/lib
kde_locale:           /usr/share/locale
qt_libraries:         /usr/lib/qt3/lib
qt_includes:          /usr/lib/qt3/include
KDEDIR:               /usr
QTDIR:                /usr/lib/qt3
Install path:         /usr/local/bin
krusader version:     1.80.0
krusader binary:      /usr/local/bin/krusader     (after 'make install')
Thank you for using Krusader

Good - your configure finished. Start make now
<prompt>bash$</prompt>
</screen>
          </para>
          <para>This is the output for
          &Mandrake;-&Linux; 10, other
          distributions may give a different output.</para>
          <tip>
            <para>At the end of the 
            <command>./configure</command> script you will find a
            summary of the most important settings, &eg;
            where the &krusader; binary will be
            installed (after the 'make install' command). This part
            will also display a warning if the environment
            variables &kdeqtdir-lnk; are empty.</para>
          </tip>
          <para></para>
          <!-- Empty line to make it more readable -->
          <para>Since &krusader;-1.70.0 
          <command>./configure</command> has two specific
          &krusader; options: 
          <itemizedlist>
            <listitem>
              <para>
              <userinput>
                <command>./configure</command>
                <option>--without-konqueror</option>
              </userinput>: build &krusader; without support
              &konqueror;'s servicemenus, default=with.
              This means that &konqueror;'s right-click
              menu entries will not be available.</para>
            </listitem>
            <listitem>
              <para>
              <userinput>
                <command>./configure</command>
                <option>--without-javascript</option>
              </userinput>: build &krusader; without JavaScript
              support, default=with. This means that the
              &javascript-console-lnk; will not be
              available.</para>
            </listitem>
            <listitem>
              <para>
              <userinput>
                <command>./configure</command>
                <option>--without-acl</option>
              </userinput>: build &krusader; without ACL support default=with.
              Sometimes this option is needed if you get a ACL compile error when running <command>make</command>.</para>
            </listitem>
          </itemizedlist>In the past the support was always
          compiled in when the headers where found, now you have
          the choice.</para>
          <para>Use 
          <userinput>
            <command>./configure</command>
            <option>--help</option>
          </userinput>to see more options or read the 
          <filename>INSTALL</filename> file in the
          &krusader; sources.</para>
          <para>If you used another --prefix= than 
          <filename>$KDEDIR or /usr/local</filename>, it is
          recommended to do an extra check: 
<screen><prompt>$</prompt> <userinput><command>kde-config</command> <option>--path exe</option></userinput>
/home/frank/.kde/bin/:/usr/bin/:/usr/local/bin/   
<prompt>$</prompt></screen>
          If the
          &lt;prefix_dir/bin&gt; directory is
          not shown, you need to use e.g. 
          <command>export KDEDIRS=/usr/local:/usr</command>. To
          make these settings permanent you can &eg;
          append this export command to your 
          <filename>/etc/profile</filename> file. After that you
          need to restart &kde;.</para>
          <note>
            <para>If 
            <command>./configure</command> fails, take a look at
            &missing-libs-lnk;.</para>
          </note>
          <para></para>
          <!-- Empty line to make it more readable -->
        </listitem>
        <listitem>
          <para>Start the compilation process with the 
          <command>make</command> command. 
          <screen><prompt>$</prompt> <userinput><command>make</command></userinput></screen>
          This will take about 3 - 40 minutes depending on how fast your computer runs. If
          everything goes well, it will &eg; end with
          the following messages: 
<screen>
foo
make[2]: Leaving directory `/home/source/krusader_kde3/tar'
make[2]: Entering directory `/home/source/krusader_kde3'
make[2]: Leaving directory `/home/source/krusader_kde3'
make[1]: Leaving directory `/home/source/krusader_kde3'
<prompt>bash$</prompt>
</screen>
          </para>
          <para></para>
          <!-- Empty line to make it more readable -->
          <para>If 
          <command>./configure</command> was successful and 
          <command>make</command> failed for some reason, continue
          to read this page. If you can not find a solution to your
          problem, feel free to post a help request at our
          &forum-lnk;.</para>
          <para></para>
          <!-- Empty line to make it more readable -->
        </listitem>
        <listitem>
          <para>If everything is correct, you can now install
          &krusader;. 
          <screen><prompt>$</prompt> <userinput><command>su -c 'make</command> <option>install'</option></userinput></screen>
          You will be asked to enter your root
          password.</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>&krusaderui-rc-text; 
        <para></para>
        <!-- Empty line to make it more readable --></listitem>
        <listitem>
          <para>Now you can 
          <link linkend="starting-krusader">
          start</link> &krusader;.</para>
          <para></para>
          <!-- Empty line to make it more readable -->
        </listitem>
        <listitem>
          <para>Optional step: Cleaning up to save disk space.
          Note: All compiled files created with the 
          <command>make</command>command will be deleted. 
          <screen><prompt>$</prompt> <userinput><command>make</command> <option>clean</option></userinput></screen>
          </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>If you ever want to uninstall
          &krusader;, use 
          <screen><prompt>$</prompt> <userinput><command>su -c 'make</command> <option>uninstall'</option></userinput></screen>
          You will be asked to enter your root
          password.</para>
          <para></para>
          <!-- Empty line to make it more readable -->
        </listitem>
      </orderedlist>
      <para>If you followed the installation procedure and still
      encountered problems installing &krusader;, refer
      to &faq-lnk;. If the problem persists, use the
      &help-request-lnk; to ask for help.</para>
    </sect2>
  </sect1>
  <sect1 id="mac-port">
    <title>Installing on &MacOS;-X</title>
    <indexterm>
      <primary>&MacOS;-X port</primary>
    </indexterm>

<note><para>Since June 2006 &krusader; is added into the 
            <ulink url="http://pdb.finkproject.org/pdb/package.php/krusader">&krusader; finkproject.org repository</ulink>
            Please check this url for the latest information about the &MacOS;-X port, 
            please read the &fink-url; documentation for more information, 
            all information below could be outdated, though they should still work :)
            From now on the port is maintained by 
            <ulink url="http://hritcu.wordpress.com/about/">Catalin Hritcu</ulink>.
</para></note>
    <para>Krusader is ported to &MacOS; thanks the &fink-url;-project and Jonas
    B&auml;hr and &bodo-tasche-url; .
    Unfortunately the only *stable* kdelib-binaries which
    &fink-url; has to offer is currenly 3.1.4 which
    means you need to use &krusader;-1.40 .
    Unfortunately the &MacOS; X &krusader;
    port does not have the same power as in a native
    &Linux;-&kde; environment. To run
    &krusader; you need also X11, which doesn't interact
    with the rest of the &MacOS; desktop. We hope that
    &Qt;4/&kde;4 will solve most of these
    problems. If you want a more recent Krusader version you need