<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY legal SYSTEM "legal.xml">
<!ENTITY appversion "0.1.5">
<!ENTITY manrevision "0.2.0">
<!ENTITY date "2007-06-29">
<!ENTITY app "<application>Accerciser</application>">
]>
<!-- 
      (Do not remove this comment block.)
  Maintained by the GNOME Documentation Project
  http://developer.gnome.org/projects/gdp
  Template version: 2.0 beta
  Template last modified Apr 11, 2002
-->
<!-- =============Document Header ============================= -->
<article id="index" lang="fr">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <articleinfo> 
    <title>Manuel d'<application>Accerciser</application> v0.2.0</title>       

    <copyright> 
      <year>2006</year> 
      <year>2007</year> 
      <year>2008</year> 
      <holder>IBM Corporation</holder> 
    </copyright><copyright><year>2007</year><holder>Robert-André Mauchin (zebob.m@pengzone.org)</holder></copyright><copyright><year>2008</year><holder>Claude Paroz (claude@2xlibre.net)</holder></copyright> 

<!-- translators: uncomment this:

  <copyright>
   <year>2002</year>
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
  </copyright>

   -->
<!-- An address can be added to the publisher information.  If a role is 
     not specified, the publisher/author is the same for all versions of the 
     document.  -->
    <publisher> 
      <publishername>Projet de documentation GNOME</publishername> 
    </publisher> 

	<!-- This file  contains link to license for the documentation (GNU FDL), and 
        other legal stuff such as "NO WARRANTY" statement. Please do not change 
	any of this. -->

    <authorgroup> 
      <author role="maintainer"> 
        <firstname>Eitan</firstname> 
        <surname>Isaacson</surname> 
        <affiliation> 
          <orgname>Équipe d'Accerciser</orgname> 
          <address> <email>eitan@ascender.com</email> </address> 
        </affiliation> 
      </author> 

      <author role="editor"> 
        <firstname>Peter</firstname> 
        <surname>Parente</surname> 
        <affiliation> 
          <orgname>Équipe d'Accerciser</orgname> 
          <address> <email>pparent@us.ibm.com</email> </address> 
        </affiliation> 
      </author> 
      
<!-- This is appropriate place for other contributors: translators,
     maintainers,  etc. Commented out by default.
     
      <othercredit role="translator">
        <firstname>Latin</firstname> 
        <surname>Translator 1</surname> 
        <affiliation> 
          <orgname>Latin Translation Team</orgname> 
          <address> <email>translator@gnome.org</email> </address> 
          </affiliation>
          <contrib>Latin translation</contrib>
      </othercredit>
-->
    </authorgroup>


<!-- According to GNU FDL, revision history is mandatory if you are -->
<!-- modifying/reusing someone else's document.  If not, you can omit it. -->
<!-- Remember to remove the &manrevision; entity from the revision entries other
-->
<!-- than the current revision. -->
<!-- The revision numbering system for GNOME manuals is as follows: -->
<!-- * the revision number consists of two components -->
<!-- * the first component of the revision number reflects the release version of the GNOME desktop. -->
<!-- * the second component of the revision number is a decimal unit that is incremented with each revision of the manual. -->
<!-- For example, if the GNOME desktop release is V2.x, the first version of the manual that -->
<!-- is written in that desktop timeframe is V2.0, the second version of the manual is V2.1, etc. -->
<!-- When the desktop release version changes to V3.x, the revision number of the manual changes -->
<!-- to V3.0, and so on. -->  
    <revhistory>
      <revision> 
        <revnumber>Manuel d'Accerciser v0.2.0</revnumber> 
        <date>29/06/2007</date> 
        <revdescription> 
          <para role="author">Eitan Isaacson <email>eitan@ascender.com</email></para>
          <para role="publisher">Équipe d'Accerciser</para>
        </revdescription> 
      </revision> 
    </revhistory> 

    <releaseinfo>Ce manuel documente la version 0.2.0 d'Accerciser.</releaseinfo> 
    <abstract role="description">
      <para>Ce manuel documente l'utilisation d'<application>Accerciser</application>.</para>
    </abstract> 
    <legalnotice> 
      <title>Votre avis</title> 
      <para>Pour rapporter une anomalie ou émettre une suggestion concernant <application>Accerciser</application> ou ce manuel, procédez comme indiqué sur la <ulink url="ghelp:gnome-feedback" type="help">page de réactions sur GNOME</ulink>.</para>
