viewer-editor.docbook

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

<sect1 id="krviewer">
  <title>KrViewer: &krusader;'s internal
  viewer-editor</title>
  <indexterm>
    <primary>Viewer</primary>
    <seealso>Editor</seealso>
  </indexterm>
  <para>Pressing &Enter; on a selected file 
  <emphasis>opens the file with the associated
  application</emphasis>. The editor-viewer is tabbed, configure it
  on the &konfiggereral-lnk;</para>
  <sect2 id="krview">
    <title>Viewer</title>
    <para>To view a file as fast as possible according to its type,
    just put it under the cursor and press 
    <keycap>F3</keycap>. &krusader;'s internal viewer is
    actually a part of &konqueror;, which can basically
    view every file type viewable by &konqueror;
    (&eg; display pictures, play music, show the content
    of an archive). This is called the 'Generic viewer', for which
    you need to configure the mime types.</para>
    <para>The viewer works as follows: 
    <itemizedlist>
      <listitem>
        <para>It tries to view the file with the 
        <emphasis>'Generic viewer'.</emphasis></para>
      </listitem>
      <listitem>
        <para>When the file type (mime type) cannot be determined or
        when a file (&eg; a binary) doesn't have an
        associated action, it disables the 'generic viewer'. The
        file is treated as a text file, which is the 
        <emphasis>'Text viewer'</emphasis>.</para>
      </listitem>
      <listitem>
        <para>The user can change in the 
        <link linkend="kredit_krviewer_menu">KrViewer
        menu</link> between: 'Generic viewer' (if available), 'Text
        viewer' and 
        <emphasis>'Hex viewer'</emphasis>.</para>
      </listitem>
    </itemizedlist>You can configure the default viewer mode on the
    &konfiggereral-lnk; .</para>
    <para>
    <keycombo action="simul">&Shift;
    <keycap>F3</keycap></keycombo>views a &URL; on
    demand, &eg;: 
    <itemizedlist>
      <listitem>
        <para>
        <userinput>
          <command>man:/</command>
        </userinput>views the manpages.</para>
      </listitem>
      <listitem>
        <para>
        <userinput>
          <command>man:/</command>
          <replaceable>krusader</replaceable>
        </userinput>views a manpage.</para>
      </listitem>
      <listitem>
        <para>
        <userinput>
          <command>info:/</command>
        </userinput>views the infopages.</para>
      </listitem>
      <listitem>
        <para>
        <userinput>
          <command>http://</command>
          <replaceable>krusader.sourceforce.net/</replaceable>
        </userinput>views a webpage.</para>
      </listitem>
      <listitem>
        <para>
        <userinput>
          <command>ftp://</command>
          <replaceable>ftp.kde.org/pub/kde/</replaceable>
        </userinput>views a ftp-server.</para>
      </listitem>
      <listitem>
        <para>
        <userinput>
          <command>sftp://</command>
          <replaceable>sftp.foo/</replaceable>
        </userinput>views a secure ftp-server.</para>
      </listitem>
      <listitem>
        <para>
        <userinput>
          <command>file:/</command>
          <replaceable>home/frank</replaceable>
        </userinput>views the homedirectory of Frank.</para>
      </listitem>
      <listitem>
        <para>
        <userinput>
          <replaceable>/home/frank/archive.tar.gz</replaceable>
        </userinput>views a 
        <literal role="extension">tar.gz</literal> archive.</para>
      </listitem>
    </itemizedlist></para>
    <para>KrViewer can have the following menus: 
    <link linkend="kredit_file_menu">File</link>, 
    <link linkend="kredit_edit_menu">Edit</link>, 
    <link linkend="kredit_view_menu">View</link>, 
    <link linkend="kredit_settings_menu">Settings</link> and 
    <link linkend="kredit_krviewer_menu">Krviewer</link>, depending
    on which file type is viewed. They will be discussed in the 
    <link linkend="kredit">Editor section</link>. The internal
    viewer can follow links on HTML pages. With 
    <keycombo action="simul">&Ctrl;
    <keycap>E</keycap></keycombo> the viewer can start
    &krusader;'s internal editor (which is basically the
    same application).</para>
    <note>
      <para>The embedded viewer is not written by us, it is
      supplied via &kde; (libs) and
      &kioslaves1-url; We cannot and do not want to
      change it, usings these libraries reduces the amount of
      written code. So we do not have to reinvent the wheel
      ;-)</para>
    </note>
  </sect2>
  <sect2 id="kredit">
    <title>Editor</title>
    <indexterm>
      <primary>Editor</primary>
    </indexterm>
    <para>&krusader;'s internal editor has almost
    everything that you can expect of an editor. Editing is similar
    to viewing but with the 
    <keycap>F4</keycap> key. The default editor is
    &krusader;'s internal editor. You can change the
    default editor in the &konfiggereral-lnk;, if you
    prefer to use an external editor.</para>
    <tip>
      <para>When you use &krusader;'s internal editor
      for the first time, it is recommended to look at each section
      of the 
      <link linkend="kredit_settings_menu">Settings</link>menu, and
      configure it the way you want it.</para>
    </tip>
  </sect2>
  <sect2 id="kredit_menus">
    <title>Menu overview</title>
    <para>Most of the menus are quite self-explanatory. ;-)</para>
    <!-- FILE menu -->
    <variablelist id="kredit_file_menu">
      <title>
      <guimenu>File</guimenu>menu</title>
      <varlistentry>
        <term>
          <menuchoice>
            <shortcut>
              <keycombo action="simul">&Ctrl;
              <keycap>S</keycap></keycombo>
            </shortcut>
            <guimenu>File</guimenu>
            <guimenuitem>Save</guimenuitem>
          </menuchoice>
        </term>
        <listitem>
          <para>Save file.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <menuchoice>
            <guimenu>File</guimenu>
            <guimenuitem>Save As</guimenuitem>
          </menuchoice>
        </term>
        <listitem>
          <para>Save file with another name.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <menuchoice>
            <shortcut>
              <keycap>F5</keycap>
            </shortcut>
            <guimenu>File</guimenu>
            <guimenuitem>Reload</guimenuitem>
          </menuchoice>
        </term>
        <listitem>
          <para>Reload file.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <menuchoice>
            <guimenu>File</guimenu>
            <guimenuitem>Export</guimenuitem>
          </menuchoice>
        </term>
        <listitem>
          <para>Export the file to 
          <literal role="extension">HTML</literal> format.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <menuchoice>
            <shortcut>
              <keycombo action="simul">&Ctrl;
              <keycap>P</keycap></keycombo>
            </shortcut>
            <guimenu>File</guimenu>
            <guimenuitem>Print</guimenuitem>
          </menuchoice>
        </term>
        <listitem>
          <para>Print the file.</para>
        </listitem>
      </varlistentry>
    </variablelist>
    <!-- EDIT menu -->
    <variablelist id="kredit_edit_menu">
      <title>
      <guimenu>Edit</guimenu> menu</title>
      <varlistentry>
        <term>
          <menuchoice>
            <shortcut>
              <keycombo action="simul">&Ctrl;
              <keycap>Z</keycap></keycombo>
            </shortcut>
            <guimenu>Edit</guimenu>
            <guimenuitem>Undo</guimenuitem>
          </menuchoice>
        </term>
        <listitem>
          <para>Undo last action.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <menuchoice>
            <shortcut>
              <keycombo action="simul">
              &Ctrl;&Shift;
              <keycap>Z</keycap></keycombo>
            </shortcut>
            <guimenu>Edit</guimenu>
            <guimenuitem>Redo</guimenuitem>
          </menuchoice>
        </term>
        <listitem>
          <para>Redo last action.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <menuchoice>
            <shortcut>
              <keycombo action="simul">&Ctrl;
              <keycap>X</keycap></keycombo>
            </shortcut>
            <guimenu>Edit</guimenu>
            <guimenuitem>Cut</guimenuitem>
          </menuchoice>
        </term>
        <listitem>
          <para>Cut selected text to clipboard.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <menuchoice>
            <shortcut>
              <keycombo action="simul">&Ctrl;
              <keycap>C</keycap></keycombo>
            </shortcut>
            <guimenu>Edit</guimenu>
            <guimenuitem>Copy</guimenuitem>
          </menuchoice>
        </term>
        <listitem>
          <para>Copy selected text to clipboard.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <menuchoice>
            <shortcut>
              <keycombo action="simul">&Ctrl;
              <keycap>V</keycap></keycombo>
            </shortcut>
            <guimenu>Edit</guimenu>
            <guimenuitem>Paste</guimenuitem>
          </menuchoice>
        </term>
        <listitem>
          <para>Paste clipboard content to the document.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <menuchoice>
            <shortcut>
              <keycombo action="simul">&Ctrl;
              <keycap>A</keycap></keycombo>
            </shortcut>
            <guimenu>Edit</guimenu>
            <guimenuitem>Select All</guimenuitem>
          </menuchoice>
        </term>
        <listitem>
          <para>Select whole document.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <menuchoice>
            <shortcut>
              <keycombo action="simul">
              &Ctrl;&Shift;
              <keycap>A</keycap></keycombo>
            </shortcut>
            <guimenu>Edit</guimenu>
            <guimenuitem>Deselect</guimenuitem>
          </menuchoice>
        </term>
        <listitem>
          <para>Deselect current selection.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <menuchoice>
            <shortcut>
              <keycombo action="simul">
              &Ctrl;&Shift;
              <keycap>B</keycap></keycombo>
            </shortcut>
            <guimenu>Edit</guimenu>
            <guimenuitem>Block Selection Mode</guimenuitem>
          </menuchoice>
        </term>
        <listitem>
          <para>Toggle Block Selection, which will
          activate/deactivate the block selection
          possibility.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <menuchoice>
            <shortcut>
              <keycap>Insert</keycap>
            </shortcut>
            <guimenu>Edit</guimenu>
            <guimenuitem>Overwrite Mode</guimenuitem>
          </menuchoice>
        </term>
        <listitem>
          <para>Toggle Insert/Overwrite Mode.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <menuchoice>
            <shortcut>
              <keycombo action="simul">&Ctrl;
              <keycap>F</keycap></keycombo>
            </shortcut>
            <guimenu>Edit</guimenu>
            <guimenuitem>Find</guimenuitem>
          </menuchoice>
        </term>
        <listitem>
          <para>Find text.</para>