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

  <highlights>
    <para>Ce chapitre documente quelques outils et utilitaires du bureau MATE.</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>Run Application dialog, using</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>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>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>pluma</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>screenshots, taking</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>Print Screen</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>Print Screen</keycap></keycombo></para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Réalise une capture de la fenêtre active.</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>Choose <menuchoice><guimenu>Applications</guimenu><guimenuitem>Accessories</guimenuitem>
      <guimenuitem>Take Screenshot</guimenuitem></menuchoice>.</para>
    </listitem>
    <listitem>
      <para>À partir d'un terminal</para>
      <para>La commande <command>mate-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>mate-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>seconds</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 MATE 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><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>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>Edit</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>Go</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>Bookmarks</guimenu></term>

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

                <varlistentry>
                  <term><guimenu>Help</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>Toolbar</interface></term>

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

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

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

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

                <varlistentry>
                  <term><guibutton>Help Topics</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>Browser Pane</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>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>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>Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>New Window</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>Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>About This 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>Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>Print this 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>Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>Print this 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>Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>Close Window</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>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>Cochez cette option pour afficher la documentation avec les polices par défaut définies pour le bureau MATE.</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>Variable Width</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>Fixed Width</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>Browse with caret</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>Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Back</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>Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Forward</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>Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Help Topics</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>Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Previous Section</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>Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Next Section</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>Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Contents</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>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>Édition des signets</title>

      <para>Pour éditer votre collection de signets :</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>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>Click <menuchoice>
                <guimenu>Help</guimenu>

                <guimenuitem>Contents</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>Caja</application> ou glissez son icône de <application>Caja</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/mate/help/gcalctool/C/gcalctool.xml</userinput></screen>

            </listitem>
          </varlistentry>

          <varlistentry>
            <term><option>help:</option> ou <option>mate-help:</option></term>

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

              <screen><userinput>yelp help: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 help: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 MATE</title>

      <para>La documentation distribuée avec MATE utilise un ensemble d'utilitaires pour différentes choses :</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>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/mate-doc-devel-list">mate-doc-devel-list@gnome.org</ulink>.</para>
    </section>
  </section>

  <section id="yelp-joininggdp">
    <title>Participer au projet de documentation MATE</title>

    <para>Si vous souhaitez aider à écrire et à mettre à jour la documentation du projet MATE, 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>
