<?xml version="1.0" encoding="utf-8"?>
<!-- -*- indent-tabs-mode: nil -*- -->
<chapter id="tools" lang="it">
  <title>Strumenti e utilità</title>

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

  <section id="tools-run-app">
    <title>Esecuzione di applicazioni</title>
    <!-- preserve id for backwards compatibility: 2.12 -->
    <anchor id="gospanel-23"/>
    <indexterm>
      <primary>Run Application dialog, using</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>Open the <guilabel>Run Application</guilabel> dialog in any of the
        following ways:
        <variablelist>
          <varlistentry><term>From a panel</term>
          <listitem><para>You can add the <application>Run Application</application> button to any 
          panel. See <xref linkend="panels-addobject"/>. Click on the <guibutton>Run Application</guibutton> 
          panel button to open the <guilabel>Run Application</guilabel> dialog.</para></listitem></varlistentry>
          <varlistentry><term>Using shortcut keys</term>
          <listitem>
            <para>
              Press <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo>. You can change 
              the shortcut keys that display the <guilabel>Run Application</guilabel> dialog
              in the <link linkend="prefs-keyboard-shortcuts"><application>Keyboard Shortcuts</application> 
            preference tool</link>.</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>If you enter only the location of a file, an appropriate application will launch to open it.
      If you enter a web page address, your default web browser will open the page. Prefix the web page address with http://, as in http://www.mate-desktop.org.
      </para>
      <para>Per scegliere un comando che si è eseguito in precedenza, fare clic sul pulsante freccia giù accanto al campo del comando, quindi scegliere in 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 editare.</para>
      <para>Selezionare l'opzione <guilabel>Esegui nel terminare</guilabel> per eseguire l'applicazione o il comando in una finestra di terminale. Scegliere questa opzione per i comandi che non creano una finestra apposita 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 id="tools-screenshot">
  <title>Cattura di schermate</title>
  <!-- preserve id for backwards compatibility: 2.12 -->
  <anchor id="goseditmainmenu-53"/>   
  <indexterm>
    <primary>screenshots, taking</primary>
  </indexterm>
  <para>È possibile catturare una schermata in uno dei modi seguenti:</para>
  <itemizedlist>
    <listitem>
      <para>Da qualsiasi pannello</para>
      <para>È possibile aggiungere un pulsante <application>Cattura schermata</application> ad un qualsiasi pannello. Consultare <xref linkend="panels-addobject"/> per istruzioni su come fare ciò. 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>Print Screen</keycap></keycombo></para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Takes a screenshot of the window which is active.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
      <para>È possibile usare lo strumento di preferenze <link linkend="prefs-keyboard-shortcuts"><application>Scorciatoie da tastiera</application></link> per modificare i tasti scorciatoia predefiniti.</para>
    </listitem>
    <listitem>
      <para>Dalla barra dei menù</para>
      <para>Choose <menuchoice><guimenu>Applications</guimenu><guimenuitem>Accessories</guimenuitem>
      <guimenuitem>Take Screenshot</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 il 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>seconds</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>Takes a screenshot and adds a shadow bevel effect around it.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <command>--border-effect=border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Takes a screenshot and adds a border effect around it.</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 di 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 per trascinamento.</para>
  