<!-- Translators may also add here feedback address for translations -->
    </legalnotice> 
  </articleinfo> 

  <indexterm zone="index"> 
    <primary>Accerciser</primary> 
  </indexterm> 

<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->
<!-- Use the Introduction section to give a brief overview of what
     the application is and what it does. -->
  <sect1 id="myapp-introduction">
    <title>Introduction</title> 

    <para><application>Accerciser</application> est un explorateur d'accessibilité interactif en Python pour le bureau GNOME. Il utilise <ulink url="http://directory.fsf.org/at-spi.html" type="http">AT-SPI</ulink> pour inspecter et commander les composants graphiques (widgets), vous permettant ainsi de vérifier si une application fournit des informations correctes aux aides techniques et environnements de tests automatisés. <application>Accerciser</application> a une structure de greffon simple que vous pouvez utiliser pour créer des vues personnalisées des informations d'accessibilité.</para>

    <para>Par définition, <application>Accerciser</application> est un outil <ulink url="http://svn.gnome.org/viewvc/at-poke" type="http">at-poke</ulink> de dernière génération.</para>

  </sect1>

<!-- =========== Getting Started ============================== -->
<!-- Use the Getting Started section to describe the steps required
     to start the application and to describe the user interface components
     of the application. If there is other information that it is important
     for readers to know before they start using the application, you should
     also include this information here. 
     If the information about how to get started is very short, you can 
     include it in the Introduction and omit this section. -->

  <sect1 id="accerciser-getting-started"> 
    <title>Premiers pas</title> 

    <sect2 id="myapp-start">
      <title>Lancement d'<application>Accerciser</application></title>
      <para>Vous pouvez lancer <application>Accerciser</application> des manières suivantes :</para> 
      <variablelist>
        <varlistentry>
          <term>Menu <guimenu>Applications</guimenu></term>
          <listitem>
            <para>Choisissez l'élément de menu <menuchoice><guisubmenu>Programmation</guisubmenu><guimenuitem>Accerciser</guimenuitem></menuchoice>.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Ligne de commande</term>
          <listitem>
            <para>Saisissez la commande suivante dans une fenêtre de terminal et appuyez sur la touche <keycap>Entrée</keycap> :</para>
            <para> 
              <command>accerciser</command> 
            </para> 
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>

    <sect2 id="accerciser-when-start">
      <title>Démarrage d'<application>Accerciser</application></title>
      <para>Lors du démarrage d'<application>Accerciser</application>, la fenêtre suivante est affichée.</para>

      <!-- ==== Figure ==== -->
      <figure id="mainwindow-fig"> 
        <title>Fenêtre principale d'<application>Accerciser</application></title> 
        <screenshot> 
          <mediaobject> 
            <imageobject><imagedata fileref="figures/accerciser.png" format="PNG"/> 
            </imageobject>
            <textobject> 
              <phrase>Affiche la fenêtre principale d'<application>Accerciser</application>. Contient la barre de titre, la barre de menus, l'arbre d'accessibilité, la zone d'affichage des greffons de droite et la zone d'affichage des greffons du bas. La barre de menus comporte les menus Fichier, Édition, Signets, Affichage et Aide.</phrase> 
            </textobject> 
          </mediaobject> 
        </screenshot> 
      </figure>
    <!-- ==== End of Figure ==== -->

    <!-- Include any descriptions of the GUI immediately after 
		 the screenshot of the main UI, -->
    <!-- for example, the items on the menubar and on the toolbar. 
		 This section is optional. -->

      <para>La fenêtre principale d'<application>Accerciser</application> contient les éléments suivants :</para>
      <variablelist>
        <varlistentry>
          <term>Barre de menus</term>
          <listitem>
			<para>La barre de menus contient les commandes pour gérer les greffons, organiser et utiliser les signets, actualiser l'arbre d'accessibilité et accéder au sommaire de l'aide.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Arbre d'accessibilité</term>
          <listitem>
			<para>L'arbre d'accessibilité permet de voir tous les éléments accessibles dès le niveau du bureau. En sélectionnant un élément accessible, vous pouvez l'inspecter plus en détails en utilisant les greffons chargés.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Zone des greffons de droite</term>
          <listitem>
            <para>C'est l'une des deux zones de greffons. Lorsqu'<application>Accerciser</application> est lancé pour la première fois, la plupart des greffons seront placés ici. Vous pouvez déplacer les onglets de greffons vers la zone de greffons du bas ou vers le bureau pour afficher deux greffons ou plus simultanément.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Zone des greffons du bas</term>
          <listitem>
            <para>Vous pouvez déplacer des greffons à partir de cette zone ou vers celle-ci comme pour la zone des greffons de droite.</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>
	<sect2>
	  <title>Gestion des zones de greffons</title>
	  <para><application>Accerciser</application> a deux modes pour accéder aux greffons. Vous pouvez basculer le mode de vue actuel avec le menu <menuchoice><guimenu>Affichage</guimenu><guimenuitem>Vue unique des greffons</guimenuitem></menuchoice> ou en appuyant sur <keycombo><keycap>CTRL</keycap><keycap>T</keycap></keycombo>. Lorsque la vue unique est activée, tous les greffons sont placés dans la zone des greffons en haut à droite et classés par ordre alphabétique. Ceci peut être utile pour les utilisateurs de lecteur d'écran qui ne font pas usage de la disposition spatiale flexible des greffons.Lorsque la vue unique est désactivée, les onglets de greffons peuvent être glissés et déposés dans les différentes zones de greffons, ou déplacés sur le bureau pour créer une nouvelle zone pour le greffon. La position des greffons peut également être modifiée avec le menu contextuel de greffon, qui peut être affiché soit depuis l'onglet du greffon, soit depuis la boîte de dialogue des préférences du greffon.</para>
	</sect2>
  </sect1>
