<?xml version="1.0" encoding="utf-8"?>
<?db.chunk.max_depth 3?>
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:db="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="tools" xml:lang="it">
    <info><title>Strumenti e utilità</title></info>

  <highlights>
    <para>Questa sezione descrive alcuni strumenti ed utilità del Desktop MATE.</para>
  </highlights>

  <section xml:id="tools-run-app"><info><title>Esecuzione di applicazioni</title></info>
    <!-- preserve id for backwards compatibility: 2.12 -->
    <anchor xml:id="gospanel-23"/>
    <indexterm><primary>Finestra di dialogo Esegui applicazione, utilizzo</primary></indexterm>
    <para>La finestra di dialogo <guilabel>Esegui applicazione</guilabel> consente l'accesso alla riga di comando. Quando si esegue un comando nel dialogo <guilabel>Esegui applicazione</guilabel>, non è possibile ricevere l'output dal programma.</para>
    <para>Per eseguire un comando dalla riga di comando, procedere come segue:</para>
    <orderedlist>
      <listitem>
        <para>Aprire la finestra di dialogo <guilabel>Esegui applicazione</guilabel> in uno dei modi seguenti: <variablelist>
          <varlistentry><term>Da un pannello</term>
          <listitem><para>È possibile aggiungere il pulsante <application>Esegui applicazione</application> ad un qualsiasi pannello. Consultare <xref linkend="panels-addobject"/>. Fare clic sul pulsante <guibutton>Esegui applicazione</guibutton> per aprire la  finestra di dialogo <guilabel>Esegui applicazione</guilabel>.</para></listitem></varlistentry>
          <varlistentry><term>Usando i tasti scorciatoia</term>
          <listitem>
            <para>Premere <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo>. È possibile modificare i tasti scorciatoia che mostrano la finestra di dialogo <guilabel>Esegui applicazione</guilabel> dallo strumento <application><xref linkend="prefs-keyboard-shortcuts"/></application>.</para>
          </listitem>
          </varlistentry>
        </variablelist></para>
      <para>Viene mostrata la finestra di dialogo <guilabel>Esegui applicazione</guilabel>.</para>
    </listitem>
    <listitem>
      <para>Inserire il comando che si vuole eseguire nel campo vuoto, oppure scegliere una voce dall'elenco delle applicazioni note.</para>
      <para>Se si inserisce solo la posizione di un file, verrà avviata una applicazione appropriata per aprire quel tipo di file. Se si inserisce un indirizzo web, il vostro browser web predefinito aprirà la pagina specificata. Anteponete all'indirizzo web il prefisso https://, come in https://mate-desktop.org</para>
      <para>Per scegliere un comando che si è eseguito in precedenza, fare clic sul pulsante freccia accanto al campo del comando, quindi scegliere il comando da eseguire.</para>
      <para>È anche possibile utilizzare il pulsante <guibutton>Esegui con file</guibutton> per scegliere un file da accodare alla riga di comando. Per esempio, è possibile inserire <application>emacs</application> come comando, quindi scegliere il file da modificare.</para>
      <para>Selezionare l'opzione <guilabel>Esegui nel terminale</guilabel> per eseguire l'applicazione o il comando in una finestra di terminale. Scegliere questa opzione per i comandi che non creano una finestra per la loro esecuzione.</para>
    </listitem>
    <listitem>
      <para>Fare clic sul pulsante <guibutton>Esegui</guibutton> nella finestra di dialogo <guilabel>Esegui applicazione</guilabel>.</para>
    </listitem>
      </orderedlist>
  </section>

