<?xml version="1.0" encoding="utf-8"?>
<!-- -*- indent-tabs-mode: nil -*- -->
<chapter id="tools">
  <title>Outils et utilitaires</title>

  <highlights>
    <para>Ce chapitre documente quelques outils et utilitaires du bureau GNOME.</para>
  </highlights>

  <section id="tools-run-app">
    <title>Lancement d'applications</title>
    <!-- preserve id for backwards compatibility: 2.12 -->
    <anchor id="gospanel-23"/>
    <indexterm>
      <primary>Boîte de dialogue « Lancer une application », utilisation de la</primary>
    </indexterm>
    <para>La boîte de dialogue « Lancer une application » donne accès à la ligne de commande. Lorsque vous exécutez une commande dans la boîte de dialogue « Lancer une application », vous n'obtenez cependant pas l'écho du résultat de la commande.</para>
    <para>Pour exécuter une commande au moyen de la ligne de commande, effectuez les opérations suivantes :</para>
    <orderedlist>
      <listitem>
        <para>Ouvrez la boîte de dialogue <guilabel>Lancer une application</guilabel> en utilisant l'une des méthodes suivantes : <variablelist>
          <varlistentry><term>À partir d'un tableau de bord</term>
          <listitem><para>Vous pouvez ajouter le bouton <application>Lancer une application</application> à n'importe quel tableau de bord. Référez-vous à la <xref linkend="panels-addobject"/>. Cliquez sur le bouton <guibutton>Lancer une application</guibutton> pour ouvrir la boîte de dialogue <application>Lancer une application</application>.</para></listitem></varlistentry>
          <varlistentry><term>À l'aide de raccourcis clavier</term>
          <listitem>
            <para>Appuyez sur <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo>. Ce raccourci clavier peut être modifié dans le <link linkend="prefs-keyboard-shortcuts">panneau de préférences <application>Raccourcis clavier</application></link>.</para>
          </listitem>
          </varlistentry>
        </variablelist></para>
      <para>La boîte de dialogue <guilabel>Lancer une application</guilabel> apparaît.</para>
    </listitem>
    <listitem>
      <para>Saisissez la commande à exécuter dans le champ vierge, ou faites un choix parmi la liste des applications connues.</para>
      <para>Si vous saisissez l'emplacement d'un fichier, l'application appropriée se lance pour l'ouvrir. Si vous saisissez l'adresse d'une page Web, le navigateur Web par défaut va ouvrir la page. Préfixez l'adresse de la page avec « http:// », comme dans http://www.gnome.org.</para>
      <para>Pour retrouver une commande précédemment saisie, cliquez sur la flèche à droite de la zone de saisie, puis sélectionnez la commande à exécuter.</para>
      <para>Vous pouvez aussi choisir un fichier à ajouter à la ligne de commande en cliquant sur le bouton <guibutton>Lancer avec un fichier</guibutton>. Par exemple, vous pouvez saisir la commande <application>gedit</application>, puis choisir un fichier à modifier.</para>
      <para>Cochez l'option <guilabel>Lancer dans un terminal</guilabel> pour exécuter l'application ou la commande dans une fenêtre de terminal. Cette option est utile lorsque la commande ou l'application ne crée pas elle-même de fenêtre lorsqu'elle s'exécute.</para>
    </listitem>
    <listitem>
      <para>Cliquez sur le bouton <guibutton>Lancer</guibutton> de la boîte de dialogue <guilabel>Lancer une application</guilabel>.</para>
    </listitem>
      </orderedlist>
    </section>

