useractions.docbook

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

    <listitem>
      <para>
      <userinput>Filter</userinput> - replaced by the panel's filter
      mask</para>
    </listitem>
    <listitem>
      <para>
      <userinput>Current</userinput> - replaced by the current
      item</para>
      <orderedlist>
        <listitem>
          <para>&useraction-optional-parameter; Omit the
          current path. &useraction-default; no</para>
        </listitem>
        <listitem>
          <para>&useraction-optional-parameter;
          Automatic escape spaces. &useraction-default;
          yes</para>
        </listitem>
      </orderedlist>
    </listitem>
    <listitem>
      <para>
      <userinput>List</userinput> - replaced by a list of all
      &lt;first parameter&gt;</para>
      <orderedlist>
        <listitem>
          <para>&useraction-parameter; Which items;
          either "All", "Selected", "Files" or "Dirs"</para>
        </listitem>
        <listitem>
          <para>&useraction-optional-parameter;
          Separator between the items.
          &useraction-default;
          "&nbsp;"</para>
        </listitem>
        <listitem>
          <para>&useraction-optional-parameter; Omit the
          current path. &useraction-default; no</para>
        </listitem>
        <listitem>
          <para>&useraction-optional-parameter;
          Filtermask (for all but "Selected").
          &useraction-default; *</para>
        </listitem>
        <listitem>
          <para>&useraction-optional-parameter;
          Automatic escape spaces. &useraction-default;
          yes</para>
        </listitem>
      </orderedlist>
    </listitem>
    <listitem>
      <para>
      <userinput>Select</userinput> - manipulates the selection in a
      panel</para>
      <orderedlist>
        <listitem>
          <para>&useraction-parameter; Filtermask</para>
        </listitem>
        <listitem>
          <para>&useraction-optional-parameter;
          manipulate in which way; either "Set", "Add" or "Remove".
          &useraction-default; "Set"</para>
        </listitem>
      </orderedlist>
    </listitem>
    <listitem>
      <para>
      <userinput>Goto</userinput> - changes the panels' path to
      &lt;first parameter&gt;</para>
      <orderedlist>
        <listitem>
          <para>&useraction-parameter; A relative or
          absolute path, or an URL</para>
        </listitem>
        <listitem>
          <para>&useraction-optional-parameter; Open the
          location in a new tab. &useraction-default;
          no</para>
        </listitem>
      </orderedlist>
    </listitem>
    <listitem>
      <para>
      <userinput>Ask</userinput> - asks the user for some text and
      is replaced by the answer</para>
      <orderedlist>
        <listitem>
          <para>&useraction-parameter; The
          Question</para>
        </listitem>
        <listitem>
          <para>&useraction-optional-parameter; A
          default answer</para>
        </listitem>
        <listitem>
          <para>&useraction-optional-parameter; A
          caption for the question box</para>
        </listitem>
      </orderedlist>
    </listitem>
    <listitem>
      <para>
      <userinput>Clipboard</userinput> - manipulates the
      clipboard</para>
      <orderedlist>
        <listitem>
          <para>&useraction-parameter; The text that
          should go to the clipboard (you may want to use
          "%aCurrent%" here)</para>
        </listitem>
        <listitem>
          <para>&useraction-optional-parameter; Append
          the text to the current content of the clipboard with
          this separator</para>
        </listitem>
      </orderedlist>
    </listitem>
    <listitem>
      <para>
      <userinput>Copy</userinput> - copies a file, useful for quick,
      local backups</para>
      <orderedlist>
        <listitem>
          <para>&useraction-parameter; What should be
          copied</para>
        </listitem>
        <listitem>
          <para>&useraction-parameter; Where it should
          be copied</para>
        </listitem>
      </orderedlist>
    </listitem>
    <listitem>
      <para>
      <userinput>Sync</userinput> - opens the Synchronizer with a
      given profile</para>
      <orderedlist>
        <listitem>
          <para>&useraction-parameter; A profile for the
          Synchronizer</para>
        </listitem>
      </orderedlist>
    </listitem>
    <listitem>
      <para>
      <userinput>NewSearch</userinput> - opens the search windows
      with a given profile</para>
      <orderedlist>
        <listitem>
          <para>&useraction-parameter; A profile for the
          search module</para>
        </listitem>
      </orderedlist>
    </listitem>
    <listitem>
      <para>
      <userinput>Profile</userinput> - loads a given panel
      profile</para>
      <orderedlist>
        <listitem>
          <para>&useraction-parameter; A panel
          profile</para>
        </listitem>
      </orderedlist>
    </listitem>
    <listitem>
      <para>
      <userinput>Each</userinput> - splits the commandline into a
      list. These commands are executed one after another.</para>
      <orderedlist>
        <listitem>
          <para>&useraction-parameter; A list item (all,
          all files, all dirs, all selected).</para>
        </listitem>
      </orderedlist>
    </listitem>
    <listitem>
      <para>
      <userinput>Move</userinput> - move from source to
      destination.</para>
      <orderedlist>
        <listitem>
          <para>&useraction-parameter; A source</para>
        </listitem>
        <listitem>
          <para>&useraction-parameter; A
          destination</para>
        </listitem>
      </orderedlist>
    </listitem>
    <listitem>
      <para>
      <userinput>PanelSize</userinput> - change the ratio between
      the two panels.</para>
      <orderedlist>
        <listitem>
          <para>&useraction-optional-parameter; A
          integer value, e.g., 80 makes the active panel use 80% of
          &krusader;'s width (height in vertical mode),
          omitting the parameter means 50%.</para>
        </listitem>
      </orderedlist>
    </listitem>
    <listitem>
      <para>
      <userinput>Ask</userinput> - cancel the execution.</para>
      <orderedlist>
        <listitem>
          <para>&useraction-optional-parameter; A string
          for the cancel question.</para>
        </listitem>
      </orderedlist>
    </listitem>
    <listitem>
      <para>
      <userinput>Script</userinput> - executes an external 
      <link linkend="javascript_console">
      Javascript</link> file.</para>
      <para>NOTE: This is still experimental and the interface may
      change, feedback is always welcome.</para>
      <orderedlist>
        <listitem>
          <para>&useraction-parameter; path to the
          external foo.js file, absolute path or relative to 
          <filename>
          &lt;kde-app-data&gt;/krusader/js/</filename>.
          &lt;kde-app-data&gt; is 
          <filename>$(kde-config
          --localprefix)/share/apps/</filename> or 
          <filename>$(kde-config --prefix)/share/apps/</filename>,
          for those who don't know where to copy the
          scripts/extensions. If all the needed files (normally 
          <filename>.js</filename> and maybe 
          <filename>.ui</filename>) are in one of these dirs it's
          sufficient to give the file name only as 1.
          parameter.</para>
        </listitem>
        <listitem>
          <para>&useraction-optional-parameter; a list
          of variables which should be set, like "return=cmd;
          a=lalala; b='%_Ask(..)'" so that the placeholder is
          replaced be the content of the variable cmd and the other
          two have already these values when the script
          starts.</para>
        </listitem>
      </orderedlist>
    </listitem>
    <listitem>
      <para>
      <userinput>ListFile</userinput> - is replaced by path/file name
      of a temporary file containing a list of items</para>
      <orderedlist>
        <listitem>
          <para>&useraction-parameter;
          path/filename</para>
        </listitem>
      </orderedlist>
    </listitem>
    <listitem>
      <para>
      <userinput>ColSort</userinput> - set the sorting on a column
      of a specific panel.</para>
      <orderedlist>
        <listitem>
          <para>&useraction-parameter; Column: Either
          "Name", "Ext", "Type", "Size", "Modified", "Perms",
          "rwx", "Owner" and "Group"</para>
        </listitem>
        <listitem>
          <para>&useraction-parameter; Sort sequence:
          Either "Toggle", "Asc", "Desc"</para>
        </listitem>
      </orderedlist>
    </listitem>
    <listitem>
      <para>
      <userinput>View</userinput> - set the view mode.</para>
      <orderedlist>
        <listitem>
          <para>&useraction-parameter; View mode: Either
          "generic", "text", "hex"</para>
        </listitem>
        <listitem>
          <para>&useraction-parameter; Window Mode:
          Either "tab", "window"</para>
        </listitem>
      </orderedlist>
    </listitem>
  </itemizedlist>A GUI-based helper for placeholder adding is
  provided. Spaces In Path, Current and List are by default,
  automatically escaped. There is one more important thing to know:
  All placeholders that interact with &krusader;
  internal functions are called at expand time (meaning directly
  when the placeholders are replaced). External programs are
  called at execution time (meaning after all placeholders are
  replaced).</para>
  <para>
    <emphasis role="bold">
      <guimenuitem>Advanced Properties</guimenuitem>
    </emphasis>
  </para>
  <para>Here you can configure where your command should be visible
  (for the right click menu) In addition, it is possible to change
  the command executed and confirm it separately. You can also set
  a user under which the command should be executed. 
  <itemizedlist>
    <listitem>
      <para>Configures if the action is valid for a Protocol, Path,
      Mime type or File name.</para>
    </listitem>
    <listitem>
      <para>Tweaking the command line before being executed.</para>
    </listitem>
    <listitem>
      <para>Set a different user for the execution (this has no
      effect in &krusader; internal functions)</para>
    </listitem>
  </itemizedlist></para>
</sect1>