<?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>utilizzare il dialogo Esegui applicazione</primary></indexterm>
    <para>Il 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 il 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 per mostrare il dialogo <guilabel>Esegui applicazione</guilabel> dallo strumento <application><xref linkend="prefs-keyboard-shortcuts"/></application>.</para>
          </listitem>
          </varlistentry>
        </variablelist></para>
      <para>Viene mostrato il 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 usare 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> nel 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>Print Screen</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 predefiniti.</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 schermata</guilabel>. Usare il dialogo <guilabel>Salvataggio 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 il dialogo <guilabel>Salvataggio schermata</guilabel>. Usare il dialogo <guilabel>Salvataggio 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 dello schermo.</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 dello schermo.</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 aperto il dialogo <guilabel>Salvataggio schermata</guilabel>. Per salvare la schermata come un file di immagine, inserire il nome da attribuire alla 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 mediante 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>Il <application>Visualizzatore di documentazione Yelp</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>Il <application>Visualizzatore di documentazione Yelp</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 di documentazione Yelp possa vederli.</para>
  </section>

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

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

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

            <listitem>
              <para>Scegliere <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>visualizzatore di documentazione Yelp</application>, viene mostrata la seguente finestra.</para>

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

      <variablelist>
        <varlistentry>
          <term><interface>Barra dei menu</interface></term>

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

                  <listitem>
                    <para>Utilizzare questo menù per aprire una nuova finestra, visualizzare la pagina 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 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>Segnalibri</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 e i relativi contributori del progetto, selezionare <guimenuitem>Informazioni</guimenuitem>. È possibile aprire questo documento scegliendo <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>Usare 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 spostarsi nella documentazione.</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </section>
  </section>

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

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

    <section><info><title>Aprire un documento</title></info>
      <para>Per aprire un documento nel <application>Visualizzatore di documentazione Yelp</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 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 di documentazione Yelp dalla riga di comando o trascinando un file all'interno di 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>Usare 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 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 una pagina che si sta visualizzando nel <application>Visualizzatore di documentazione Yelp</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</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>Usare 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 nel <application>Visualizzatore di documentazione Yelp</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</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>Usa il caratteri di sistema</guilabel></term>

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

              <para>Per scegliere tipi di carattere 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 usare 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 usare quando i caratteri devono essere della stessa dimensione. Questo tipo di carattere 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 dove sia localizzato il 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>Usare 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>Usare 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>Usare 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>Usare 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>Usare 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>Usare 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 segnalibro</title></info>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_add_bookmark.png"/>
            </imageobject>
          </mediaobject>
        </figure> Inserire il titolo per 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>Modifica 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 dalla <interface>Finestra Modifica segnalibri</interface>.</para>
    </section>

    <section><info><title>Ottieni aiuto</title></info>
      <para>Per ricevere aiuto su come utilizzare <application>Visualizzatore di documentazione Yelp</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 gestore di file <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>Usare 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>Usare 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>aiuto:</option></term>

            <listitem>
              <para>Usare 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>Usare 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>o</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>Usare 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>Visualizzatore di documentazione Yelp</application> supporta il tasto 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>Visualizzatore di documentazione Yelp</application> e fornisce alcune risorse utili per reperire ulteriori informazioni su <application>Yelp</application>.</para>

    <section><info><title>Scrollkeeper</title></info>
      <para><application>Yelp</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>Il <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>Visualizzatore di documentazione Yelp</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 sul <application>Visualizzatore di documentazione Yelp</application>, visitare la pagina del Progetto Documentazione, <uri xlink:href="http://mate-desktop.org">Visualizzatore di documentazione Yelp</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 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>