<section id="tools-screenshot">
  <title>Captures d'écran</title>
  <!-- preserve id for backwards compatibility: 2.12 -->
  <anchor id="goseditmainmenu-53"/>   
  <indexterm>
    <primary>captures d'écran, saisie de</primary>
  </indexterm>
  <para>Vous pouvez réaliser une capture d'écran en ayant recours à l'une des méthodes suivantes :</para>
  <itemizedlist>
    <listitem>
      <para>À partir d'un tableau de bord</para>
      <para>Vous pouvez ajouter un bouton <guibutton>Capture d'écran</guibutton> à n'importe quel tableau de bord. Pour connaître la marche à suivre, consultez la <xref linkend="panels-addobject"/>. Cliquez sur le bouton <guibutton>Capture d'écran</guibutton> pour effectuer une capture de tout l'écran.</para>
    </listitem>
    <listitem>
      <para>À l'aide des touches de raccourci</para>
      <para>Pour réaliser une capture d'écran, utilisez les touches de raccourci suivantes :</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>Touches de raccourci par défaut</para>
              </entry>
              <entry>
                <para>Fonction</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <keycap>Impr écran</keycap>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Réalise une capture de l'écran entier.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para><keycombo><keycap>Alt</keycap><keycap>Impr écran</keycap></keycombo></para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Réalise une capture d'écran de la fenêtre sur laquelle pointe la souris.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
      <para>Le <link linkend="prefs-keyboard-shortcuts">panneau de préférences <application>Raccourcis clavier</application></link> permet de modifier les touches de raccourci par défaut.</para>
    </listitem>
    <listitem>
      <para>À partir de la Barre de menus</para>
      <para>Choisissez <menuchoice><guimenu>Applications</guimenu><guimenuitem>Accessoires</guimenuitem><guimenuitem>Capture d'écran</guimenuitem></menuchoice>.</para>
    </listitem>
    <listitem>
      <para>À partir d'un terminal</para>
      <para>La commande <command>gnome-screenshot</command> permet de réaliser une capture d'écran. La capture s'effectue pour tout l'écran et la boîte de dialogue <guilabel>Enregistrer la capture d'écran</guilabel> apparaît. Celle-ci permet d'enregistrer la capture d'écran.</para>
      <para>Vous pouvez également utiliser les options de la commande <command>gnome-screenshot</command> comme suit :</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>Option</para>
              </entry>
              <entry>
                <para>Fonction</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <command>--window</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Réalise une capture de la fenêtre active.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <command>--delay=<replaceable>secondes</replaceable></command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Réalise une capture d'écran après le nombre de secondes spécifié et affiche ensuite la boîte de dialogue <guilabel>Enregistrer la capture d'écran</guilabel>. Celle-ci permet d'enregistrer la capture d'écran.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <command>--include-border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Réalise une capture d'écran qui inclut la bordure de la fenêtre.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <command>--remove-border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Réalise une capture d'écran sans la bordure de la fenêtre.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <command>--border-effect=shadow</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Réalise une capture d'écran et ajoute un effet d'ombre portée autour d'elle.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <command>--border-effect=border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Réalise une capture d'écran et entoure la capture d'un cadre.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <command>--interactive</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Ouvre une fenêtre qui vous permet de configurer les options avant de faire la capture d'écran.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <command>--help</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Affiche les options de la commande.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
    </listitem>
  </itemizedlist>

  <para>Lorsque vous réalisez une capture d'écran, la boîte de dialogue <guilabel>Enregistrer la capture d'écran</guilabel> apparaît. Pour enregistrer la capture en tant qu'image, saisissez le nom de fichier de la capture, choisissez un emplacement dans la liste déroulante et cliquez sur le bouton <guilabel>Enregistrer</guilabel>. Vous pouvez également utiliser le bouton <guilabel>Copier dans le presse-papiers</guilabel> pour copier l'image dans le presse-papiers ou la transférer vers une autre application en faisant un glisser-déposer.</para>
  
</section>