<section xml:id="tools-screenshot"><info><title>Cattura delle schermate</title></info>
  <!-- preserve id for backwards compatibility: 2.12 -->
  <anchor xml:id="goseditmainmenu-53"/>
  <indexterm><primary>schermate, cattura</primary></indexterm>
  <para>È possibile catturare una schermata in uno dei modi seguenti:</para>
  <itemizedlist>
    <listitem>
      <para>Da un qualsiasi pannello</para>
      <para>È possibile aggiungere un pulsante <application>Cattura schermata</application> ad un qualsiasi pannello. Consultare <xref linkend="panels-addobject"/> per le istruzioni su come fare. Fare clic sul pulsante <guibutton>Cattura schermata</guibutton> per catturare un'istantanea dell'intero schermo.</para>
    </listitem>
    <listitem>
      <para>Usando i tasti scorciatoia</para>
      <para>Per catturare una schermata, usare i seguenti tasti scorciatoia:</para>
      <informaltable frame="topbot">
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colname="colspec0" colwidth="35.67*"/>
          <colspec colname="colspec1" colwidth="64.33*"/>
          <thead>
            <row rowsep="1">
              <entry>
                <para>Tasti scorciatoia predefiniti</para>
              </entry>
              <entry>
                <para>Funzione</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec0" valign="top">
                <para><keycap>Stampa dello schermo</keycap></para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Cattura un'istantanea dell'intero schermo.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para><keycombo><keycap>Alt</keycap><keycap>Stamp</keycap></keycombo></para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Cattura una schermata della finestra attiva.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
      <para>È possibile utilizzare lo strumento <application><xref linkend="prefs-keyboard-shortcuts"/></application> per modificare i tasti scorciatoia predefinite.</para>
    </listitem>
    <listitem>
      <para>Dalla barra dei menù</para>
      <para>Selezionare <menuchoice><guimenu>Applicazioni</guimenu><guimenuitem>Accessori</guimenuitem><guimenuitem>Cattura schermata</guimenuitem></menuchoice>.</para>
    </listitem>
    <listitem>
      <para>Dal terminale</para>
      <para>È possibile usare il commando <command>mate-screenshot</command> per catturare una schermata. Il comando <command>mate-screenshot</command> cattura una schermata dell'intero schermo e mostra la finestra di dialogo <guilabel>Salvataggio della schermata</guilabel>. Utilizzare la finestra di dialogo <guilabel>Salvataggio della schermata</guilabel> per salvare la schermata.</para>
      <para>È anche possibile usare alcune opzioni assieme al comando <command>mate-screenshot</command>, come indicato di seguito:</para>
      <informaltable frame="topbot">
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colname="colspec0" colwidth="35.67*"/>
          <colspec colname="colspec1" colwidth="64.33*"/>
          <thead>
            <row rowsep="1">
              <entry>
                <para>Opzione</para>
              </entry>
              <entry>
                <para>Funzione</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec0" valign="top">
                <para><command>--window</command></para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Cattura un'istantanea della finestra che ha il focus.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para><command>--delay=<replaceable>secondi</replaceable></command></para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Cattura una schermata dopo il numero di secondi specificato e mostra la finestra di dialogo <guilabel>Salvataggio della schermata</guilabel>. Utilizzare la finestra di dialogo <guilabel>Salvataggio della schermata</guilabel> per salvare la schermata.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para><command>--include-border</command></para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Cattura una schermata includendo il bordo della finestra.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para><command>--remove-border</command></para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Cattura una schermata escludendo il bordo della finestra.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para><command>--border-effect=shadow</command></para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Cattura una schermata e aggiunge un'ombraggiatura attorno ad essa.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para><command>--border-effect=border</command></para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Cattura una schermata e aggiunge un bordo attorno ad essa. </para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para><command>--interactive</command></para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Apre una finestra che consente di impostare alcune opzioni prima di catturare la schermata.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para><command>--help</command></para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Mostra le opzioni per il comando.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
    </listitem>
  </itemizedlist>

  <para>Quando si cattura un'istantanea, viene aperta la finestra di dialogo <guilabel>Salvataggio della schermata</guilabel>. Per salvare la schermata come un file di immagine, inserire il nome del file per la schermata, scegliere una posizione dall'elenco a discesa e fare clic su <guilabel>Salva</guilabel>. È anche possibile usare il pulsante <guilabel>Copia negli appunti</guilabel> per copiare l'immagine negli appunti o trasferirla in un'altra applicazione con un trascinamento.</para>
  
