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

    <copyright> 
      <year>2006</year> 
      <year>2007</year> 
      <year>2008</year> 
      <holder>IBM Corporation</holder> 
    </copyright><copyright><year>2008.</year><holder>Enrico Nicoletto (liverig@gmail.com)</holder></copyright><copyright><year>2008.</year><holder>Fabrício Godoy (skarllot@gmail.com)</holder></copyright><copyright><year>2008.</year><holder>Leonardo Ferreira Fontenelle (leonardof@gnome.org)</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>GNOME Documentation Project</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>Equipe do Accerciser</orgname> 
          <address> <email>eitan@ascender.com</email> </address> 
        </affiliation> 
      </author> 

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

    <releaseinfo>Este manual descreve a versão 0.1.5 do Accerciser.</releaseinfo> 
    <abstract role="description">
      <para>Este manual descreve o uso do <application>Accerciser</application>.</para>
    </abstract> 
    <legalnotice> 
      <title>Feedback</title> 
      <para>Para relatar algum erro ou fazer uma sugestão relacionada ao aplicativo <application>Accerciser</application> ou este manual, visite a <ulink url="ghelp:gnome-feedback" type="help">página de feedback do 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>Introdução</title> 

    <para>O <application>Accerciser</application> é um explorador interativo de acessibilidade para o ambiente GNOME. Escrito em Python, ele utiliza o <ulink url="http://directory.fsf.org/at-spi.html" type="http">AT-SPI</ulink> para inspecionar e controlar widgets, permitindo que você verifique se um aplicativo está fornecendo informações corretas para as tecnologias assistivas e frameworks para testes automatizados. O <application>Accerciser</application> possui um framework simples de plug-ins que você pode utilizar para criar visualizações personalizadas de informações de acessibilidade.</para>

    <para>Em essência, o <application>Accerciser</application> é uma nova geração 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>Iniciando o uso</title> 

    <sect2 id="myapp-start">
      <title>Para iniciar o <application>Accerciser</application></title>
      <para>Você pode iniciar o <application>Accerciser</application> das seguintes formas:</para> 
      <variablelist>
        <varlistentry>
          <term>Menu <guimenu>Aplicativos</guimenu></term>
          <listitem>
            <para>Vá até o item de menu <menuchoice><guisubmenu>Desenvolvimento</guisubmenu><guimenuitem>Accerciser</guimenuitem></menuchoice>.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Linha de comando</term>
          <listitem>
            <para>Digite o seguinte comando em uma janela de console e depois pressione <keycap>Enter</keycap>:</para>
            <para> 
              <command>accerciser</command> 
            </para> 
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>

    <sect2 id="accerciser-when-start">
      <title>Iniciando o <application>Accerciser</application></title>
      <para>Quando você iniciar o <application>Accerciser</application>, a seguinte janela será exibida.</para>

      <!-- ==== Figure ==== -->
      <figure id="mainwindow-fig"> 
        <title>Janela principal do <application>Accerciser</application></title> 
        <screenshot> 
          <mediaobject> 
            <imageobject><imagedata fileref="figures/accerciser.png" format="PNG"/> 
            </imageobject>
            <textobject> 
              <phrase>
				Shows <application>Accerciser</application> main window. Contains title bar, menu bar,
				accessible tree , right plugin display area, and bottom plugin
				display area. The menu bar contains File, Edit, Bookmarks, 
				View, and Help menus.
			  </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 janela principal do <application>Accerciser</application> contém os seguintes elementos:</para>
      <variablelist>
        <varlistentry>
          <term>Barra de menu</term>
          <listitem>
			<para>A barra de menu contém comandos para gerenciar plug-ins, gerenciar e usar marcadores, atualizar a visão em árvore de acessibilidade e acessar este sistema de ajuda.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Visão em árvore de acessíveis</term>
          <listitem>
			<para>A visão em árvore de acessíveis permite visualizar todos os objetos acessíveis iniciando no nível da área de trabalho. Selecionar um objeto acessível torna-o disponível para inspeção adicional com os plug-ins carregados.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Visão direita de plug-ins</term>
          <listitem>
            <para>Esta é uma das duas visões padrão de plug-in. Quando o <application>Accerciser</application> for executado pela primeira vez, a maioria dos plug-ins estarão localizados aqui. Você pode arrastar as abas de plug-ins para a visão inferior ou para a área de trabalho para mostrar dois ou mais plug-ins simultaneamente.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Visão inferior de plug-ins</term>
          <listitem>
            <para>Você pode arrastar plug-ins para esta área ou a partir dela da mesma forma que na visão direita de plug-ins.</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>
	<sect2>
	  <title>Gerenciando a visão de plug-ins</title>
	  <para>O <application>Accerciser</application> tem dois modos de visão de plug-ins. O modo de exibição atual poder ser alternado em <menuchoice><guimenu>Ver</guimenu><guimenuitem>Visão unificada de plug-ins</guimenuitem></menuchoice> ou pressionando <keycombo><keycap>Control</keycap><keycap>t</keycap></keycombo>. Quando o modo unificado é habilitado, todos os plug-ins serão postos na visão direita de plug-ins e ordenados alfabeticamente. Isso pode ser útil para usuários de leitor de tela, que não podem aproveitar o flexível esquema de disposição espacial de plug-ins do <application>Accerciser</application>. Quando o modo unificado está desabilitado, as abas de plug-ins podem ser arrastadas e soltadas em diferentes visões de plug-in, ou podem ser arrastadas para a área de trabalho para colocar aquele plug-in em uma nova visão. O arranjo de plug-ins também pode ser manipulado com o menu de contexto do plug-in, que pode ser obtido tanto da aba de plug-in quanto do diálogo de preferências de plug-in.</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>Você pode usar o <application>Accerciser</application> para inspecionar qualquer widget acessível mostrado na visão em árvore utilizando os plug-ins disponíveis. O primeiro passo é selecionar um objeto acessível para inspecionar, usando um 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>Selecione um objeto acessível através da visão em árvore.</title> 
      <para>Use a visão em árvore para navegar pela hierarquia de objetos acessíveis, oriundos da área de trabalho. Expandir um nó da árvore revela seus filhos imediatos, e recolher o nó os esconde. Cada nó mostra um ícone correspondente ao aplicativo associado ou a lista de widget e o seu nome acessível, se disponível. A segunda coluna lista quantos nós serão mostrados se o item for expandido.</para>
      
    </sect2> 
    <sect2 id="accerciser-bookmarks"> 
      <title>Usando marcadores</title> 
      <para>O Accerciser permite colocar marcadores selecionando os objetos acessíveis para uma futura verificação. Isto pode ser de grande ajuda se o aplicativo alvo precisar ser reiniciado, por exemplo depois de recompilá-lo. Para colocar um marcador no objeto acessível atual selecionado, vá até <menuchoice><guimenu>Marcadores</guimenu><guimenuitem>Adicionar marcador...</guimenuitem></menuchoice> ou pressione <keycombo><keycap>Control</keycap><keycap>d</keycap></keycombo>.</para>
      <para>Os marcadores para objetos acessíveis no Accerciser estão definidos pelo nome do aplicativo e um "caminho" na hierarquia interna de acessibilidade do aplicativo para o marcador acessível. Quando o aplicativo alvo está em um estado diferente (ex. muitos quadros de níveis superiores) o caminho pode não estar correto.</para>
      <para>Marcadores podem ser gerenciados acessando a janela dos editores de marcador em <menuchoice><guimenu>Marcadores</guimenu><guimenuitem>Editar marcadores...</guimenuitem></menuchoice>.</para>
    </sect2> 
  </sect1>

  <!-- ============= Plugins =================================== -->
  <sect1 id="accerciser-default-plugins"> 
    <title>Plug-ins predefinidos</title> <para>O <application>Accerciser</application> vem com diversos plug-ins predefinidos. Estes plug-ins permitem que você veja uma variedade de informações sobre o objeto acessível selecionado atualmente na visão em árvore e seus vizinhos. Os plug-ins predefinidos disponíveis na versão 0.1.5 são 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>Visão de interface</title>
      <para>Este plug-in exibe informações sobre as interfaces disponíveis para o objeto acessível selecionado na visão em árvore. Interfaces sem suporte estarão acinzentadas. Vários instrumentos para ver e controlar uma interface estão disponíveis abaixo de cada expansor.</para>

      <figure id="iface-viewer-fig"> 
        <title>Visão de interface</title> 
        <screenshot> 
          <mediaobject> 
            <imageobject>
              <imagedata fileref="figures/interface_viewer.png" format="PNG"/> 
            </imageobject>
            <textobject> 
              <phrase>As interfaces com suporte do objeto acessível selecionado são mostradas como sensíveis, não acinzentadas.</phrase>
            </textobject> 
          </mediaobject> 
        </screenshot> 
      </figure>
    </sect2> 
    <sect2 id="accerciser-event-monitor"> 
      <title>Monitor de eventos</title> 
      <para>Este plug-in monitora os tipos de eventos selecionados da visão em árvore de acessíveis, da visão em árvore do aplicativo selecionado, ou de toda a área de trabalho.</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 janela do monitor de eventos permite que você selecione o tipo e a fonte de eventos.</phrase> 
            </textobject> 
          </mediaobject> 
        </screenshot> 
      </figure>
      <tip>
        <para>Pressionando <keycombo><keycap>Control</keycap><keycap>Alt</keycap><keycap>l</keycap></keycombo> em qualquer parte da área de trabalho, o último evento registrado será destacado para futura referência. Veja <xref linkend="accerciser-hotkey-config"/> para alterar a combinação de teclas.</para>
      </tip>
    </sect2> 
    <sect2 id="accerciser-console"> 
      <title>Console IPython</title> 
      <para>Este plug-in é um console completo em <ulink url="http://ipython.scipy.org/moin/" type="http">IPython</ulink>. Pressione <keycap>Tab</keycap> para mostrar complementações para o comando atual. Pressione <keycap>Enter</keycap> para executar qualquer código Python válido. Os comandos no console possuem acesso ao objeto acessível atualmente selecionado na árvore de acessibilidade de acordo com a variável <varname>acc</varname>. Além disso, todas as funções e constantes do pacote pyatspi estão disponíveis como locais, no console. A mais importante delas são as funções para consultar outras interfaces de acessibilidade. Por exemplo, para consultar a interface de Texto: <command>t = acc.queryText() </command>. Também é permitido importar do diretório de trabalho atual ou do caminho Python.</para> 
    </sect2> 
    <sect2 id="accerciser-api-browser"> 
      <title>Navegador de APIs</title>
      <para>Este plug-in mostra as interfaces, métodos e atributos com suporte do objeto acessível selecionado na visão em árvore.</para>
      <figure id="api-browser-fig"> 
        <title>Navegador de APIs</title>
        <screenshot> 
          <mediaobject> 
            <imageobject><imagedata fileref="figures/api_browser.png" format="PNG"/> 
            </imageobject>
            <textobject> 
              <phrase>O navegador API.</phrase> 
            </textobject> 
          </mediaobject> 
        </screenshot> 
      </figure>
    </sect2> 
    <sect2 id="accerciser-script-recorder"> 
      <title>Gravador de script</title>
      <para>O gravador de script do <application>Accerciser</application> permite aos usuários gravar a interação do teclado com outras aplicações da área de trabalho com o propósito de criar teste UI. Atualmente o plug-in suporta a geração de scripts de três plataformas: Dogtail, LDTP, e a API integrada do Accerciser. Uma vez pressionado o botão "Gravar", cada interação do teclado será gravada em um script que poderá ser posteriormente executado como um script independente.</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>Seleção rápida</title>
      <para>Este plug-in fornece teclas de atalho globais para permitir a seleção rápida de objetos acessíveis através de aplicações-alvo UI. Pressionando <keycombo><keycap>Control</keycap><keycap>Alt</keycap><keycap>a</keycap></keycombo> selecionar-se-á o último widget focalizado acessível no <application>Accerciser</application>. Pressionando <keycombo><keycap>Control</keycap><keycap>Alt</keycap><keycap>t</keycap></keycombo> será selecionado o objeto acessível do widget que encontra-se abaixo do ponteiro.</para>
    </sect2> 

    <sect2 id="accerciser-validate"> 
      <title>Validador</title>
      <para>O plug-in verifica aplicativos quanto a problemas de acessibilidade, e gera um relatório incluindo a gravidade e a descrição dos mesmos. O relatório vincula erros para a documentação sobre como remediar problemas comuns. O plug-in é extensível com alguns esquemas de teste que definem regras para validação.</para>

      <para>Para rodar o validador, primeiramente selecione um item na árvore de acessibilidade. O plug-in testará o acessível selecionado e todos os seus descendentes. Depois selecione um esquema para usá-lo no teste. Em seguida clique no botão <guibutton>Validar</guibutton> para iniciar o teste. Enquanto o teste é executado, clique no novamente no botão para cancelá-lo.</para>

      <para>Quando o teste termina, a tabela de relatório exibe a severidade e descrição de todos os erros. Dê um clique duplo em uma linha na tabela para exibir os acessíveis associados na árvore. Com um item selecionado, clique em <guibutton>Ajuda</guibutton> para obter informações sobre como resolver o problema.</para>
    </sect2>

  </sect1>
  <!-- ============= Customization ============================= -->
  <!-- Use this section to describe how to customize the application. -->
  <sect1 id="accerciser-prefs"> 
    <title>Preferências</title>
    <para>Alguns elementos do <application>Accerciser</application> são configuráveis:</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>Layout de plug-ins</title> 
      <para>Há dois métodos para configurar o layout do plug-in no <application>Accerciser</application>. Primeiramente você deve escolher <menuchoice><guimenu>Editar</guimenu><guimenuitem>Preferências</guimenuitem></menuchoice> para ativar a janela de diálogo <guilabel>Preferências</guilabel>. Esta janela de diálogo contém abas para cada seção, selecione a aba <guilabel>Plug-ins</guilabel>. Abaixo desta seção você encontrará uma visualização em lista de todos os plug-ins disponíveis. Dê um clique direito em qualquer um dos plug-ins listados para configurar a sua respectiva visualização.</para>
        
      <para>Você pode ignorar a janela de diálogo <guilabel>Preferências</guilabel> utilizando-se de arrastar e soltar para mover abas de plug-in. Arrastar uma aba de plug-in, para o inferior ou para a área de plug-in direita na janela principal, moverá o plug-in. Arrastar uma aba para a área de trabalho será criado uma janela de plug-in novo e soltará o plug-in nela.</para>
    </sect2>
    <sect2 id="accerciser-hotkey-config">
      <title>Configuração globais das teclas de atalho</title>
      <para>Alguns elementos do <application>Accerciser</application> podem ativar certa funcionalidade através das teclas de atalho. A combinação das teclas de atalho pode ser alterada através da janela <guilabel>Preferências</guilabel>, para fazê-lo deve-se selecionar <menuchoice><guimenu>Editar</guimenu><guimenuitem>Preferências</guimenuitem></menuchoice> para ativar o menu <guilabel>Preferências</guilabel>. Esta janela contém abas para cada seção, selecione a aba <guilabel>Teclas de atalho globais</guilabel>. Embaixo dessa seção você encontrará uma lista de todas as teclas de atalho disponíveis. Mude as combinações das teclas ao seu gosto.</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 o <application>Accerciser</application></title> 
    <para>O <application>Accerciser</application> foi escrito por Eitan Isaacson (<email>eitan@ascender.com</email>). Para procurar mais informações sobre o <application>Accerciser</application>, por gentileza visite a <ulink url="http://live.gnome.org/Accerciser" type="http"><application>Accerciser</application>página do GNOME Live!</ulink>.</para>

    <para>Para relatar algum erro, ou fazer uma sugestão relacionada a este aplicativo ou este manual, siga as instruções deste <ulink url="ghelp:gnome-feedback" type="help">documento</ulink>.</para>

    <para>A redistribuição e o uso nas formas binárias e em código, com ou sem modificação, são permitidas sobre os termos da licença BSD.</para>
  </sect1> 
</article>
