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

  <highlights>
    <para>Questa sezione descrive alcuni strumenti ed utilità dello GNOME 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>dialogo Esegui applicazione, utilizzo</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 di pannello <guibutton>Esegui applicazione</guibutton> per aprire il 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 cambiare i tasti scorciatoia per mostrare il dialogo <guilabel>Esegui applicazione</guilabel> nello strumento di preferenze <link linkend="prefs-keyboard-shortcuts"><application>Scorciatoie da tastiera</application>.
          
          
        </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>schermate, catturare</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>Stampa schermo</keycap>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Cattura un'istantanea dell'intero schermo.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para><keycombo><keycap>Alt</keycap><keycap>Stampa schermo</keycap></keycombo></para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Cattura un'istantanea della finestra a cui punta il mouse.</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>Scegliere <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>gnome-screenshot</command> per catturare una schermata. Il comando <command>gnome-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>gnome-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 cattura una schermata includendo 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 ed aggiunge un effetto ombra 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 ed aggiunge un effetto bordo attorno ad essa.</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 e scegliere una posizione nell'elenco a discesa.</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>The <application>Yelp Help Browser</application> application allows you to view documentation
    regarding GNOME and other components through a variety of formats. These
    formats include docbook files, HTML help pages, man pages and info pages
    (support for man pages and info pages may optionally be compiled in).
    Despite the different formats supported, Yelp does its best to provide a
    unified look and feel regardless of the original document format.</para>

    <para>Il <application>visualizzatore di documentazione Yelp</application> è internazionalizzato, supporta cioè la visualizzazione dei documenti in diverse lingue. I documenti debbono essere localizzato 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>Finestra di <application>visualizzatore di documentazione Yelp</application></title>

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

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

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

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

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

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

                  <listitem>
                    <para>Use this menu to navigate Back, Forward, to the Help
                    Topics page. When viewing a DocBook document, use this
                    menu to navigate to the Next Section, Previous Section or
                    to the Contents.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term><guimenu>Segnalibri</guimenu></term>

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

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

                  <listitem>
                    <para>View information about Yelp Help Browser and
                    contributors to the project through the
                    <guimenuitem>About</guimenuitem> menuitem. Open this
                    document with the <guimenuitem>Contents</guimenuitem>
                    menuitem or by pressing <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>Use this button to navigate back in your document
                    history.</para>
                  </listitem>
                </varlistentry>

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

                  <listitem>
                    <para>Use this button to navigate forward in your document
                    history.</para>
                  </listitem>
                </varlistentry>

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

                  <listitem>
                    <para>Use this button to return to the main table of
                    contents (shown 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>The browser pane is where you will be presented with the
            table of contents or the documentation. Use the table of contents
            to navigate to the documentation you need.</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </section>
  </section>

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

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

    <section>
      <title>Open a Document</title>

      <para>To open a document in <application>Yelp Help Browser</application>, use the Table of Contents
      to navigate to the desired document.</para>

      <para>Alternatively, you may view a particular document by invoking Yelp
      Help Browser from the command line or dragging files to Yelp. See <xref linkend="yelp-open-specific"/> for more on this.</para>
    </section>

    <section>
      <title>Open a New Window</title>

      <para>To open a new window:</para>

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

                <guimenuitem>New Window</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para>Use the key combination
            <keycombo><keycap>Ctrl</keycap><keycap>N</keycap></keycombo></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>About This Document</title>

      <para>To view information about the currently open document:</para>

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

                <guimenuitem>About This Document</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>This option is only available for DocBook documentation. Legal
          notices and documentation contributors are usually listed in this
          section.</para>
        </note></para>
    </section>

    <section>
      <title>Print a Page</title>

      <para>To print any page that you are able to view in <application>Yelp Help Browser</application>:</para>

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

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

    <section>
      <title>Print a Document</title>

      <para>To print an entire document:</para>

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

                <guimenuitem>Print this Document</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>This option is only available for DocBook
          documentation.</para>
        </note></para>
    </section>

    <section>
      <title>Close a Window</title>

      <para>To close a window in <application>Yelp Help Browser</application>, do the following:</para>

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

                <guimenuitem>Close Window</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para>Use the key combination
            <keycombo><keycap>Ctrl</keycap><keycap>W</keycap></keycombo></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Set Preferences</title>

      <para>To set your preferences in <application>Yelp Help Browser</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>Check this option to display documentation using the
              default fonts used by the GNOME Desktop.</para>

              <para>To choose your own fonts to display documentation, uncheck
              this option and click on the buttons next to the text
              <guilabel>Variable Width</guilabel> or <guilabel>Fixed
              Width</guilabel>.</para>

              <para><variablelist>
                  <varlistentry>
                    <term><guilabel>Variable Width</guilabel></term>

                    <listitem>
                      <para>This is the font to use when a static or fixed
                      width font is not required. The majority of text will be
                      of this type.</para>
                    </listitem>
                  </varlistentry>

                  <varlistentry>
                    <term><guilabel>Fixed Width</guilabel></term>

                    <listitem>
                      <para>This is the font to use when all text characters
                      need to be of the same size. This font is usually used
                      to indicate commands, program blocks, or other text that
                      falls under these categories.</para>
                    </listitem>
                  </varlistentry>
                </variablelist></para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><guilabel>Browse with caret</guilabel></term>

            <listitem>
              <para>Click this option if you would like see a caret or cursor
              in the <xref linkend="yelp-browser-pane"/>. This allows you to
              browse the document more easily by showing where the cursor is
              located in the document.</para>
            </listitem>
          </varlistentry>
        </variablelist></para>
    </section>

    <section>
      <title>Go Back in Document History</title>

      <para>To go back in the document history:</para>

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

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

          <listitem>
            <para>Use the key combination
            <keycombo><keycap>Alt</keycap><keycap>Left</keycap></keycombo></para>
          </listitem>

          <listitem>
            <para>Use the <guibutton>Back</guibutton> button in the
            <interface>Toolbar</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Go Forward in Document History</title>

      <para>To go forward in the document history:</para>

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

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

          <listitem>
            <para>Use the key combination
            <keycombo><keycap>Alt</keycap><keycap>Right</keycap></keycombo></para>
          </listitem>

          <listitem>
            <para>Use the <guibutton>Forward</guibutton> button in the
            <interface>Toolbar</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Go to Help Topics</title>

      <para>To go to the Help Topics:</para>

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

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

          <listitem>
            <para>Use the key combination
            <keycombo><keycap>Alt</keycap><keycap>Home</keycap></keycombo></para>
          </listitem>

          <listitem>
            <para>Use the <guibutton>Help Topics</guibutton> button in the
            <interface>Toolbar</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Go to Previous Section</title>

      <para>To go to the previous section:</para>

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

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

          <listitem>
            <para>Use the key combination
            <keycombo><keycap>Alt</keycap><keycap>Up</keycap></keycombo></para>
          </listitem>
        </itemizedlist><note>
          <para>This option is only available in DocBook formatted
          documents.</para>
        </note></para>
    </section>

    <section>
      <title>Go to Next Section</title>

      <para>To go to the next section:</para>

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

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

          <listitem>
            <para>Use the key combination
            <keycombo><keycap>Alt</keycap><keycap>Down</keycap></keycombo></para>
          </listitem>
        </itemizedlist><note>
          <para>This option is only available in DocBook formatted
          documents.</para>
        </note></para>
    </section>

    <section>
      <title>Go to Contents</title>

      <para>To go to the contents for a document:</para>

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

                <guimenuitem>Contents</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>This option is only available in DocBook formatted
          documents.</para>
        </note></para>
    </section>

    <section>
      <title>Add a Bookmark</title>

      <para>To add a bookmark for a particular document:</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>Edit Bookmarks</title>

      <para>To edit your collection of bookmarks:</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>Rimuovi</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>Get Help</title>

      <para>To get help using <application>Yelp Help Browser</application> (and see this
      document):</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>Advanced Features</title>

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

    <section id="yelp-open-drag">
      <title>Aprire documenti dal file manager</title>
        <para>To open a document, such as an XML file, from the file manager, open the document in <application>Nautilus</application> File Manager, or drag the icon from <application>Nautilus</application> to the <application>Yelp</application> document pane
        or launcher.</para>
    </section>

    <section id="yelp-advanced-cmdline" xreflabel="Using the Command Line to Open Documents">
      <title>Using the Command Line to Open Documents</title>

      <para>Yelp Help Browser supports opening documents from the command
      line. There are a number of URIs (Uniform Resource Identifiers) that can
      be used. These include:</para>

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

            <listitem>
              <para>Use this URI when you want to access a file with
              yelp, for example:</para>

              <screen><userinput>yelp file:///usr/share/gnome/help/gcalctool/C/gcalctool.xml</userinput></screen>

            </listitem>
          </varlistentry>

          <varlistentry>
            <term><option>ghelp:</option> or
            <option>gnome-help:</option></term>

            <listitem>
              <para>Use this URI when you want to access GNOME help documents,
              which are typically written in DocBook format.</para>

              <screen><userinput>yelp ghelp:gcalctool</userinput></screen>

              <para>If you want to open the help document at a particular section,
              append a question mark to the end of the URI, followed by the section id.</para>
              
              <screen><userinput>yelp ghelp:user-guide?yelp-advanced-cmdline</userinput></screen>
            </listitem>
          </varlistentry>

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

            <listitem>
              <para>Use this URI when you want to access a particular man
              page. You can append the section of the man page you would like
              to view if there are multiple man pages with the same
              name.  The section number should be enclosed in parenthesis and 
              therefore it may be necessary to escape the argument so that the
              shell does not interpret the parenthesis.</para>

              <screen><userinput>yelp man:gcalctool</userinput></screen>
              
              <para>or</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>Use this URI when you want to access a particular GNU info
              page.</para>

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

   </section>

    <section>
      <title>Refreshing Content on Demand</title>

      <para><application>Yelp Help Browser</application> supports the
      <keycombo><keycap>Ctrl</keycap><keycap>R</keycap></keycombo> shortcut keys, which will reload the DocBook
      document that is currently open. This allows developers to view changes
      to documents as they are made.</para>
    </section>
  </section>

  <section id="yelp-moreinfo">
    <title>More Information</title>

    <para>This section details some of the helper applications which 
    <application>Yelp Help Browser</application> uses, and provides resources where you can get more information
    about <application>Yelp Help Browser</application>.</para>

    <section>
      <title>Scrollkeeper</title>

      <para><application>Yelp Help Browser</application> uses scrollkeeper to generate the table of
      contents for DocBook and HTML documentation, and also keep track of
      translations for each document.</para>
    </section>

    <section>
      <title>GNOME Documentation Utilites</title>

      <para>The documentation distributed with GNOME uses this set of
      utilities for a variety of things:</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="ghelp:gnome-doc-xslt">GNOME XSLT
      Stylesheets</ulink> to perform conversion from DocBook to HTML.  <ulink url="ghelp:gnome-doc-make">GNOME Documentation 
      Build Utilities</ulink> are relied upon by application authors to install and register documentation within the help system.</para>
    </section>

    <section>
      <title>Homepage and Mailing List</title>

      <para>For further information on <application>Yelp Help Browser</application>, please visit the Documentation Project homepage, <ulink url="http://live.gnome.org/Yelp">http://live.gnome.org/Yelp</ulink>, or subscribe to
      the mailing list, <ulink type="http" url="http://mail.gnome.org/mailman/listinfo/gnome-doc-devel-list">gnome-doc-devel-list@gnome.org</ulink>.</para>
    </section>
  </section>

  <section id="yelp-joininggdp">
    <title>Joining the GNOME Documentation Project</title>

    <para>If you are interesting in helping produce and update documentation
    for the GNOME project, please visit the Documentation Project homepage: <ulink url="http://live.gnome.org/DocumentationProject">http://live.gnome.org/DocumentationProject</ulink></para>
  </section>

</section>

</chapter>
