installation.docbook

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

>If <command
>./configure</command
> was successful and <command
>make</command
> failed for some reason, continue to read this page. If you can't find any solution for your problem then feel free to post a help request at our &forum_lnk;.</para>

    <!-- Empty line to make it more readable -->
</listitem>


<listitem>
 <para
>If nothing went wrong, 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>

    <!-- Empty line to make it more readable -->
    <!-- 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: if you want you can clean up to save some diskspace. Note: in this case all the 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>

    <!-- Empty line to make it more readable -->
    <!-- Empty line to make it more readable (second line is needed) -->
</listitem>


<listitem>
  <para
>If you ever want to uninstall &krusader;, just 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 encounter problems with installing &krusader; please read first the &faq_lnk;. If this installation procedure and the FAQ does not solve the problem, feel free to ask for help with an &help_request_lnk;.</para>

</sect2>


</sect1>



<sect1 id="mac-port">
<title
>&MacOS;-x port</title>

<para
>Krusader is ported to &MacOS; thanks to 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 doesn't have the same power as in a native &Linux;-&kde; environement. To run &krusader; you need also X11 which doesn't realy interact with the rest of the &MacOS; desktop (drag and drop, etc...) We hope that &Qt;4/&kde;4 will solve most of these problems. When you want a higher Krusader version than you need to compile &kde; , what is not so difficult with &fink_url; 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
>If you like to compile more sourcecode or if you want to use a more recent &krusader; version then these are the installation instructions. <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.60.0.fink.darwin-ppc.tar.bz2</filename
> is available</para>
  </listitem>

 </orderedlist>
</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
>Don't 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
>Configure &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>

</appendix>