<?xml version="1.0" encoding="utf-8"?>
<sect2 id="getting-started-starting">
      <title>Avviare <application>Strumento di configurazione Caja-Actions</application></title>
      <para>È possibile avviare <application>Strumento di configurazione Caja-Actions</application> nei modi seguenti:</para>
      <variablelist>
        <varlistentry>
          <term><guimenu>Sistema</guimenu> menù</term>
          <listitem>
            <para>Selezionare <menuchoice><guisubmenu>Preferenze</guisubmenu><guisubmenu>Aspetto</guisubmenu><guimenuitem>Strumento di configurazione Caja-Actions</guimenuitem></menuchoice>.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Riga di comando</term>
          <listitem>
            <para>Per eseguire <application>Strumento di configurazione Caja-Actions</application> dalla riga di comando, digitare il seguente comando:</para>
            <para>
              <command><filename>caja-actions-config-tool</filename></command>
            </para>
            <para>quindi premere <keycap>Invio</keycap>.</para>
            <tip>
              <para>Per visualizzare le opzioni dalla riga di comando, digitare:</para>
              <para>
                <command>
                  <filename>caja-actions-config-tool</filename>
                  <option>--help-all</option>
                </command>
              </para>
              <para>quindi premere <keycap>Invio</keycap>.</para>
            </tip>
          </listitem>
        </varlistentry>
      </variablelist>

    <sect2 id="getting-started-first-run">
      <title>La prima esecuzione</title>
      <para>Quando si avvia <application>Strumento di configurazione Caja-Actions</application>, viene visualizzata la seguente finestra.</para>
      <figure id="cact-FIG-main-empty">
        <title>Finestra di avvio di <application>Strumento di configurazione Caja-Actions</application></title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/cact-main-empty.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Mostra la finestra principale di <application>Strumento di configurazione Caja-Actions</application>. Contiene la barra dei menù, la barra degli strumenti, l'area di visualizzazione, un elenco degli elementi vuoto sulla sinistra, diverse schede per le proprietà disabilitate e una barra di stato.</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </figure>

      <!-- Include any descriptions of the GUI immediately after the screenshot
           of the main UI, for example, the items on the menubar and on the toolbar.
           This section is optional. -->

      <para>La finestra principale di <application>Strumento di configurazione Caja-Actions</application> contiene i seguenti elementi:</para>
      <variablelist>
        <varlistentry>
          <term>Barra dei menù.</term>
          <listitem>
            <para>La barra dei menù contiene tutti i comandi necessari per l'utilizzo di <application>Strumento di configurazione Caja-Actions</application>.</para>
            <para>Le scorciatoie disponibili per alcuni comandi:</para>
            <variablelist>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Ctrl</keycap>
                      <keycap>N</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Crea una nuova azione.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Ctrl</keycap>
                      <keycap>S</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Salva le azioni ed i menù modificati.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Ctrl</keycap>
                      <keycap>Q</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Esce dall'applicazione.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Ctrl</keycap>
                      <keycap>X</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Taglia la selezione corrente, mantenendola negli appunti.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Ctrl</keycap>
                      <keycap>C</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Copia la selezione corrente negli appunti.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Ctrl</keycap>
                      <keycap>V</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Inserisce il contenuto degli appunti prima dell'elemento corrente.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Maiusc</keycap>
                      <keycap>Ctrl</keycap>
                      <keycap>V</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Inserisce il contenuto degli appunti come sotto-elementi dell'elemento corrente.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Elimina</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Elimina la selezione corrente.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>F5</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Carica nuovamente i menù e le azioni.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>F1</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Mostra l'aiuto.</para>
                </listitem>
              </varlistentry>
            </variablelist>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Barra degli strumenti.</term>
          <listitem>
            <para>Possono essere visualizzate diverse barre degli strumenti sotto la barra dei menù, in base alle vostre scelte nel sottomenù <menuchoice><guimenu>Vista</guimenu><guimenuitem>Barre degli strumenti</guimenuitem></menuchoice>.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Elenco degli elementi.</term>
          <listitem>
            <para>L'elenco sulla sinistra della finestra principale contiene tutti gli elementi, che siano azioni o menù, attualmente disponibili per la modifica in <application>Strumento di configurazione Caja-Actions</application>.</para>
            <para>Gli elementi possono essere ordinati in ordine alfabetico crescente o decrescente, oppure non essere ordinati affatto, essendo organizzati e gestiti direttamente dall'utente.</para>
            <para>i elementi non validi saranno mostrati in colore rosso.</para>
            <para>Gli elementi modificati saranno mostrati con il carattere corsivo.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>ulsanti di ordinamento.</term>
          <listitem>
            <para>Tre pulsanti che consentono di alternare tra le modalità di ordinamento disponibili.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Le schede delle proprietà.</term>
          <listitem>
            <para>La parte destra della finestra principale mostra  tutto ciò che serve per definire come, quando e dove dovrebbero essere visualizzate le azioni e i menù.</para>
            <variablelist>
              <varlistentry>
                <term>Azione/Menù</term>
                <listitem>
                  <para>Definisce in quale menù di <productname>Caja</productname> dovrebbe comparire l'elemento, e come sarà visualizzato.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>Comando</term>
                <listitem>
                  <para>Specifica quale comando eseguire, e quali parametri passargli.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>Esecuzione</term>
                <listitem>
                  <para>Specifica come dovrebbe essere eseguito il comando.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>Nomi-base</term>
                <listitem>
                  <para>Definisce i filtri di nomi-base che la selezione di <productname>Caja</productname> deve soddisfare perché l'azione o il menù sia candidato per la visualizzazione.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>Tipi mime</term>
                <listitem>
                  <para>Definisce i filtri di tipo mime che la selezione di <productname>Caja</productname> deve soddisfare perché l'azione o il menù sia candidato per la visualizzazione.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>Cartelle</term>
                <listitem>
                  <para>Definisce i filtri per le cartelle che la selezione di <productname>Caja</productname> deve soddisfare perché l'azione o il menù sia candidato per la visualizzazione.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>Schemi</term>
                <listitem>
                  <para>Definisce i filtri degli schemi che la selezione di <productname>Caja</productname> deve soddisfare perché l'azione o il menù sia candidato per la visualizzazione.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>Capacità</term>
                <listitem>
                  <para>Definisce i filtri delle capacità che la selezione di <productname>Caja</productname> deve soddisfare perché l'azione o il menù sia candidato per la visualizzazione.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>Ambiente</term>
                <listitem>
                  <para>Definisce alcune condizioni di ambiente che la selezione di <productname>Caja</productname> deve soddisfare perché l'azione o il menù sia candidato per la visualizzazione.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>Proprietà</term>
                <listitem>
                  <para>Mostra le proprietà dell'elemento.</para>
                </listitem>
              </varlistentry>
            </variablelist>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Barra di stato.</term>
          <listitem>
            <para>La barra di stato mostra alcune informazioni sullo stato della riga attualmente selezionata nell'elenco degli elementi.</para>
            <para>Quando non ci sono informazioni rilevanti da mostrare, la barra di stato visualizza il conteggio dei menù, delle azioni e dei profili caricati.</para>
            <para>L'icona  di « sola-lettura » <inlinegraphic fileref="figures/read-only.png"/> viene visualizzata sulla destra della barra di stato quando è opportuno.</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>

    <sect2 id="getting-started-first-action">
      <title>Creare la vostra prima azione</title>
      <para>In questo esempio, mostreremo come creare una azione che mostra alcune interessanti informazioni sulla selezione corrente.</para>
      <formalpara>
        <title>Verifica dei prerequisiti</title>
        <para>Questa azione richiede <productname>MateDialog</productname>.</para>
      </formalpara>
      <para><productname>MateDialog</productname> è un programma che consente di creare un'interfaccia utente grafica dalla linea dei comandi.</para>
      <para>Si dovrebbe verificare che questo programma sia installato sul sistema, digitando ad esempio in un terminale il comando seguente:</para>
      <para>
        <command>
          <filename>matedialog</filename>
        </command>
      </para>
      <para>quindi premere <keycap>Invio</keycap>.</para>
      <formalpara>
        <title>Creare l'azione</title>
        <para>Per creare una nuova azione, selezionare <menuchoice><shortcut><keycombo><keycap>Ctrl</keycap><keycap>N</keycap></keycombo></shortcut><guimenu>File</guimenu><guisubmenu>Nuova azione</guisubmenu></menuchoice>.</para>
      </formalpara>
      <para>Verrà inserita una nuova azione nell'elenco degli elementi, e le sue proprietà saranno mostrate nelle schede sul pannello di destra.</para>
      <para>L'etichetta dell'azione attualmente modificata (quella creata) viene aggiunta al nome dell'applicazione nella barra del titolo.</para>
      <figure id="cact-FIG-tab-action">
        <title>Azioni predefinite della nuova azione</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/cact-action-tab.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Mostra le proprietà predefinite di una azione appena creata.</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </figure>
      <para>in <guilabel>Elenco degli elementi</guilabel>, la nuova azione comparirà in caratteri corsivi.</para>
      <para>Il carattere corsivo è impiegato come promemoria per indicare che l'elemento non è stato salvato.</para>
      <para>Come altro avviso che ci sono modifiche in attesa, un asterisco (« <literal>*</literal> ») viene anteposto al nome dell'applicazione sulla barra del titolo.</para>
      <formalpara>
        <title>Qualificare la vostra nuova azione</title>
        <para>Consiste semplicemente nello scegliere come verrà visualizzata la vostra azione nel menù contestuale del file manager.</para>
      </formalpara>
      <itemizedlist>
        <listitem>
          <para>Inserire <userinput>La mia prima azione</userinput> nella campo <guilabel>Etichetta del contesto</guilabel>.</para>
          <para>Il campo <guilabel>Etichetta del contesto</guilabel> contiene l'etichetta dell'azione come la si vuole mostrata nel menù contestuale del file manager.</para>
         <para>L'etichetta è una proprietà obbligatoria della vostra azione. Se dovesse essere vuota, la vostra azione sarebbe considerata non valida da <productname>Caja-Actions</productname>: Sarebbe mostrata in rosso in <guilabel>Elenco degli elementi</guilabel> e non sarebbe mai candidata per la visualizzazione nei menù contestuali del file manager.</para>
        </listitem>
        <listitem>
          <para>Inserire <userinput>Questo eseguirà una azione con alcuni parametri.</userinput> nella campo <guilabel>Suggerimento</guilabel>.</para>
          <para>Il campo <guilabel>Suggerimento</guilabel> contiene il testo che si vuole mostrare come aiuto sintetico per la vostra azione.</para>
        </listitem>
        <listitem>
          <para>Selezionare <inlinegraphic fileref="figures/stock-icon-about.png"/> nel menù a tendina <guilabel>Icona</guilabel>.</para>
          <para>La selezione <guilabel>Icona</guilabel> definisce l'icona che si vuole associare alla vostra azione nei menù contestuali del file manager e sulla barra degli strumenti.</para>
          <para>Ci sono due possibilità per poter scegliere l'icona associata alla vostra azione:</para>
          <itemizedlist>
            <listitem>
              <para>Fare clic sul menù a tendina <guilabel>Icona</guilabel> per selezionare un'icona.</para>
            </listitem>
            <listitem>
              <para>Fare clic su <guibutton>Esplora</guibutton> per cercare un'immagine nel file system.</para>
            </listitem>
          </itemizedlist>
        </listitem>
      </itemizedlist>
      <formalpara>
        <title>Specificare il comando da eseguire</title>
        <para>Quando selezionerete la vostra azione dal menù contestuale del file manager, questa verrà eseguita con argomenti a vostra scelta.</para>
      </formalpara>
      <para>Fare clic sulla scheda <guilabel>Comando</guilabel> per mostrare la pagina che consentirà di inserire il comando.</para>
      <figure id="cact-FIG-tab-command">
        <title>Pagina del comando</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/cact-command-tab.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Mostra la scheda del comando. Questa scheda contiene il nome del profilo, il comando da eseguire assieme ai suoi parametri, e la configurazione della cartella di lavoro di partenza.</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </figure>
      <itemizedlist>
        <listitem>
          <para>Inserire <userinput>matedialog</userinput> nella campo <guilabel>Percorso</guilabel>.</para>
          <para>Il campo <guilabel>Percorso</guilabel> definisce il comando che verrà eseguito quando si seleziona la vostra azione dal menù contestuale del file manager.</para>
          <para>Ci sono due modi per definire il comando da eseguire:</para>
          <itemizedlist>
            <listitem>
              <para>Inserirlo nel campo <guilabel>Percorso</guilabel>.</para>
            </listitem>
            <listitem>
              <para>Fare clic su <guibutton>Esplora</guibutton> per selezionare il file l'eseguibile sul file system.</para>
            </listitem>
          </itemizedlist>
          <para>Se il comando inserito non ha un percorso assoluto, esso sarà cercato secondo la variabile <envar>PATH</envar> al momento della sua esecuzione.</para>
        </listitem>
        <listitem>
          <para>Inserire <userinput>--info --text='%c elementi selezionati: %U'</userinput> nella campo <guilabel>Parametri</guilabel>.</para>
          <para><guilabel>Parametri</guilabel> contiene gli argomenti che saranno passati al vostro comando quando verrà eseguito. Questi possono essere parametri incorporati che saranno espansi al runtime.</para>
          <para>Se <guilabel>Percorso</guilabel> e <guilabel>Parametri</guilabel> sono entrambi vuoti, la vostra azione non sarà considerata valida: verrà mostrata in rosso in <guilabel>Elenco degli elementi</guilabel> e non sarà mai candidata per la visualizzazione nei menù contestuali del file manager.</para>
        </listitem>
      </itemizedlist>
      <formalpara>
        <title>Salvataggio</title>
        <para>Per salvare tutte le modifiche apportate, selezionare <menuchoice><shortcut><keycombo><keycap>Ctrl</keycap><keycap>S</keycap></keycombo></shortcut><guimenu>File</guimenu><guisubmenu>Salva</guisubmenu></menuchoice>.</para>
      </formalpara>
      <para><productname>Caja</productname> prende automaticamente in considerazione la vostra nuova azione, e la visualizza nel suo menù contestuale.</para>
      <figure id="cact-FIG-start-caja-context">
        <title>La vostra prima azione nel menù contestuale di <productname>Caja</productname></title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/start-context-menu-caja.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Mostra la prima azione nel menù contestuale di <productname>Caja</productname>.</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </figure>
      <para>Fare clic sull'elemento nel menù contestuale di <productname>Caja</productname> lo attiva, d esegue il corrispondente comando.</para>
      <figure id="cact-FIG-start-matedialog">
        <title>Il risultato dell'esecuzione del vostro primo comando</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/start-matedialog-result.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Mostra il risultato dell'esecuzione del la vostra prima azione. Questa è la finestra di dialogo di <productname>MateDialog</productname>, che mostra l'URI dell'elemento selezionato.</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </figure>
    </sect2>
    </sect2>
