<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="moreusage" xml:lang="it">

  <info>
   <link type="guide" xref="index#usage"/>
   <desc>More advanced usage information.</desc>
  </info>

  <title>Using <app>Kupfer</app> in Depth</title>

 <section>
  <title>Adding Applications and Scripts</title>
  <p>
   <app>Kupfer</app> will show all applications that are configured visible
   in your menu editor.
 </p>
 <p>
   If you want to add an application manually, you can create a new
   <code>.desktop</code> file and place it in one of the standard directories
   for applications, for example <file>~/.local/share/applications</file>,
   where <app>Kupfer</app> will find it. 
  </p>
  <p>Se si ha una raccolta di script che si vuole chiamare da <app>Kupfer</app>, si può aggiungere la cartella degli script come un directory di cataloghi a <app>Kupfer</app> nelle preferenze. Gli script che vengono aggiunti nel catalogo di <app>Kupfer</app> in questo modo possono essere eseguiti direttamente o nel terminale a condizione che siano eseguibili.</p>
  <p>
    You can also save command-lines by using the action <em>Add to
      Favorites</em>.
  </p>
 </section>

  <section>
    <title>Opening Files and Folders</title>
    <p>
      Using the action <em>Open</em>, files and folders are opened in their
      preferred application. The application associations can be changed,
      see <link xref="plugin-applications"/>.
    </p>
  </section>

  <section>
    <title>Show Hidden Files</title>
    <p>
      Use <keyseq><key>Alt</key><key>→</key></keyseq> instead of just
      <key>→</key> when descending into a directory to list hidden files too.
    </p>
  </section>

 <section>
   <title>The <em>Comma Trick</em></title>
    <p> The comma trick allows the user to use actions on many objects at
       the same time.
    </p>

    <p>Simply press comma <key>,</key> when an object is selected. The object
      is put on a "stack", and you can find yet another file or object, press
      comma to put it on the stack. When you subsequently invoke an action, the
      action is carried out on all of the objects at the same time.
    </p>

    <p>Some actions are only "multiplied" when used with many objects, other
      are smarter than that:</p>
    <list>
      <item><p> Selecting many files and using the Create Archive action, all
          files will be packed into the same archive.</p></item>
      <item><p>If you select multiple contacts and use a Send Email action, it
          creates one email directed at all the contacts.</p></item>
      <item><p>If you select multiple subcatalogs (For example Firefox
          Bookmarks and Epiphany Bookmarks) and use Search Contents.., you get
          a subcatalog search restricted to the objects of those two catalogs!
          You can even bind a trigger to this command(!) 
      </p></item>
    </list>
    <p>The comma trick is 
      <link href="http://www.43folders.com/2005/06/13/quicksilver-the-comma-trick">
        directly taken from Quicksilver</link>
      (the example given in the external article should work identically in
      Kupfer).
    </p>
  </section>

 <section>
  <title>Grab Current Selection</title>
  <p> To use the current selected text, from any application, with
    <app>Kupfer</app>, you can configure a global keyboard shortcut for the
    action <em>Show with Selection</em> in <app>Kupfer Preferences</app>.
  </p>
  <p>
   If configured, pressing the global keyboard shortcut
   will summon <app>Kupfer</app> with the current selection as the focused
   object.
  </p>
  <p>See <link xref="keyboard"/></p>
 </section>
  
 <section>
  <title>Command-line Connection</title>
  <p>
    The command <cmd>kupfer</cmd> on the command-line will focus
    <app>Kupfer</app> if it's already running, otherwise it will start it.
  </p>
  <p>
    The command <cmd>kupfer</cmd> can be used to send files or text from
    the command-line to <app>Kupfer</app>.

    For example, if you are using the shell in a directory where you have 
    a file called "report.pdf", you can focus this file in <app>Kupfer</app> by 
    running <cmd>kupfer report.pdf</cmd>. 
  </p>
  <p>
    You can also send text if you pipe the output of a command into
    <cmd>kupfer</cmd>.
  </p>
 </section>
  
 <section>
  <title>Gestione del contesto e della selezione corrente</title>
  <p>Se è stato individuato l'oggetto da utilizzare, quindi si richiama un'azione, <app>Kupfer</app> scompare per eseguire l'azione (per esempio avviare un programma o riprodurre un brano). Quando si ritorna a <app>Kupfer</app>, verrà mantenuto lo stesso oggetto e l'azione selezionata. Alcune azioni hanno senso di essere ripetute (come saltare ad un brano successivo) e può essere utile eseguire azioni differenti sullo stesso oggetto.</p>
  <p>
    However, you always have the top level catalog reachable when you 
    "come back" to <app>Kupfer</app> -- say you went into the subcatalog "Albums" 
    to browse your albums only; you select an album to play, and play it. 
    You come back with the album selected -- but your next search will still 
    go over the top level catalog, not just albums.
  </p>
  <p>Come tornare nel sotto catalogo in cui si era in precedenza? Si può fare semplicemente sfogliando e non cercando nuovamente l'elemento in <app>Kupfer</app>. Un modo veloce è quello di premere la freccia verso il basso o spazio per aprire la finestra di navigazione; è come dire "Voglio restare in questa sotto cartella". Con la finestra di navigazione aperta, la prossima interrogazione cercherà nel sotto catalogo corrente.</p>
  <p>In questo modo si può lavorare in entrambi i modi — si può rapidamente scendere nelle cartelle per trovare un file e quando si torna indietro per la prossima azione con <app>Kupfer</app> si può sia richiamare un oggetto qualsiasi dal livello superiore (iniziando a digitare), oppure rimanendo dove si era, scendendo in quella cartella (premere spazio, quindi digitare una interrogazione).</p>
 </section>

  <section>
    <title>Saving Commands as Files</title>
    <p>You can use keyboard shortcut for <em>Compose Command</em> (by
      default it is <keyseq><key>Ctrl</key><key>Return</key></keyseq>) to
      create a command object out of the currently focused command in
      Kupfer.  This object can be saved as a runnable file if you use the
      <em>Save As...</em> action.  The resulting file will can be executed
      when opened from the file manager (it requires that Kupfer is already
      running).
    </p>
  </section>
  <section>
    <title>Ignoring Accents</title>
    <p>
      You can find an object by an unaccented version of its name (this is
      more or less only implemented for latin-based alphabets).  For example
      an item named <em>Suð í</em> can be matched with <em>sud i</em>
      because the accent is removed and the ð transliterated to d.
    </p>
  </section>

</page>