<!-- ================ Usage ================================ -->
<!-- Use this section to describe how to use the application to perform the tasks for 
  which the application is designed. -->
  <sect1 id="myapp-usage"> 
    <title>Utilisation</title> 
    <para>Vous pouvez utiliser <application>Accerciser</application> pour inspecter n'importe quel composant accessible dans l'arbre en utilisant les greffons disponibles. La première étape est de sélectionner un élément accessible à inspecter en utilisant l'une des méthodes suivantes : <itemizedlist> 
      <listitem> 
        <para><xref linkend="accerciser-tree-select"/></para> 
      </listitem> 
      <listitem> 
        <para><xref linkend="accerciser-bookmarks"/></para> 
      </listitem> 
    </itemizedlist></para>
    <!-- ================ Usage Subsection ================================ -->

    <sect2 id="accerciser-tree-select"> 
      <title>Sélection d'un élément accessible via l'arbre d'accessibilité</title> 
      <para>Utilisez l'arborescence pour naviguer dans la hiérarchie des objets accessibles dont la racine est le bureau. Le développement d'un nœud de l'arbre présente ses fils immédiats, alors qu'ils disparaissent si vous le repliez. Chaque noeud dispose d'une icône correspondant à son application ou à son rôle de composant, ainsi que son nom d'élément accessible, le cas échéant. La deuxième colonne présente la liste des nœuds qui seront affichés si l'élément est développé.</para>
      
    </sect2> 
    <sect2 id="accerciser-bookmarks"> 
      <title>Utilisation des signets</title> 
      <para>Accerciser permet d'insérer des signets pour les éléments accessibles sélectionnés afin de les examiner ultérieurement. Ceci peut être pratique si l'application cible doit être redémarrée, par exemple après l'avoir reconstruite. Pour insérer un signet sur l'élément accessible sélectionné, cliquez sur <menuchoice><guimenu>Signets</guimenu><guimenuitem>Ajouter un signet</guimenuitem></menuchoice> ou appuyez sur <keycombo><keycap>Ctrl</keycap><keycap>D</keycap></keycombo>.</para>
      <para>Dans Accerciser, les signets vers les éléments accessibles sont définis par un nom d'application et un « chemin » vers l'élément accessible dans la hiérarchie des éléments accessibles interne à l'application. Quand l'application cible est dans un état différent (par ex. plusieurs cadres de niveau supérieur), le chemin peut ne pas être correct.</para>
      <para>Les signets peuvent être gérés en accédant à la boîte de dialogue d'édition des signets via le menu <menuchoice><guimenu>Signets</guimenu><guimenuitem>Éditer les signets</guimenuitem></menuchoice>.</para>
    </sect2> 
  </sect1>

  <!-- ============= Plugins =================================== -->
  <sect1 id="accerciser-default-plugins"> 
    <title>Greffons par défaut</title> <para><application>Accerciser</application> est fourni avec de nombreux greffons par défaut. Ces greffons vous permettent de visualiser des informations variées concernant l'élément accessible sélectionné dans l'arbre et ses voisins. Les greffons suivants sont disponibles dans la version 0.1.5 :</para>
    <itemizedlist> 
      <listitem> 
        <para><xref linkend="accerciser-iface-viewer"/></para> 
      </listitem> 
      <listitem> 
        <para><xref linkend="accerciser-event-monitor"/></para> 
      </listitem>
      <listitem> 
        <para><xref linkend="accerciser-console"/></para>
      </listitem> 
      <listitem> 
        <para><xref linkend="accerciser-api-browser"/></para>
      </listitem> 
      <listitem> 
        <para><xref linkend="accerciser-script-recorder"/></para>
      </listitem> 
      <listitem> 
        <para><xref linkend="accerciser-quick-select"/></para>
      </listitem> 
      <listitem> 
        <para><xref linkend="accerciser-validate"/></para>
      </listitem> 
    </itemizedlist> 

    <sect2 id="accerciser-iface-viewer"> 
      <title>Visionneur d'interface</title>
      <para>Ce greffon affiche des informations concernant les interfaces disponibles pour l'élément accessible sélectionné dans l'arbre. Les interfaces non prises en charge sont grisées. Différents instruments pour visualiser et contrôler une interface sont disponibles sous chaque icône d'extension.</para>

      <figure id="iface-viewer-fig"> 
        <title>Visionneur d'interface</title> 
        <screenshot> 
          <mediaobject> 
            <imageobject>
              <imagedata fileref="figures/interface_viewer.png" format="PNG"/> 
            </imageobject>
            <textobject> 
              <phrase>Les interfaces prises en charge par l'élément accessible sélectionné sont affichées comme sensitives.</phrase>
            </textobject> 
          </mediaobject> 
        </screenshot> 
      </figure>
    </sect2> 
    <sect2 id="accerciser-event-monitor"> 
      <title>Moniteur d'événements</title> 
      <para>Ce greffon surveille les types d'événements sélectionnés depuis l'élément accessible sélectionné dans l'arbre, pour une application donnée, ou pour le bureau complet.</para>
      <figure id="event-monitor-fig"> 
        <title>Moniteur d'événements</title> 
        <screenshot> 
          <mediaobject> 
            <imageobject><imagedata fileref="figures/event_monitor.png" format="PNG"/> 
            </imageobject>
            <textobject> 
              <phrase>La partie basse de la fenêtre du moniteur d'événements vous permet de choisir le type et la source des événements.</phrase> 
            </textobject> 
          </mediaobject> 
        </screenshot> 
      </figure>
      <tip>
        <para>Vous pouvez mettre en évidence le dernier événement journalisé pour un usage futur en appuyant sur <keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>L</keycap></keycombo> n'importe où sur le bureau. Référez-vous à <xref linkend="accerciser-hotkey-config"/> pour modifier cette combinaison de touches.</para>
      </tip>
    </sect2> 
    <sect2 id="accerciser-console"> 
      <title>Console IPython</title> 
      <para>Ce greffon est une console </para> 
    </sect2> 
    <sect2 id="accerciser-api-browser"> 
      <title>Navigateur d'API</title>
      <para>Ce greffon affiche les interfaces, méthodes et attributs pris en charge par l'élément accessible sélectionné dans l'arbre.</para>
      <figure id="api-browser-fig"> 
        <title>Navigateur d'API</title>
        <screenshot> 
          <mediaobject> 
            <imageobject><imagedata fileref="figures/api_browser.png" format="PNG"/> 
            </imageobject>
            <textobject> 
              <phrase>Le navigateur d'API</phrase> 
            </textobject> 
          </mediaobject> 
        </screenshot> 
      </figure>
    </sect2> 
    <sect2 id="accerciser-script-recorder"> 
      <title>Enregistreur de script</title>
      <para>L'enregistreur de script de <application>Accerciser</application> permet aux utilisateurs d'enregistrer les interactions du clavier avec les autres applications du bureau afin de générer des scripts de test de l'interface utilisateur. Le greffon prend actuellement en charge la construction de script pour trois plateformes : Dogtail, LDTP, et une API intégrée à Accerciser. Dès que vousavez cliqué sur le bouton « Enregistrer », chaque interaction du clavier est enregistrée dans un script qui pourra être lancé plus tard en tant que script autonome.</para>
      <figure id="script-recorder-fig"> 
        <title>Enregistreur de script</title>
        <screenshot> 
          <mediaobject> 
            <imageobject><imagedata fileref="figures/script_recorder.png" format="PNG"/> 
            </imageobject>
            <textobject> 
              <phrase>L'enregistreur de script</phrase> 
            </textobject> 
          </mediaobject> 
        </screenshot> 
      </figure>
    </sect2> 
    <sect2 id="accerciser-quick-select"> 
      <title>Sélection rapide</title>
      <para>Ce greffon fournit des raccourcis globaux pour sélectionner rapidement des éléments accessibles via l'interface utilisateur de l'application cible. Vous pouvez sélectionner l'élément accessible du dernier widget actifen appuyant sur <keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>A</keycap></keycombo>. Pour sélectionner l'élément accessible du widget situé sous le pointeur, appuyez sur <keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>T</keycap></keycombo>.</para>
    </sect2> 

    <sect2 id="accerciser-validate"> 
      <title>Validation</title>
      <para>Ce greffon contrôle les problèmes d'accessibilité dans les applications et génère un rapport intégrant la sévérité et la description des problèmes. Dans le rapport, les erreurs sont liées à la documentation pour indiquer comment remédier aux problèmes courants. Le greffon peut être complété par des schémas de test définissant des règles de validation.</para>

      <para>Pour lancer une validation, sélectionnez d'abord un élément dans l'arbre d'accessibilité. Le greffon testera l'élément sélectionné ainsi que tous ses descendants. Sélectionnez ensuite un schéma à utiliser pour le test. Puis cliquez sur le bouton <guibutton>Valider</guibutton> pour lancer le test. Vous pouvez interrompre le test en cliquant une nouvelle fois sur ce bouton.</para>

      <para>Lorsque le test est terminé, le tableau du rapport montre la sévérité et la description de toutes les erreurs. Faites un double-clic sur une ligne du tableau pour afficher dans l'arbre les éléments accessibles correspondants. Lorsqu'un élément est sélectionné, cliquez sur <guibutton>Aide</guibutton> pour obtenir des informations sur la manière de résoudre le problème.</para>
    </sect2>

  </sect1>
  <!-- ============= Customization ============================= -->
  <!-- Use this section to describe how to customize the application. -->
  <sect1 id="accerciser-prefs"> 
    <title>Préférences</title>
    <para>Certains éléments d'<application>Accerciser</application> sont paramétrables :</para>
    <itemizedlist> 
      <listitem> 
        <para><xref linkend="accerciser-plugin-layout"/></para> 
      </listitem>
      <listitem> 
        <para><xref linkend="accerciser-hotkey-config"/></para> 
      </listitem>
    </itemizedlist>
    <sect2 id="accerciser-plugin-layout">
      <title>Agencement des greffons</title> 
      <para>Il y a deux méthodes pour configurer l'agencement des greffons dans <application>Accerciser</application>. Vous pouvez tout d'abord utiliser le menu <menuchoice><guimenu>Édition</guimenu><guimenuitem>Préférences</guimenuitem></menuchoice> pour afficher la boîte de dialogue <guilabel>Préférences</guilabel>. Celle-ci contient des onglets pour chaque section. Sélectionnez l'onglet <guilabel>Greffons</guilabel> pour afficher la liste de tous les greffons disponibles. Faites un clic droit sur l'un d'entre eux pour configurer son affichage.</para>
        
      <para>Vous pouvez également glisser-déposer les onglets de greffons pour les déplacer vers la zone de greffon du bas ou de droite. En déplaçant un onglet sur le bureau, vous créez une nouvelle fenêtre, dans laquelle vous pouvez déposer des greffons.</para>
    </sect2>
    <sect2 id="accerciser-hotkey-config">
      <title>Configuration globale des raccourcis</title>
      <para>Certains éléments d'<application>Accerciser</application> peuvent activer certaines fonctionnalités via des raccourcis. Les combinaisons de raccourcis peuvent être modifiées par la boîte de dialogue <guilabel>Préférences</guilabel> (menu <menuchoice><guimenu>Édition</guimenu><guimenuitem>Préférences</guimenuitem></menuchoice>). Cliquez ensuite sur l'onglet <guilabel>Raccourcis généraux</guilabel>. Une liste des fonctions des raccourcis disponibles y est présente. Modifiez les raccourcis comme vous le souhaitez.</para>
    </sect2>
  </sect1>