</section>

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

  <section id="yelp-introduction">
    <title>Introduzione</title>

    <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> è internazionalizzato, supporta cioè la visualizzazione dei documenti in diverse lingue. I documenti devono essere localizzati o tradotti per ciascuna lingua e installati nel modo appropriato per far sì che il visualizzatore sia in grado di mostrarli.</para>
  </section>

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

  <section id="yelp-getting-started">
    <title>Avviare Yelp</title>

    <section>
      <title>Per avviare il <application>Visualizzatore di documentazione Yelp</application></title>

      <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>
      <title>Interfaccia</title>

      <para>Quando si avvia il <application>visualizzatore di documentazione Yelp</application>, viene mostrata la seguente finestra.</para>

      <para><figure id="fig-yelp-window">
          <title><application>Yelp Help Browser</application> Window</title>

          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_window.png"/>
            </imageobject>
          </mediaobject>
        </figure><application>Yelp Help Browser</application> contains the following elements in <xref linkend="fig-yelp-window"/></para>

      <variablelist>
        <varlistentry>
          <term><interface>Menubar</interface></term>

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

                  <listitem>
                    <para>Usare 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>Edit</guimenu></term>

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

                <varlistentry>
                  <term><guimenu>Go</guimenu></term>

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

                <varlistentry>
                  <term><guimenu>Bookmarks</guimenu></term>

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

                <varlistentry>
                  <term><guimenu>Help</guimenu></term>

                  <listitem>
                    <para>Per visualizzare informazioni riguardo Yelp e i contributori al 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>Toolbar</interface></term>

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

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

                <varlistentry>
                  <term><guibutton>Forward</guibutton></term>

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

                <varlistentry>
                  <term><guibutton>Help Topics</guibutton></term>

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

        <varlistentry id="yelp-browser-pane" xreflabel="Yelp Browser Pane">
          <term><interface>Browser Pane</interface></term>

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

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

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

    <section>
      <title>Aprire un documento</title>

      <para>To open a document in <application>Yelp Help Browser</application>:
	  
	  <itemizedlist>
		<listitem>
			<para>In an application, click <menuchoice>
                <guimenu>Help</guimenu>

                <guimenuitem>Contents</guimenuitem>
              </menuchoice>
			  </para>
		</listitem>	  
		<listitem>
			<para>Use the Table of Contents to navigate to the desired document.</para>
		</listitem>
		<listitem>
			<para>You can drag a Docbook XML file from Caja to the Yelp window or launcher.</para>
		</listitem>
		<listitem>
			<para>Press the <keycap>F1</keycap> key.</para>
		</listitem>		
	  
	  </itemizedlist></para>
	  
      <para>In alternativa, è possibile visualizzare un particolare documento avviando 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>
      <title>Aprire una nuova finestra</title>

      <para>Per aprire una nuova finestra:</para>
	  
      <para><itemizedlist>
          <listitem>
            <para>Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>New Window</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>
      <title>Informazioni sul documento</title>

      <para>Per visualizzare informazioni riguardo il documento aperto:</para>

      <para><itemizedlist>
          <listitem>
            <para>Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>About This Document</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>
      <title>Stampare una pagina</title>

      <para>Per stampare una pagina che si sta visualizzando in <application>Yelp</application>:</para>

      <para><itemizedlist>
          <listitem>
            <para>Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>Print this Page</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Stampare un documento</title>

      <para>Per stampare un intero documento:</para>

      <para><itemizedlist>
          <listitem>
            <para>Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>Print this Document</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>Questa opzione è disponibile solo per i documenti DocBook.</para>
        </note></para>
    </section>

    <section>
      <title>Chiudere una finestra</title>

      <para>Per chiudere una finestra in <application>Yelp</application>, procedere come segue:</para>

      <para><itemizedlist>
          <listitem>
            <para>Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>Close Window</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>
      <title>Impostare le preferenze</title>

      <para>Per impostare le proprie preferenze in <application>Yelp</application>:</para>

      <para><itemizedlist>
          <listitem>
            <para>Click <menuchoice>
                <guimenu>Edit</guimenu>

                <guimenuitem>Preferences</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist>A window will appear that looks like <xref linkend="yelp-preferences"/>:</para>

      <para><figure id="yelp-preferences">
          <title><application>Yelp Help Browser</application> Preferences Window</title>

          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_preferences.png"/>
            </imageobject>
          </mediaobject>
        </figure>The options that are available in this dialog have the
      following functions:</para>

      <para><variablelist>
          <varlistentry>
            <term><guilabel>Use system fonts</guilabel></term>

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

              <para>Per scegliere dei 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>Variable Width</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>Fixed Width</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>Browse with caret</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>
      <title>Andare indietro nella cronologia del documento</title>

      <para>Per andare indietro nella cronologia del documento:</para>

      <para><itemizedlist>
          <listitem>
            <para>Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Back</guimenuitem>
              </menuchoice></para>
          </listitem>

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

          <listitem>
            <para>Usare il pulsante <guibutton>Indietro</guibutton> nella <interface>barra degli strumenti</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Andare avanti nella cronologia del documento</title>

      <para>Per andare avanti nella cronologia del documento:</para>

      <para><itemizedlist>
          <listitem>
            <para>Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Forward</guimenuitem>
              </menuchoice></para>
          </listitem>

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

          <listitem>
            <para>Usare il pulsante <guibutton>Avanti</guibutton> nella <interface>barra degli strumenti</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Andare all'indice generale</title>

      <para>Per andare all'indice generale:</para>

      <para><itemizedlist>
          <listitem>
            <para>Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Help Topics</guimenuitem>
              </menuchoice></para>
          </listitem>

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

          <listitem>
            <para>Usare il pulsante <guibutton>Argomenti</guibutton> nella <interface>barra degli strumenti</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Andare alla sezione precedente</title>

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

      <para><itemizedlist>
          <listitem>
            <para>Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Previous Section</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para>Usare la combinazione di tasti <keycombo><keycap>Alt</keycap><keycap>Su</keycap></keycombo></para>
          </listitem>
        </itemizedlist><note>
          <para>Questa opzione è disponibile solamente nei documenti scritti in DocBook.</para>
        </note></para>
    </section>

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

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

      <para><itemizedlist>
          <listitem>
            <para>Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Next Section</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para>Usare la combinazione di tasti <keycombo><keycap>Alt</keycap><keycap>Giù</keycap></keycombo></para>
          </listitem>
        </itemizedlist><note>
          <para>Questa opzione è disponibile solamente nei documenti scritti in DocBook.</para>
        </note></para>
    </section>

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

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

      <para><itemizedlist>
          <listitem>
            <para>Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Contents</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>Questa opzione è disponibile solamente nei documenti scritti in DocBook.</para>
        </note></para>
    </section>

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

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

      <para><itemizedlist>
          <listitem>
            <para>Click <menuchoice>
                <guimenu>Bookmarks</guimenu>

                <guimenuitem>Add Bookmark</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para>Use the key combination
            <keycombo><keycap>Ctrl</keycap><keycap>D</keycap></keycombo></para>
          </listitem>
        </itemizedlist>A window will appear that looks like <xref linkend="yelp-add-bookmark"/>.</para>

      <para><figure id="yelp-add-bookmark">
          <title>Add Bookmark Window</title>

          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_add_bookmark.png"/>
            </imageobject>
          </mediaobject>
        </figure>Enter your desired bookmark title in to the
      <guilabel>Title</guilabel> text entry field. Then click
      <guibutton>Add</guibutton> to add the bookmark, or click
      <guibutton>Cancel</guibutton> to cancel the request.</para>
    </section>

    <section>
      <title>Modificare i segnalibri</title>

      <para>Per modificare i propri segnalibri:</para>

      <para><itemizedlist>
          <listitem>
            <para>Click <menuchoice>
                <guimenu>Bookmarks</guimenu>
                <guimenuitem>Edit Bookmarks...</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para>Use the key combination
            <keycombo><keycap>Ctrl</keycap><keycap>B</keycap></keycombo></para>
          </listitem>
        </itemizedlist>A window will appear that looks like <xref linkend="yelp-edit-bookmarks"/>.</para>

      <para><figure id="yelp-edit-bookmarks">
          <title>Edit Bookmarks Window</title>

          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_edit_bookmarks.png"/>
            </imageobject>
          </mediaobject>
        </figure>You can manage your bookmarks using this window in the
      following ways:</para>

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

            <listitem>
              <para>Use this button to open the selected bookmark in a new
              window.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><guibutton>Rename</guibutton></term>

            <listitem>
              <para>Use this button to rename the title of your
              bookmark.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><guibutton>Remove</guibutton></term>

            <listitem>
              <para>Use this button to delete the bookmark from your
              collection.</para>
            </listitem>
          </varlistentry>
        </variablelist>Once you are finished managing your bookmarks, click
      the <guibutton>Close</guibutton> button to exit the <interface>Edit
      Bookmarks Window</interface>.</para>
    </section>

    <section>
      <title>Ottenere aiuto</title>

      <para>Per ottenere aiuto sull'uso di <application>Visualizzatore documentazione Yelp</application> (e visualizzare questo documento):</para>

      <para><itemizedlist>
          <listitem>
            <para>Click <menuchoice>
                <guimenu>Help</guimenu>

                <guimenuitem>Contents</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist></para>
    </section>
  </section>

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

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

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

    <section id="yelp-open-drag">
      <title>Aprire documenti dal gestore di file</title>
        <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> oppure sul lanciatore.</para>
    </section>

    <section id="yelp-advanced-cmdline" xreflabel="Using the Command Line to Open Documents">
      <title>Usare la riga di comando per aprire documenti</title>

      <para>Visualizzatore di documentazione Yelp supporta l'apertura di documenti dalla riga di comando. È possibile utilizzare diversi URI (Uniform Resource Identifiers), compresi:</para>

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

            <listitem>
              <para>Usare questo URI per accedere a 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>Usare questo URI per accedere alla documentazione di aiuto di MATE, tipicamente scritta nel formato DocBook.</para>

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

              <para>If you want to open the help document at a particular section,
              append a slash to the end of the URI, followed by the section id.</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 a una particolare pagina man. Nel caso ci sia più di una pagina man con lo stesso nome, è possibile aggiungere anche 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 a una particolare pagina GNU info.</para>

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

   </section>

    <section>
      <title>Aggiornare il contenuto su richiesta</title>

      <para><application>Visualizzatore di documentazione Yelp</application> supporta i tasto scorciatoia <keycombo><keycap>Ctrl</keycap><keycap>R</keycap></keycombo> che consentono 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 id="yelp-moreinfo">
    <title>Maggiori informazioni</title>

    <para>Questa sezione descrive alcune delle applicazioni ausiliarie utilizzate da <application>Visualizzatore di documenti Yelp</application> e fornisce alcune risorse utili per reperire ulteriori informazioni riguardo <application>Visualizzatore di documenti Yelp</application>.</para>

    <section>
      <title>Scrollkeeper</title>

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

    <section>
      <title>MATE Documentation Utilites</title>

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

      <para><itemizedlist>
          <listitem>
            <para>Ease translation of documents to different languages.</para>
          </listitem>

          <listitem>
            <para>Provide a set of tools to help package and install
            documentation into the correct location and register the
            documentation with scrollkeeper.</para>
          </listitem>

          <listitem>
            <para>Perform conversion from DocBook format to a format suitable
            for display.</para>
          </listitem>
        </itemizedlist><application>Yelp Help Browser</application> relies on <ulink url="help:mate-doc-xslt">MATE XSLT
      Stylesheets</ulink> to perform conversion from DocBook to HTML.  <ulink url="help:mate-doc-make">MATE Documentation
      Build Utilities</ulink> are relied upon by application authors to install and register documentation within the help system.</para>
    </section>

    <section>
      <title>Sito web e mailing list</title>

      <para>For further information on <application>Yelp Help Browser</application>, please visit the Documentation Project homepage, <ulink url="http://mate-desktop.org"/>, or subscribe to
      the mailing list, <ulink type="http" url="http://ml.mate-desktop.org/listinfo/mate-dev"/>.</para>
    </section>
  </section>

  <section id="yelp-joininggdp">
    <title>Partecipare al Progetto di documentazione di MATE</title>

    <para>If you are interesting in helping produce and update documentation
    for the MATE project, please visit the Documentation Project homepage: <ulink url="http://wiki.mate-desktop.org/dev-doc:doc-team-guide?s[]=users[]=guide#mate_documentation_team"/></para>
  </section>

</section>

</chapter>
