<?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>Se si inserisce solo la posizione di un file, viene avviata una applicazione appropriata per aprire tale file. Se si inserisce un indirizzo di pagina web, tale pagina viene aperta nel web browser predefinito. L'indirizzo della pagina web deve essere sempre preceduto dal prefisso http://, come in http://www.gnome.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/mate/help/gcalctool/C/gcalctool.xml</userinput></screen>

            </listitem>
          </varlistentry>

          <varlistentry>
            <term><option>help:</option> o <option>mate-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:gcalctool</userinput></screen>

              <para>Per aprire un documento in una particolare sezione, aggiungere un punto di domanda alla fine dello URI, seguito da un identificativo della sezione.</para>
              
              <screen><userinput>yelp help: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:gcalctool</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>Per maggiori informazioni su <application>Visualizzatore di documentazione Yelp</application>, consultare il sito web del Progetto di documentazione, <ulink url="http://live.gnome.org/Yelp">http://live.gnome.org/Yelp</ulink>, o iscriversi alla mailing list <ulink type="http" url="http://mail.gnome.org/mailman/listinfo/mate-doc-devel-list">mate-doc-devel-list@gnome.org</ulink>.</para>
    </section>
  </section>

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

    <para>Per aiutare nella stesura e nell'aggiornamento della documentazione per il progetto MATE, visitare il sito web del Progetto di documentazione: <ulink url="http://live.gnome.org/DocumentationProject">http://live.gnome.org/DocumentationProject</ulink></para>
  </section>

</section>

</chapter>