<!-- ============= Bugs ================================== -->
<!-- This section is optional and is commented out by default. 
     You can use it to describe known bugs and limitations of the 
	  program if there are any - please be frank and list all
     problems you know of. 
  
  <sect1 id="mayapp-bugs">
  <title>Known Bugs and Limitations</title>
  <para> </para>
 </sect1>
-->
<!-- ============= About ================================== -->
<!-- This section contains info about the program (not docs), such as
      author's name(s), web page, license, feedback address. This
      section is optional: primary place for this info is "About.." box of
      the program. However, if you do wish to include this info in the
      manual, this is the place to put it. Alternatively, you can put this information in the title page.-->
  <sect1 id="myapp-about"> 
    <title>À propos d'<application>Accerciser</application></title> 
    <para><application>Accerciser</application> a été écrit par Eitan Isaacson (<email>eitan@ascender.com</email>). Pour plus d'informations concernant <application>Accerciser</application>, référez-vous à la <ulink url="http://live.gnome.org/Accerciser" type="http">page GNOME Live d'<application>Accerciser</application></ulink>.</para>

    <para>Pour rapporter une anomalie ou émettre une suggestion concernant cette application ou ce manuel, procédez comme indiqué sur la <ulink url="ghelp:gnome-feedback" type="help">page de réactions sur GNOME</ulink>.</para>

    <para>La redistribution et l'utilisation sous forme de sources et binaires, avec ou sans modifications, sont permises selon les conditions de la licence BSD.</para>
  </sect1> 
</article>