</section>

<!-- ============= Yelp ============================= -->
<section xml:id="yelp"><info><title>Visualizzatore di documentazione Yelp</title></info>
  <indexterm><primary>Yelp</primary></indexterm>
  <!-- ============= Introduction ============================== -->

  <section xml:id="yelp-introduction"><info><title>Introduzione</title></info>
    <para><application>Yelp Help Brower</application> consente di visualizzare la documentazione relativa a MATE e ad altri componenti, fornita in diversi formati. Tali formati includono i file docbook, le pagine di aiuto in HTML, le pagine man e le pagine info (il supporto alle pagine man e info è compilato opzionalmente). Indipendentemente dai diversi formati supportati, Yelp cerca di fornire un aspetto uniforme per tutti i formati.</para>

    <para><application>Yelp Help Browser</application> è capace di supportare la visualizzazione della documentazione nelle diverse lingue. I documenti devono essere tradotti per ciascuna lingua ed essere correttamente installati perché il Visualizzatore Yelp possa vederli.</para>
  </section>

  <!-- ============= Getting Started  ================================ -->

  <section xml:id="yelp-getting-started"><info><title>Avviare Yelp</title></info>
  
    <section><info><title>Avviare <application>Yelp Help Browser</application></title></info>
      <para>È possibile avviare <application>Yelp Help Browser</application> nei modi seguenti:</para>

      <para><variablelist>
          <varlistentry>
            <term>Menù <guimenu>Sistema</guimenu></term>

            <listitem>
              <para>Selezionare <application>Aiuto</application></para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>Riga di comando</term>

            <listitem>
              <para>Eseguire il seguente comando: <command>yelp</command></para>
            </listitem>
          </varlistentry>
        </variablelist></para>
    </section>

    <section><info><title>Interfaccia</title></info>
      <para>Quando si avvia il <application>Yelp Help Browser</application>, viene mostrata la seguente finestra.</para>

      <para><figure xml:id="fig-yelp-window"><info><title>Finestra di <application>Yelp Help Browser</application></title></info>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_window.png"/>
            </imageobject>
          </mediaobject>
        </figure><application>Yelp Help Browser</application> contiene i seguenti elementi in <xref linkend="fig-yelp-window"/></para>

      <variablelist>
        <varlistentry>
          <term><interface>Barra dei menù</interface></term>

          <listitem>
            <para><variablelist>
                <varlistentry>
                  <term><guimenu>File</guimenu></term>

                  <listitem>
                    <para>Utilizzare questo menù per aprire una nuova finestra, visualizzare la pagina di informazioni sul documento corrente, stampare il documento corrente o chiudere la finestra.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term><guimenu>Modifica</guimenu></term>

                  <listitem>
                    <para>Utilizzare questo menù per copiare, selezionare tutto, trovare del testo o impostare le proprie preferenze.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term><guimenu>Vai</guimenu></term>

                  <listitem>
                    <para>Utilizzare questo menù per spostarsi indietro, avanti o alla pagina principale dell'aiuto. Quando si visualizza un documento DocBook, usare questo menù per spostarsi alla sezione successiva, quella precedente o all'indice generale.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term><guimenu>Preferiti</guimenu></term>

                  <listitem>
                    <para>Utilizzare questo menù per aggiungere o modificare i segnalibri.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term><guimenu>Aiuto</guimenu></term>

                  <listitem>
                    <para>Per visualizzare informazioni su Yelp ed i relativi contributori del progetto, selezionare <guimenuitem>Informazioni</guimenuitem>. È possibile aprire questo documento selezionando <guimenuitem>Sommario</guimenuitem> o premendo <keycap>F1</keycap>.</para>
                  </listitem>
                </varlistentry>
              </variablelist></para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term><interface>Barra degli strumenti</interface></term>

          <listitem>
            <para><variablelist>
                <varlistentry>
                  <term><guibutton>Indietro</guibutton></term>

                  <listitem>
                    <para>Utilizzare questo pulsante per spostarsi indietro nella cronologia del documento.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term><guibutton>Avanti</guibutton></term>

                  <listitem>
                    <para>Utilizzare questo pulsante per spostarsi avanti nella cronologia del documento.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term><guibutton>Argomenti</guibutton></term>

                  <listitem>
                    <para>Utilizzare questo pulsante per ritornare all'indice generale (mostrato in <xref linkend="fig-yelp-window"/>).</para>
                  </listitem>
                </varlistentry>
              </variablelist></para>
          </listitem>
        </varlistentry>

        <varlistentry xml:id="yelp-browser-pane" xreflabel="Yelp Browser Pane">
          <term><interface>Riquadro di esplorazione</interface></term>

          <listitem>
            <para>Il riquadro di esplorazione è l'area in cui viene mostrato l'indice della la documentazione. Utilizzare l'indice per visualizzare la documentazione desiderata.</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </section>
  </section>

  <!--===================== Usage ========================-->

  <section xml:id="yelp-usage"><info><title>Utilizzare Yelp</title></info>

    <section><info><title>Aprire un documento</title></info>
      <para>Per aprire un documento in <application>Yelp Help Browser</application>: <itemizedlist>
		<listitem>
			<para>In un'applicazione fare clic su <menuchoice><guimenu>Aiuto</guimenu> <guimenuitem>Sommario</guimenuitem></menuchoice></para>
		</listitem>	  
		<listitem>
			<para>Utilizzare l'indice per navigare fino al documento desiderato.</para>
		</listitem>
		<listitem>
			<para>È possibile trascinare un file XML tipo Docbook da Caja in una finestra di Yelp o sul suo lanciatore.</para>
		</listitem>
		<listitem>
			<para>Premere il tasto <keycap>F1</keycap>.</para>
		</listitem>		
	  
	  </itemizedlist> </para>
	  
      <para>In alternativa, è possibile visualizzare un particolare documento avviando il visualizzatore Yelp dalla riga di comando o trascinando un file in Yelp. Per maggiori informazioni, consultare <xref linkend="yelp-open-specific"/>.</para>
    </section>

    <section><info><title>Aprire una nuova finestra</title></info>
      <para>Per aprire una nuova finestra:</para>
	  
      <para><itemizedlist>
          <listitem>
            <para>Fare clic su <menuchoice> <guimenu>File</guimenu> <guimenuitem>Nuova finestra</guimenuitem> </menuchoice></para>
          </listitem>

          <listitem>
            <para>Utilizzare la combinazione di tasti <keycombo><keycap>Ctrl</keycap><keycap>N</keycap></keycombo></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title>Informazioni sul documento</title></info>
      <para>Per visualizzare le informazioni sul documento aperto:</para>

      <para><itemizedlist>
          <listitem>
            <para>Fare clic su <menuchoice> <guimenu>File</guimenu> <guimenuitem>Informazioni sul documento</guimenuitem> </menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>Questa opzione è disponibile solo per i documenti DocBook. Di solito tale sezione presenta le note legali ed elenca i contributori alla documentazione.</para>
        </note></para>
    </section>

    <section><info><title>Stampare una pagina</title></info>
      <para>Per stampare la pagina che si sta visualizzando in <application>Yelp Help Browser</application>:</para>

      <para><itemizedlist>
          <listitem>
            <para>Fare clic su <menuchoice> <guimenu>File</guimenu> <guimenuitem>Stampa questa pagina</guimenuitem> </menuchoice></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title>Stampare un documento</title></info>
      <para>Per stampare un intero documento:</para>

      <para><itemizedlist>
          <listitem>
            <para>Fare clic su <menuchoice> <guimenu>File</guimenu> <guimenuitem>Stampa questo documento</guimenuitem> </menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>Questa opzione è disponibile solo per i documenti DocBook.</para>
        </note></para>
    </section>

    <section><info><title>Chiudere una finestra</title></info>
      <para>Per chiudere una finestra in <application>Yelp Help Browser</application>, procedere come segue:</para>

      <para><itemizedlist>
          <listitem>
            <para>Fare clic su <menuchoice> <guimenu>File</guimenu> <guimenuitem>Chiudi finestra</guimenuitem> </menuchoice></para>
          </listitem>

          <listitem>
            <para>Utilizzare la combinazione di tasti <keycombo><keycap>Ctrl</keycap><keycap>W</keycap></keycombo></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title>Impostare le preferenze</title></info>
      <para>Per impostare le proprie preferenze in <application>Yelp Help Browser</application>:</para>

      <para><itemizedlist>
          <listitem>
            <para>Fare clic su <menuchoice> <guimenu>Modifica</guimenu> <guimenuitem>Preferenze</guimenuitem> </menuchoice></para>
          </listitem>
        </itemizedlist> Apparirà una finestra simile a <xref linkend="yelp-preferences"/>:</para>

      <para><figure xml:id="yelp-preferences"><info><title>Finestra Preferenze di <application>Yelp Help Browser</application></title></info>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_preferences.png"/>
            </imageobject>
          </mediaobject>
        </figure> Le opzioni disponibili in questa finestra di dialogo hanno le seguenti funzioni:</para>

      <para><variablelist>
          <varlistentry>
            <term><guilabel>Utilizza i font di sistema</guilabel></term>

            <listitem>
              <para>Selezionare questa opzione per visualizzare la documentazione utilizzando i font predefiniti per il Desktop MATE.</para>

              <para>Per scegliere font personalizzati, deselezionare questa opzione e fare clic sui pulsanti accanto alle scritte <guilabel>Larghezza variabile</guilabel> o <guilabel>Larghezza fissa</guilabel>.</para>

              <para><variablelist>
                  <varlistentry>
                    <term><guilabel>Larghezza variabile</guilabel></term>

                    <listitem>
                      <para>Questo è il tipo di carattere da impiegare  quando non è richiesto un carattere statico o a larghezza fissa. La maggior parte del testo è di questo tipo.</para>
                    </listitem>
                  </varlistentry>

                  <varlistentry>
                    <term><guilabel>Larghezza fissa</guilabel></term>

                    <listitem>
                      <para>Questo è il tipo di carattere da impiegare quando i caratteri devono essere della stessa dimensione. Questo font viene solitamente usato per identificare comandi, blocchi di codice o qualsiasi altro testo che rientri in queste categorie.</para>
                    </listitem>
                  </varlistentry>
                </variablelist></para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><guilabel>Naviga con il cursore</guilabel></term>

            <listitem>
              <para>Selezionare questa opzione se si desidera vedere un cursore in <xref linkend="yelp-browser-pane"/>. Questo consente di spostarsi nel documento più facilmente mostrando la posizione del cursore.</para>
            </listitem>
          </varlistentry>
        </variablelist></para>
    </section>

    <section><info><title>Andare indietro nella cronologia del documento</title></info>
      <para>Per andare indietro nella cronologia del documento:</para>

      <para><itemizedlist>
          <listitem>
            <para>Fare clic su <menuchoice> <guimenu>Vai</guimenu> <guimenuitem>Indietro</guimenuitem> </menuchoice></para>
          </listitem>

          <listitem>
            <para>Utilizzare la combinazione di tasti <keycombo><keycap>Alt</keycap><keycap>Freccia Sinistra</keycap></keycombo></para>
          </listitem>

          <listitem>
            <para>Utilizzare il pulsante <guibutton>Indietro</guibutton> nella <interface>Barra degli strumenti</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title>Andare avanti nella cronologia del documento</title></info>
      <para>Per andare avanti nella cronologia del documento:</para>

      <para><itemizedlist>
          <listitem>
            <para>Fare clic su <menuchoice> <guimenu>Vai</guimenu> <guimenuitem>Avanti</guimenuitem> </menuchoice></para>
          </listitem>

          <listitem>
            <para>Utilizzare la combinazione di tasti <keycombo><keycap>Alt</keycap><keycap>Freccia Destra</keycap></keycombo></para>
          </listitem>

          <listitem>
            <para>Utilizzare il pulsante <guibutton>Avanti</guibutton> nella <interface>Barra degli strumenti</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title>Andare all'indice generale</title></info>
      <para>Per andare all'indice generale:</para>

      <para><itemizedlist>
          <listitem>
            <para>Fare clic su <menuchoice> <guimenu>Vai</guimenu> <guimenuitem>Indice generale</guimenuitem> </menuchoice></para>
          </listitem>

          <listitem>
            <para>Utilizzare la combinazione di tasti <keycombo><keycap>Alt</keycap><keycap>Inizio</keycap></keycombo></para>
          </listitem>

          <listitem>
            <para>Utilizzare il pulsante <guibutton>Indice generale</guibutton> nella <interface>Barra degli strumenti</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title>Andare alla sezione precedente</title></info>
      <para>Per spostarsi alla sezione precedente:</para>

      <para><itemizedlist>
          <listitem>
            <para>Fare clic su <menuchoice> <guimenu>Vai</guimenu> <guimenuitem>Sezione precedente</guimenuitem> </menuchoice></para>
          </listitem>

          <listitem>
            <para>Utilizzare la combinazione di tasti <keycombo><keycap>Alt</keycap><keycap>Freccia Su</keycap></keycombo></para>
          </listitem>
        </itemizedlist><note>
          <para>Questa opzione è disponibile solamente nei documenti formattati come DocBook.</para>
        </note></para>
    </section>

    <section><info><title>Spostarsi alla sezione successiva</title></info>
      

      <para>Per spostarsi alla sezione successiva:</para>

      <para><itemizedlist>
          <listitem>
            <para>Fare clic su <menuchoice> <guimenu>Vai</guimenu> <guimenuitem>Sezione successiva</guimenuitem> </menuchoice></para>
          </listitem>

          <listitem>
            <para>Utilizzare la combinazione di tasti <keycombo><keycap>Alt</keycap><keycap>Freccia Giù</keycap></keycombo></para>
          </listitem>
        </itemizedlist><note>
          <para>Questa opzione è disponibile solamente nei documenti formattati come DocBook.</para>
        </note></para>
    </section>

    <section><info><title>Andare al sommario</title></info>
      

      <para>Per al sommario di un documento:</para>

      <para><itemizedlist>
          <listitem>
            <para>Fare clic su <menuchoice> <guimenu>Vai</guimenu> <guimenuitem>Sommario</guimenuitem> </menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>Questa opzione è disponibile solamente nei documenti formattati come DocBook.</para>
        </note></para>
    </section>

    <section><info><title>Aggiungere un segnalibro</title></info>
      

      <para>Per aggiungere un segnalibro per un documento particolare:</para>

      <para><itemizedlist>
          <listitem>
            <para>Fare clic su <menuchoice> <guimenu>Segnalibri</guimenu> <guimenuitem>Aggiungi segnalibro</guimenuitem> </menuchoice></para>
          </listitem>

          <listitem>
            <para>Utilizzare la combinazione di tasti <keycombo><keycap>Ctrl</keycap><keycap>D</keycap></keycombo></para>
          </listitem>
        </itemizedlist> Apparirà una finestra simile a <xref linkend="yelp-add-bookmark"/>:</para>

      <para><figure xml:id="yelp-add-bookmark"><info><title>Finestra Aggiungi un segnalibro</title></info>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_add_bookmark.png"/>
            </imageobject>
          </mediaobject>
        </figure> Inserire il titolo per il vostro segnalibro nella casella di testo <guilabel>Titolo</guilabel>. Quindi fare clic su <guibutton>Aggiungi</guibutton> per aggiungere il segnalibro, o su <guibutton>Annulla</guibutton> per annullare l'operazione.</para>
    </section>

    <section><info><title>Modificare i segnalibri</title></info>
      <para>Per modificare i propri segnalibri:</para>

      <para><itemizedlist>
          <listitem>
            <para>Fare clic su <menuchoice> <guimenu>Segnalibri</guimenu> <guimenuitem>Modifica segnalibri...</guimenuitem> </menuchoice></para>
          </listitem>

          <listitem>
            <para>Utilizzare la combinazione di tasti <keycombo><keycap>Ctrl</keycap><keycap>B</keycap></keycombo></para>
          </listitem>
        </itemizedlist> Apparirà una finestra simile a <xref linkend="yelp-add-bookmark"/>:</para>

      <para><figure xml:id="yelp-edit-bookmarks"><info><title>Finestra Modifica segnalibri</title></info>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_edit_bookmarks.png"/>
            </imageobject>
          </mediaobject>
        </figure> Si possono gestire i segnalibri utilizzando questa finestra nei modi seguenti:</para>

      <para><variablelist>
          <varlistentry>
            <term><guibutton>Apri</guibutton></term>

            <listitem>
              <para>Utilizzare questo pulsante per aprire il segnalibro selezionato in una nuova finestra.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><guibutton>Rinomina</guibutton></term>

            <listitem>
              <para>Utilizzare questo pulsante per rinominare il titolo del segnalibro.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><guibutton>Elimina</guibutton></term>

            <listitem>
              <para>Utilizzare questo pulsante per eliminare il segnalibro dalla propria raccolta.</para>
            </listitem>
          </varlistentry>
        </variablelist> Una volta terminato di gestire i propri segnalibri, fare clic sul pulsante <guibutton>Chiudi</guibutton> per uscire da <interface>Finestra Modifica segnalibri</interface>.</para>
    </section>

    <section><info><title>Ottenere aiuto</title></info>
      <para>Per ricevere aiuto su come utilizzare <application>Yelp Help Browser</application> (e vedere questo documento):</para>

      <para><itemizedlist>
          <listitem>
            <para>Fare clic su <menuchoice> <guimenu>Aiuto</guimenu> <guimenuitem>Sommario</guimenuitem> </menuchoice></para>
          </listitem>
        </itemizedlist></para>
    </section>
  </section>

  <!--=============== Advanced Features ====================-->

  <section xml:id="yelp-advanced"><info><title>Caratteristiche avanzate</title></info>

   <section xml:id="yelp-open-specific" xreflabel="Opening Specific Documents"><info><title>Aprire documenti specifici</title></info>

    <section xml:id="yelp-open-drag"><info><title>Aprire documenti dal gestore di file</title></info>
        <para>Per aprire un documento, come un file XML, dal gestore di file, aprire il documento nel file manager <application>Caja</application> oppure trascinare l'icona del documento dalla finestra di <application>Caja</application> sul riquadro documento di <application>Yelp</application> o sul suo lanciatore.</para>
    </section>

    <section xml:id="yelp-advanced-cmdline" xreflabel="Using the Command Line to Open Documents"><info><title>Utilizzare la riga di comando per aprire documenti</title></info>
      <para>Il Visualizzatore di documentazione Yelp supporta l'apertura di documenti dalla riga di comando. È possibile utilizzare diversi URI (Uniform Resource Identifiers), inclusi:</para>

      <variablelist>
          <varlistentry>
            <term><option>file:</option></term>

            <listitem>
              <para>Utilizzare questo URI per accedere ad un file con Yelp, per esempio:</para>

              <screen><userinput>yelp file:///usr/share/help/C/mate-control-center/config-mouse.xml</userinput></screen>

            </listitem>
          </varlistentry>

          <varlistentry>
            <term><option>help:</option></term>

            <listitem>
              <para>Utilizzare questo URI per accedere alla documentazione di aiuto di MATE, che è tipicamente scritta nel formato DocBook.</para>

              <screen><userinput>yelp help:mate-terminal</userinput></screen>

              <para>Se si desidera aprire il documento di aiuto ad una particolare sezione, aggiungere una barra '/' alla fine del URI, seguita dall'id della sezione.</para>
              
              <screen><userinput>yelp help:mate-user-guide/yelp-advanced-cmdline</userinput></screen>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><option>man:</option></term>

            <listitem>
              <para>Utilizzare questo URI per accedere ad una particolare pagina man. Nel caso ci sia più di una pagina man con lo stesso nome, è possibile aggiungere la sezione da visualizzare. Per fare ciò, è necessario inserire il numero della sezione tra parentesi tonde. Sarà quindi necessario fare in modo che la shell non interpreti le parentesi come dei comandi.</para>

              <screen><userinput>yelp man:mate-panel</userinput></screen>
              
              <para>oppure</para>

              <screen><userinput>yelp 'man:intro(1)'</userinput>