<!-- ============= Yelp ============================= -->
<section id="yelp">
  <title>Navigateur d'aide Yelp</title>
  <indexterm>
    <primary>Yelp</primary>
  </indexterm>
  <!-- ============= Introduction ============================== -->

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

    <para>Le <application>navigateur d'aide Yelp</application> permet de consulter la documentation de GNOME et d'autres composants dans des formats divers. Ces formats comprennent les fichiers Docbook, les pages d'aide HTML, les pages de manuel et les pages info (la prise en charge des pages de manuel et des pages info est une option à la compilation). En dépit des différents formats pris en charge, Yelp fait tout son possible pour présenter une apparence la plus cohérente possible quel que soit le format du document original.</para>

    <para>Le <application>navigateur d'aide Yelp</application> est internationalisé, ce qui signifie qu'il prend en charge l'affichage de documents dans différentes langues. Les documents doivent bien sûr être traduits pour chaque langue et installés correctement pour que le navigateur d'aide Yelp soit capable de les afficher.</para>
  </section>

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

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

    <section>
      <title>Lancement du <application>navigateur d'aide Yelp</application></title>

      <para>Le <application>navigateur d'aide Yelp</application> peut être lancé de différentes manières :</para>

      <para><variablelist>
          <varlistentry>
            <term>Menu <guimenu>Système</guimenu></term>

            <listitem>
              <para>Choisissez <application>Aide</application></para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>Ligne de commande</term>

            <listitem>
              <para>Exécutez la commande suivante : <command>yelp</command></para>
            </listitem>
          </varlistentry>
        </variablelist></para>
    </section>

    <section>
      <title>Interface</title>

      <para>Au démarrage du <application>navigateur d'aide Yelp</application>, la fenêtre suivante apparaît.</para>

      <para><figure id="fig-yelp-window">
          <title>Fenêtre du <application>navigateur d'aide Yelp</application></title>

          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_window.png"/>
            </imageobject>
          </mediaobject>
        </figure>Le <application>navigateur d'aide Yelp</application> contient les éléments suivants dans la <xref linkend="fig-yelp-window"/></para>

      <variablelist>
        <varlistentry>
          <term><interface>Barre de menus</interface></term>

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

                  <listitem>
                    <para>Ce menu permet d'ouvrir une nouvelle fenêtre, de voir la page « À propos de ce document », d'imprimer le document actuel ou de fermer la fenêtre.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term><guimenu>Édition</guimenu></term>

                  <listitem>
                    <para>Ce menu permet de copier, de tout sélectionner, de rechercher ou de définir les préférences.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term><guimenu>Aller</guimenu></term>

                  <listitem>
                    <para>Ce menu permet de se rendre à la page suivante ou précédente et d'afficher le sommaire de l'aide. Si vous consultez un document DocBook, ce menu permet de passer à la section suivante ou précédente et d'afficher le sommaire.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term><guimenu>Signets</guimenu></term>

                  <listitem>
                    <para>Ce menu permet d'ajouter ou de modifier des signets.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term><guimenu>Aide</guimenu></term>

                  <listitem>
                    <para>Ce menu permet d'afficher des informations au sujet du <application>navigateur d'aide Yelp</application> et des contributeurs de ce projet par l'élément de menu <guimenuitem>À propos</guimenuitem>. Ouvrez le présent document avec l'élément de menu <guimenuitem>Sommaire</guimenuitem> ou en appuyant sur <keycap>F1</keycap>.</para>
                  </listitem>
                </varlistentry>
              </variablelist></para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term><interface>Barre d'outils</interface></term>

          <listitem>
            <para><variablelist>
                <varlistentry>
                  <term><guibutton>Précédent</guibutton></term>

                  <listitem>
                    <para>Ce bouton permet de remonter dans l'historique de navigation du document.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term><guibutton>Suivant</guibutton></term>

                  <listitem>
                    <para>Ce bouton permet d'avancer dans l'historique de navigation du document.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term><guibutton>Sommaire de l'aide</guibutton></term>

                  <listitem>
                    <para>Ce bouton permet de revenir à la table des matières principale (affichée dans la <xref linkend="fig-yelp-window"/>).</para>
                  </listitem>
                </varlistentry>
              </variablelist></para>
          </listitem>
        </varlistentry>

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

          <listitem>
            <para>Le volet de navigation contient la table des matières ou le contenu de la documentation. Cette table vous permet de trouver facilement la documentation recherchée.</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </section>
  </section>

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

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

    <section>
      <title>Ouverture d'un document</title>

      <para>Pour ouvrir un document dans le <application>navigateur d'aide Yelp</application>, utilisez le sommaire de l'aide pour rechercher le document souhaité.</para>

      <para>Il est aussi possible d'afficher un document particulier en lançant le navigateur d'aide Yelp à partir de la ligne de commande ou en glissant les fichiers dans Yelp. Consultez <xref linkend="yelp-advanced-cmdline"/> pour en savoir plus à ce sujet.</para>
    </section>

    <section>
      <title>Ouverture d'une nouvelle fenêtre</title>

      <para>Pour ouvrir une nouvelle fenêtre :</para>

      <para><itemizedlist>
          <listitem>
            <para>Choisissez <menuchoice><guimenu>Fichier</guimenu><guimenuitem>Nouvelle fenêtre</guimenuitem></menuchoice></para>
          </listitem>

          <listitem>
            <para>Utilisez le raccourci clavier <keycap>Ctrl</keycap><keycap>N</keycap></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>À propos de ce document</title>

      <para>Pour afficher des informations sur le document actuellement ouvert :</para>

      <para><itemizedlist>
          <listitem>
            <para>Choisissez <menuchoice><guimenu>Fichier</guimenu><guimenuitem>À propos de ce document</guimenuitem></menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>Cette option n'est disponible que pour la documentation DocBook. Les notices légales et les contributeurs de la documentation sont généralement visibles dans cette section.</para>
        </note></para>
    </section>

    <section>
      <title>Impression d'une page</title>

      <para>Pour imprimer n'importe quelle page visible dans le <application>navigateur d'aide Yelp</application> :</para>

      <para><itemizedlist>
          <listitem>
            <para>Choisissez <menuchoice><guimenu>Fichier</guimenu><guimenuitem>Imprimer cette page</guimenuitem></menuchoice></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Impression d'un document</title>

      <para>Pour imprimer un document en entier :</para>

      <para><itemizedlist>
          <listitem>
            <para>Choisissez <menuchoice><guimenu>Fichier</guimenu><guimenuitem>Imprimer ce document</guimenuitem></menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>Cette option n'est disponible que pour de la documentation au format DocBook.</para>
        </note></para>
    </section>

    <section>
      <title>Fermeture d'une fenêtre</title>

      <para>Pour fermer une fenêtre dans le <application>navigateur d'aide Yelp</application>, procédez comme suit :</para>

      <para><itemizedlist>
          <listitem>
            <para>Choisissez <menuchoice><guimenu>Fichier</guimenu><guimenuitem>Fermer la fenêtre</guimenuitem></menuchoice></para>
          </listitem>

          <listitem>
            <para>Utilisez le raccourci clavier <keycombo><keycap>Ctrl</keycap><keycap>W</keycap></keycombo></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Réglage des préférences</title>

      <para>Pour paramétrer les préférences du <application>navigateur d'aide Yelp</application> :</para>

      <para><itemizedlist>
          <listitem>
            <para>Choisissez <menuchoice><guimenu>Édition</guimenu><guimenuitem>Préférences</guimenuitem></menuchoice></para>
          </listitem>
        </itemizedlist>Une fenêtre ressemblant à la <xref linkend="yelp-preferences"/> apparaît :</para>

      <para><figure id="yelp-preferences">
          <title>Fenêtre des préférences du <application>navigateur d'aide Yelp</application></title>

          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_preferences.png"/>
            </imageobject>
          </mediaobject>
        </figure>Les options disponibles dans cette boîte de dialogue offrent les fonctionnalités suivantes :</para>

      <para><variablelist>
          <varlistentry>
            <term><guilabel>Utiliser les polices système</guilabel></term>

            <listitem>
              <para>Cochez cette option pour afficher la documentation avec les polices par défaut définies pour le bureau GNOME.</para>

              <para>Pour choisir vos propres polices d'affichage de la documentation, décochez cette option et cliquez sur les boutons en regard des libellés <guilabel>Chasse variable</guilabel> et <guilabel>Chasse fixe</guilabel>.</para>

              <para><variablelist>
                  <varlistentry>
                    <term><guilabel>Chasse variable</guilabel></term>

                    <listitem>
                      <para>C'est la police utilisée lorsqu'une chasse statique ou fixe n'est pas nécessaire. La majorité du texte est de ce type.</para>
                    </listitem>
                  </varlistentry>

                  <varlistentry>
                    <term><guilabel>Chasse fixe</guilabel></term>

                    <listitem>
                      <para>C'est la police utilisée lorsque tous les caractères doivent avoir la même dimension. En général, cette police sert à écrire des commandes, des bouts de programme ou d'autres textes similaires.</para>
                    </listitem>
                  </varlistentry>
                </variablelist></para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><guilabel>Naviguer avec le curseur</guilabel></term>

            <listitem>
              <para>Cochez cette option si vous souhaitez voir apparaître le curseur dans le <xref linkend="yelp-browser-pane"/>. Cela permet de naviguer plus facilement dans le document, car l'emplacement du curseur est visible.</para>
            </listitem>
          </varlistentry>
        </variablelist></para>
    </section>

    <section>
      <title>Recul dans l'historique de navigation</title>

      <para>Pour remonter dans l'historique de navigation du document :</para>

      <para><itemizedlist>
          <listitem>
            <para>Choisissez <menuchoice><guimenu>Aller</guimenu><guimenuitem>Précédent</guimenuitem></menuchoice></para>
          </listitem>

          <listitem>
            <para>Utilisez le raccourci clavier <keycombo><keycap>Alt</keycap><keycap>Flèche gauche</keycap></keycombo></para>
          </listitem>

          <listitem>
            <para>Utilisez le bouton <guibutton>Précédent</guibutton> dans la <interface>barre d'outils</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Avance dans l'historique de navigation</title>

      <para>Pour avancer dans l'historique de navigation du document :</para>

      <para><itemizedlist>
          <listitem>
            <para>Choisissez <menuchoice><guimenu>Aller</guimenu><guimenuitem>Suivant</guimenuitem></menuchoice></para>
          </listitem>

          <listitem>
            <para>Utilisez le raccourci clavier <keycombo><keycap>Alt</keycap><keycap>Flèche droite</keycap></keycombo></para>
          </listitem>

          <listitem>
            <para>Utilisez le bouton <guibutton>Suivant</guibutton> dans la <interface>barre d'outils</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Affichage du sommaire de l'aide</title>

      <para>Pour afficher le sommaire de l'aide :</para>

      <para><itemizedlist>
          <listitem>
            <para>Choisissez <menuchoice><guimenu>Aller</guimenu><guimenuitem>Sommaire de l'aide</guimenuitem></menuchoice></para>
          </listitem>

          <listitem>
            <para>Utilisez le raccourci clavier <keycombo><keycap>Alt</keycap><keycap>Origine</keycap></keycombo></para>
          </listitem>

          <listitem>
            <para>Utilisez le bouton <guibutton>Sommaire de l'aide</guibutton> dans la <interface>barre d'outils</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Retour à la section précédente</title>

      <para>Pour revenir à la section précédente :</para>

      <para><itemizedlist>
          <listitem>
            <para>Choisissez <menuchoice><guimenu>Aller</guimenu><guimenuitem>Section précédente</guimenuitem></menuchoice></para>
          </listitem>

          <listitem>
            <para>Utilisez le raccourci clavier <keycombo><keycap>Alt</keycap><keycap>Flèche haut</keycap></keycombo></para>
          </listitem>
        </itemizedlist><note>
          <para>Cette option n'est disponible que pour les documents au format DocBook.</para>
        </note></para>
    </section>

    <section>
      <title>Passage à la section suivante</title>

      <para>Pour passer à la section suivante :</para>

      <para><itemizedlist>
          <listitem>
            <para>Choisissez <menuchoice><guimenu>Aller</guimenu><guimenuitem>Section suivante</guimenuitem></menuchoice></para>
          </listitem>

          <listitem>
            <para>Utilisez le raccourci clavier <keycombo><keycap>Alt</keycap><keycap>Flèche bas</keycap></keycombo></para>
          </listitem>
        </itemizedlist><note>
          <para>Cette option n'est disponible que pour les documents au format DocBook.</para>
        </note></para>
    </section>

    <section>
      <title>Affichage du sommaire du document</title>

      <para>Pour afficher le sommaire du document :</para>

      <para><itemizedlist>
          <listitem>
            <para>Choisissez <menuchoice><guimenu>Aller</guimenu><guimenuitem>Sommaire</guimenuitem></menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>Cette option n'est disponible que pour les documents au format DocBook.</para>
        </note></para>
    </section>

    <section>
      <title>Ajout d'un signet</title>

      <para>Pour ajouter un signet vers un document particulier :</para>

      <para><itemizedlist>
          <listitem>
            <para>Choisissez <menuchoice><guimenu>Signets</guimenu><guimenuitem>Ajouter un signet</guimenuitem></menuchoice></para>
          </listitem>

          <listitem>
            <para>Utilisez le raccourci clavier <keycombo><keycap>Ctrl</keycap><keycap>D</keycap></keycombo></para>
          </listitem>
        </itemizedlist>Une fenêtre similaire à la <xref linkend="yelp-add-bookmark"/> apparaît.</para>

      <para><figure id="yelp-add-bookmark">
          <title>Fenêtre d'ajout de signet</title>

          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_add_bookmark.png"/>
            </imageobject>
          </mediaobject>
        </figure>Saisissez le titre du signet dans le champ <guilabel>Titre</guilabel>. Cliquez ensuite sur <guibutton>Ajouter</guibutton> pour ajouter le signet ou cliquez sur <guibutton>Annuler</guibutton> pour annuler.</para>
    </section>

    <section>
      <title>Édition des signets</title>

      <para>Pour éditer votre collection de signets :</para>

      <para><itemizedlist>
          <listitem>
            <para>Choisissez <menuchoice><guimenu>Signets</guimenu><guimenuitem>Éditer les signets</guimenuitem></menuchoice></para>
          </listitem>

          <listitem>
            <para>Utilisez le raccourci clavier <keycombo><keycap>Ctrl</keycap><keycap>B</keycap></keycombo></para>
          </listitem>
        </itemizedlist>Une fenêtre similaire à la <xref linkend="yelp-edit-bookmarks"/> apparaît.</para>

      <para><figure id="yelp-edit-bookmarks">
          <title>Fenêtre d'édition des signets</title>

          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_edit_bookmarks.png"/>
            </imageobject>
          </mediaobject>
        </figure>Vous pouvez gérer vos signets à l'aide de cette fenêtre par les actions suivantes :</para>

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

            <listitem>
              <para>Ce bouton permet d'ouvrir le signet sélectionné dans une nouvelle fenêtre.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><guibutton>Renommer</guibutton></term>

            <listitem>
              <para>Ce bouton permet de renommer le signet sélectionné.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><guibutton>Enlever</guibutton></term>

            <listitem>
              <para>Ce bouton permet de supprimer le signet de votre collection.</para>
            </listitem>
          </varlistentry>
        </variablelist>Après avoir terminé de gérer vos signets, cliquez sur le bouton <guibutton>Fermer</guibutton> pour sortir de la fenêtre d'édition des signets.</para>
    </section>

    <section>
      <title>Aide de Yelp</title>

      <para>Pour obtenir de l'aide sur le <application>navigateur d'aide Yelp</application> (et donc consulter le présent document) :</para>

      <para><itemizedlist>
          <listitem>
            <para>Choisissez <menuchoice><guimenu>Aide</guimenu><guimenuitem>Sommaire</guimenuitem></menuchoice></para>
          </listitem>
        </itemizedlist></para>
    </section>
  </section>

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

  <section id="yelp-advanced">
    <title>Fonctions avancées</title>

   <section id="yelp-open-specific" xreflabel="Opening Specific Documents">
    <title>Ouverture de documents spécifiques</title>

    <section id="yelp-open-drag">
      <title>Ouverture de documents à partir du gestionnaire de fichiers</title>
        <para>Pour ouvrir un document comme un fichier XML à partir du gestionnaire de fichiers, ouvrez-le dans le gestionnaire de fichiers <application>Nautilus</application> ou glissez son icône de <application>Nautilus</application> vers le volet d'affichage ou le lanceur de <application>Yelp</application>.</para>
    </section>

    <section id="yelp-advanced-cmdline" xreflabel="Using the Command Line to Open Documents">
      <title>Utilisation de la ligne de commande pour ouvrir des documents</title>

      <para>Le <application>navigateur d'aide Yelp</application> prend en charge l'ouverture de documents à partir de la ligne de commande. Plusieurs URI (Uniform Resource Identifiers) peuvent être utilisés. Notamment :</para>

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

            <listitem>
              <para>Cet URI donne accès à un fichier avec yelp, par exemple :</para>

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

            </listitem>
          </varlistentry>

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

            <listitem>
              <para>Cet URI donne accès aux documents d'aide de GNOME, habituellement écrits au format DocBook.</para>

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

              <para>Si vous souhaitez ouvrir le document d'aide à une section bien précise, complétez l'URI avec un point d'interrogation suivi de l'identifiant de la section.</para>
              
              <screen><userinput>yelp ghelp:user-guide?yelp-advanced-cmdline</userinput></screen>
            </listitem>
          </varlistentry>

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

            <listitem>
              <para>Cet URI donne accès à une page de manuel. Vous pouvez compléter l'URI avec le numéro de section de la page de manuel s'il en existe plusieurs avec le même nom. Le numéro de section doit être entouré de parenthèses, il est donc souhaitable de neutraliser l'argument afin que le shell n'interprète pas les parenthèses.</para>

              <screen><userinput>yelp man:gcalctool</userinput></screen>
              
              <para>ou</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>Cet URI donne accès à une page info GNU.</para>

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

   </section>

    <section>
      <title>Actualisation du contenu sur demande</title>

      <para>Le <application>navigateur d'aide Yelp</application> prend en charge le raccourci clavier <keycombo><keycap>Ctrl</keycap><keycap>R</keycap></keycombo> qui recharge le document DocBook actuellement ouvert. Cela permet aux développeurs de voir les changements des documents lors de leur conception.</para>
    </section>
  </section>

  <section id="yelp-moreinfo">
    <title>Informations supplémentaires</title>

    <para>Cette section décrit certaines applications auxiliaires utilisées par le <application>navigateur d'aide Yelp</application>, et présente des ressources contenant de plus amples informations au sujet du <application>navigateur d'aide Yelp</application>.</para>

    <section>
      <title>Scrollkeeper</title>

      <para>Le <application>navigateur d'aide Yelp</application> utilise scrollkeeper pour générer les sommaires de la documentation DocBook et HTML, ainsi que pour garder la trace des traductions de chaque document.</para>
    </section>

    <section>
      <title>Utilitaires de documentation GNOME</title>

      <para>La documentation distribuée avec GNOME utilise un ensemble d'utilitaires pour différentes choses :</para>

      <para><itemizedlist>
          <listitem>
            <para>Faciliter la traduction de documents dans différentes langues.</para>
          </listitem>

          <listitem>
            <para>Fournir un ensemble d'outils pour aider à empaqueter et installer la documentation dans les emplacements adéquats et pour enregistrer la documentation dans scrollkeeper.</para>
          </listitem>

          <listitem>
            <para>Effectuer la conversion du format DocBook vers un format destiné à l'affichage.</para>
          </listitem>
        </itemizedlist>Le <application>navigateur d'aide Yelp</application> s'appuie sur les <ulink url="ghelp:gnome-doc-xslt">feuilles de style XSLT GNOME</ulink> pour effectuer la conversion de DocBook vers le HTML. Les <ulink url="ghelp:gnome-doc-make">utilitaires pour la construction de la documentation GNOME</ulink> sont indispensables aux auteurs d'applications pour installer et enregistrer la documentation dans le système d'aide.</para>
    </section>

    <section>
      <title>Page d'accueil et liste de diffusion</title>

      <para>Pour plus d'informations sur le <application>navigateur d'aide Yelp</application>, visitez le site du projet de documentation, <ulink url="http://live.gnome.org/Yelp">http://live.gnome.org/Yelp</ulink> (en anglais), ou inscrivez-vous à la liste de diffusion, <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>Participer au projet de documentation GNOME</title>

    <para>Si vous souhaitez aider à écrire et à mettre à jour la documentation du projet GNOME, visitez la page d'accueil du projet de documentation : <ulink url="http://live.gnome.org/DocumentationProject">http://live.gnome.org/DocumentationProject</ulink> (en anglais).</para>
  </section>

</section>

</chapter>
