<?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="gl">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <articleinfo> 
    <title>Manual de <application>Accerciser</application> v0.2.0</title>       

    <copyright> 
      <year>2006</year> 
      <year>2007</year> 
      <year>2008</year> 
      <holder>Corporación IBM</holder> 
    </copyright><copyright><year>2009</year><holder>Francisco Diéguez (fran.dieguez@glug.es)</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>Proxecto de Documentación de 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>Equipo de Accerciser</orgname> 
          <address> <email>eitan@ascender.com</email> </address> 
        </affiliation> 
      </author> 

      <author role="editor"> 
        <firstname>Peter</firstname> 
        <surname>Parente</surname> 
        <affiliation> 
          <orgname>Equipo de 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>Manual de 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">Equipo de Accerciser</para>
        </revdescription> 
      </revision> 
    </revhistory> 

    <releaseinfo>Este manual describe a versión 0.1.5 de Accerciser.</releaseinfo> 
    <abstract role="description">
      <para>Este manual describe o uso de <application>Accerciser</application>.</para>
    </abstract> 
    <legalnotice> 
      <title>Retroacción</title> 
      <para>Para informar dunha falla ou facer unha suxestión sobre <application>Accerciser</application> ou este manual, siga os pasos na <ulink url="ghelp:gnome-feedback" type="help">Páxina de Retroacción de 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>Introdución</title> 

    <para><application>Accerciser</application> é un explorador de accesibilidade interactivo escrito en Python para o escritorio GNOME. Emprega <ulink url="http://directory.fsf.org/at-spi.html" type="http">AT-SPI</ulink> para analizar e controlar os widgets, permitíndolle comprobar se unha aplicación está proporcionando a información correcta para as tecnoloxías de asistencia e frameworks de comprobación <application>Accerciser</application> conta con un framework sinxelo que pode empregar para crear vistas personalizadas de información de accesibilidade.</para>

    <para>En esencia, <application>Accerciser</application> é a nova xeración da ferramenta <ulink url="http://svn.gnome.org/viewcvs/at-poke" type="http">at-poke</ulink>. </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>Comecemos</title> 

    <sect2 id="myapp-start">
      <title>Arrincar <application>Accerciser</application></title>
      <para>Pode executar <application>Accerciser</application> dos seguintes xeitos:</para> 
      <variablelist>
        <varlistentry>
          <term>Menú de <guimenu>Aplicacións</guimenu></term>
          <listitem>
            <para>Elixa o elemento de menú <menuchoice><guisubmenu>Programación</guisubmenu><guimenuitem>Accerciser</guimenuitem></menuchoice></para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Liña de ordes</term>
          <listitem>
            <para>Escriba os seguintes comandos na fiestra de terminal e logo pulse <keycap>Enter</keycap>:</para>
            <para> 
              <command>accerciser</command> 
            </para> 
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>

    <sect2 id="accerciser-when-start">
      <title>Cando arrinque <application>Accerciser</application></title>
      <para>Cando arrinque <application>Accerciser</application>, amosarase a seguinte fiestra.</para>

      <!-- ==== Figure ==== -->
      <figure id="mainwindow-fig"> 
        <title>Fiestra Principal de <application>Accerciser</application></title> 
        <screenshot> 
          <mediaobject> 
            <imageobject><imagedata fileref="figures/accerciser.png" format="PNG"/> 
            </imageobject>
            <textobject> 
              <phrase>Amosa a fiestra principal <application>Accerciser</application>. Contén a barra de título, a barra de menú, árbore de accesibilidade, área dereita de complementos e área inferior de complementos. A barra de menú contén os menús Ficheiro, Editar, Marcadores, Ver e Axuda.</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>A fiestra principal <application>Accerciser</application> contén os seguintes elementos:</para>
      <variablelist>
        <varlistentry>
          <term>Barra de menú</term>
          <listitem>
			<para>A barra de menú contén ordes para xestionar os complementos, xestionar e empregar os marcadores, actualizar a vista en árbore de accesibilidade, e acceso a este sistema de axuda.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Vista de Árbore de Accesibilidade</term>
          <listitem>
			<para>A vista de área de accesibilidade permítelle ver todas as accesibles comezando dende o nivel do escritorio. Seleccionando un accesíbel faise dispoñíbel para unha inspección consecuente empregando os complementos cargados.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Vista dereita de complementos</term>
          <listitem>
            <para>Esta é unha das dúas vistas de complementos por defecto. Cando <application>Accerciser</application> se executa por primeira vez, a meirande parte dos complementos estarán ahí. Vostede pode arrastrar separadores de complementos á vista inferior de complementos ou ao escritorio para amosar dous ou máis complementos á vez.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Vista inferior de complementos</term>
          <listitem>
            <para>Pode arrastrar complementos dende ou cara esta área como se fora a vista dereita de complementos.</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>
	<sect2>
	  <title>Xestión de Vistas de Complementos</title>
	  <para>Isto pode ser útil para os usuarios de lectores de pantalla que non poidan usar o complemento de esquema de disposición espacial flexíbel do <application>Accerciser</application>. Cando o modo de visualización simple está desactivado os separadores de complementos pódense arrastrar e soltar en diferentes visualizacións de complemento, ou poderíanse arrastrar ao escritorio para pór un complemento determinado nunha visualización nova. A disposición dos complementos pode ser modificada co menú contextual do complemento que pode chamarse tanto dende o separador do complemento como dende o diálogo de preferencias do complemento.</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>Uso</title> 
    <para>Pode empregar <application>Accerciser</application> para analizar calquera widget accesíbel que se amosa na vista en árbore empregando os complementos dispoñibles. O primeiro paso é seleccionar un accesíbel para analizalo empregando un dos seguintes métodos: <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>Seleccione un accesíbel a través da vista en árbore</title> 
      <para>Empregue a vista en árbore para navegar a herdanza dos obxectos accesibles que descenden do escritorio. Se desprega os nodos da árbore amosaranse os fillos mentres que se os recolle se agochan. Cada nodo amosa unha icona das asociadas coa aplicación ou rol de widget e o seu nome de accesíbel,  se está dispoñíbel. A segunda columna amosa cantos nodos deberían amosarse o elemento está despregado.</para>
      
    </sect2> 
    <sect2 id="accerciser-bookmarks"> 
      <title>Empregar marcadores</title> 
      <para>Accerciser permite marcar os accesibles selecionados para examilalos máis tarde. Isto pode ser útil se a aplicación destino debe reiniciarse, por exemplo despois de reconstruíla. Para marcar o accesíbel marcado agora mesmo vaia a <menuchoice><guimenu>Marcadores</guimenu><guimenuitem>Engadir marcador...</guimenuitem></menuchoice> ou pulse <keycombo><keycap>Control</keycap><keycap>d</keycap></keycombo>.</para>
      <para>Os marcadores de accesibles en Accerciser definense polo nome dunha aplicación e a "ruta" na herdanza interna na aplicación do accesíbel marcado. Cando unha aplicación destino está nun estado diferente (p.ex. múltiples niveles de marcos principais) a ruta pode non ser a correcta.</para>
      <para>Os marcadores poden ser xestionados accedendo ao diálogo de edición de marcadores a traverso de <menuchoice><guimenu>Marcadores</guimenu><guimenuitem>Editar marcador...</guimenuitem></menuchoice>.</para>
    </sect2> 
  </sect1>

  <!-- ============= Plugins =================================== -->
  <sect1 id="accerciser-default-plugins"> 
    <title>Complementos por defecto</title> <para><application>Accerciser</application> inclúe algúns complementos por defecto. Estes complementos permiten ver distinta información sobre o accesible seleccionado na vista en árbore e os seus veciños. Os complementos dispoñibles por defecto na versión 0.1.5 son os seguintes:</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>Visor de Interface</title>
      <para>Este complemento amosa información sobre as interfaces dispoñíbles para o accesíbel seleccionado na vista en árbore. As interfaces non soportadas están escurecidas. Hai dispoñibles distintas ferramentas para ollar e controlar unha interface baixo cada espansor.</para>

      <figure id="iface-viewer-fig"> 
        <title>Visor de Interface</title> 
        <screenshot> 
          <mediaobject> 
            <imageobject>
              <imagedata fileref="figures/interface_viewer.png" format="PNG"/> 
            </imageobject>
            <textobject> 
              <phrase>As interfaces que están soportadas polo accesible seleccionado amosanse como sensíbel.</phrase>
            </textobject> 
          </mediaobject> 
        </screenshot> 
      </figure>
    </sect2> 
    <sect2 id="accerciser-event-monitor"> 
      <title>Monitor de eventos</title> 
      <para>Este complemento analiza os tipos de eventos seleccinoados dende a vista accesíbel de árbore seleccionada, dende a fista de aplicacións en árbore seleccionada ou do escritorio enteiro.</para>
      <figure id="event-monitor-fig"> 
        <title>Monitor de eventos</title> 
        <screenshot> 
          <mediaobject> 
            <imageobject><imagedata fileref="figures/event_monitor.png" format="PNG"/> 
            </imageobject>
            <textobject> 
              <phrase>A parte inferior da fiestra de monitorización de eventos permítelle escoller o tipo e fonde dos eventos.</phrase> 
            </textobject> 
          </mediaobject> 
        </screenshot> 
      </figure>
      <tip>
        <para>Presionando <keycombo><keycap>Control</keycap><keycap>Alt</keycap><keycap>l</keycap></keycombo> en calquera lugar do escritorio, a último evento recollido será resaltado para unha referencia posterior. Vexa <xref linkend="accerciser-hotkey-config"/> para saber como cambiar esta combinación de tecras.</para>
      </tip>
    </sect2> 
    <sect2 id="accerciser-console"> 
      <title>Consola IPython</title> 
      <para>Este complemento é unha consola totalmente desenvolta con <ulink url="http://ipython.scipy.org/moin/" type="http">IPython</ulink>. Presione <keycap>Tab</keycap> para amosar completados para o comando actual. Presione <keycap>Enter</keycap> para executar calquera código Python válido. As ordes na consola teñen acceso ao accesíbel seleccionado na árbore de accesibles do xeito da variable <varname>acc</varname>. Ademáis, todalas funcións e constantes do paquete pyatspi están dispoñibles en local na consola. As máis importantes son as funcións de consulta á interface Text: <command>t = acc.queryText() </command>. Aínda que tamén se permite importar dende cartafol de traballo actual ou da ruta de Python.</para> 
    </sect2> 
    <sect2 id="accerciser-api-browser"> 
      <title>Navegador de API</title>
      <para>Este complemento amosa as interfaces, métodos, e atributos que soporta o accesíbel seleccionado na vista en árbore.</para>
      <figure id="api-browser-fig"> 
        <title>Navegador de API</title>
        <screenshot> 
          <mediaobject> 
            <imageobject><imagedata fileref="figures/api_browser.png" format="PNG"/> 
            </imageobject>
            <textobject> 
              <phrase>O navegador de API.</phrase> 
            </textobject> 
          </mediaobject> 
        </screenshot> 
      </figure>
    </sect2> 
    <sect2 id="accerciser-script-recorder"> 
      <title>Gravador de Script</title>
      <para>Os gravar guións de <application>Accerciser</application> permite aos usuarios gravar as interacións co teclado coas aplicaións de escritorio para poder deste xeito crear guións de proba de Interface de Usuario. Actualmente o complemento soporta a xeración de guións para as tres plataformas: Dogtail, LDTP e a API interna de Accercise. Unha vez que presione o botón "Gravar" cada interación de teclado será gravada no guión e pode ser executada máis tarde como un script propio.</para>
      <figure id="script-recorder-fig"> 
        <title>Gravador de Script</title>
        <screenshot> 
          <mediaobject> 
            <imageobject><imagedata fileref="figures/script_recorder.png" format="PNG"/> 
            </imageobject>
            <textobject> 
              <phrase>O gravador de script.</phrase> 
            </textobject> 
          </mediaobject> 
        </screenshot> 
      </figure>
    </sect2> 
    <sect2 id="accerciser-quick-select"> 
      <title>Selección rápida</title>
      <para>Este complemento proporciona atallos de teclado gloabais que permiten a selección rápida dos accesibles a traverso da interface de usuario da aplicación. Presionando keycombo&gt;<keycap>Control</keycap><keycap>Alt</keycap><keycap>a</keycap></para>
    </sect2> 

    <sect2 id="accerciser-validate"> 
      <title>Validación</title>
      <para>Este complemento comproba os problemas de accesibilidade nas aplicacións e xenera un informe que inclúe a importancia e descrición dos problemas. O informe liga os erros á documentación que informa sobre como resolvelos problemas comúns. O complemento é extensíbel cos esquemas de comprobación que definen regras de validación.</para>

      <para>Para executar o validador, primeiro seleccione un elemento da árbore de accesibilidade. O complemento comprobará o accesíbel seleccionado e todolos seus descendentes. De seuido seleccione un esquema que se empregará para comprobar. Entón faga clic no botón <guibutton>Validar</guibutton> para comezar a comprobación. Mentres se está a executar a comprobación, pode facer clic no botón de novo para cancelala.</para>

      <para>Cando a comprobación remate, a tabo de informe amosa a importación e descrición dos erros. FAga dobre clic nunha fila da táboa para amosar o accesíbel asociado na árbore. Con un elemento seleccionado, faga clic en <guibutton>Axuda</guibutton> para obter máis información sobre como resolver o problema.</para>
    </sect2>

  </sect1>
  <!-- ============= Customization ============================= -->
  <!-- Use this section to describe how to customize the application. -->
  <sect1 id="accerciser-prefs"> 
    <title>Preferencias</title>
    <para>Hai algúns elementos en <application>Accerciser</application> que son configurables:</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>Disposicións</title> 
      <para>Hai dous xeitos de configurar a disposición de complementos en <application>Accerciser</application>. Primeiro podería escoller<menuchoice><guimenu>Editar</guimenu><guimenuitem>Preferencias</guimenuitem></menuchoice> para activar o diálogo <guilabel>Preferencias</guilabel>. Este diálogo contén separadores para cada sección, seleccione o separador <guilabel>Complementos</guilabel>. Baixo esta sección atopará un alista de tódolos complementos dispoñíbles. Se fai clic co botón dereito en calquera dos complementos listados pode configurar a súa vista.</para>
        
      <para>Pode saltarse o diálogo de <guilabel>Preferencias</guilabel> empregando arrastrar e soltar para mover o separador de complementos. Arrastrando o separador de complementos cara a área de complementos inferior ou dereita na fiestra principal movera os complementos. Arrastrando o separador ó escritorio creará unha nova fiestra de complementos e crearasse o complemento nela.</para>
    </sect2>
    <sect2 id="accerciser-hotkey-config">
      <title>Configuración global de atallos de teclado</title>
      <para>Algúns elementos de <application>Accerciser</application> poden activar algunha funcionalidade por medio de atallos de teclado. Os atallos de teclado poden cambiarse no diálogo de <guilabel>Preferencias</guilabel>, pode seleccionar <menuchoice><guimenu>Editar</guimenu> <guimenuitem>Preferencias</guimenuitem></menuchoice> para activar o diálogo de <guilabel>Preferencias</guilabel>. Este diálogo contén separadores para cada sección, seleccione o separador <guilabel>Atallos de teclado globais</guilabel>. Baixo esta sección pode atopar unha lista de tódolos atallos de teclado. Cambie os mesmos ao seu gusto.</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>Sobre <application>Accerciser</application></title> 
    <para><application>Accerciser</application> foi escrito por Eitan Isaacson (<email>eitan@ascender.com</email>). Para obter máis información sobre<application>Accerciser</application>, visite a <ulink url="http://live.gnome.org/Accerciser" type="http">páxina en GNOME Live! de <application>Accerciser</application></ulink>.</para>

    <para>Para informar dunha falla ou facer unha suxestión desta aplicación ou este manual, siga os pasos no <ulink url="ghelp:gnome-feedback" type="help">documento</ulink>.</para>

    <para>A redistribución e uso das fontes ou binarios, con ou sen modificación está permitida baixo os termos da Licenza BSD.</para>
  </sect1> 
</article>