<userinput>yelp 'man:intro(2)'</userinput></screen>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><option>info:</option></term>

            <listitem>
              <para>Utilizzare questo URI per accedere ad una particolare pagina GNU info.</para>

              <screen><userinput>yelp info:make</userinput></screen>
            </listitem>
          </varlistentry>
        </variablelist>
    </section>
   </section>

    <section><info><title>Aggiornare il contenuto su richiesta</title></info>
      <para><application>Yelp Help Browser</application> supporta la scorciatoia <keycombo><keycap>Ctrl</keycap><keycap>R</keycap></keycombo> che consente di ricaricare il documento DocBook attualmente aperto. In questo modo gli sviluppatori possono visualizzare i cambiamenti ai documenti mentre vengono apportati.</para>
    </section>
  </section>

  <section xml:id="yelp-moreinfo"><info><title>Maggiori informazioni</title></info>
    <para>Questa sezione descrive alcune delle applicazioni ausiliarie utilizzate da <application>Yelp Help Browser</application> e fornisce alcune risorse utili per reperire ulteriori informazioni su <application>Yelp</application>.</para>

    <section><info><title>Scrollkeeper</title></info>
      <para><application>Yelp Help Browser</application> fa uso di scrollkeeper per generare l'indice della documentazione DocBook e HTML e per tenere traccia delle traduzioni di ogni singolo documento.</para>
    </section>

    <section><info><title>Utilità della documentazione di MATE</title></info>
      <para>La documentazione fornita con MATE fa uso di queste utilità per una serie di motivi:</para>

      <para><itemizedlist>
          <listitem>
            <para>Facilitare la traduzione dei documenti in altre lingue.</para>
          </listitem>

          <listitem>
            <para>Fornire un insieme di strumenti per aiutare la pacchettizzazione e l'installazione della documentazione nella posizione corretta e per registrare la documentazione con scrollkeeper.</para>
          </listitem>

          <listitem>
            <para>Gestire la conversione dal formato DocBook in un formato adatto alla visualizzazione.</para>
          </listitem>
        </itemizedlist><application>Yelp Help Browser</application> dipende dai fogli<link xlink:href="help:mate-doc-xslt"> di stile XSLT di MATE </link> per effettuare la conversione dal formato DocBook ad HTML. Le <link xlink:href="help:mate-doc-make">utilità della realizzazione della documentazione di MATE </link> sono affidate agli autori delle applicazioni per installare e registrare la documentazione all'interno del sistema di aiuto. </para>
    </section>

    <section><info><title>Sito web e mailing list</title></info>
      <para>Per maggiori informazioni su <application>Yelp Help Browser</application>, visitare la pagina del Progetto di Documentazione, <uri xlink:href="http://mate-desktop.org">Yelp Help Browser</uri>, o sottoscrivete la mailing list, <uri xlink:href="http://ml.mate-desktop.org/listinfo/mate-dev">http://ml.mate-desktop.org/listinfo/mate-dev</uri>.</para>
    </section>
  </section>

  <section xml:id="yelp-joininggdp"><info><title>Partecipare al Progetto di documentazione di MATE</title></info>
    <para>Se siete interessati ad aiutare a produrre e aggiornare la documentazione per il progetto MATE, visitare la pagina web del Progetto di Documentazione: <uri xlink:href="http://wiki.mate-desktop.org/dev-doc:doc-team-guide?s[]=users[]=guide#mate_documentation_team">http://wiki.mate-desktop.org/dev-doc:doc-team-guide?s[]=users[]=guide#mate_documentation_team</uri></para>
  </section>
</section>
</chapter>
