# Manual de Accerciser v0.2.0

2006
2007
2008
Corporación IBM
2009
Francisco Diéguez (fran.dieguez@glug.es)
Proxecto de Documentación de GNOME
Eitan
Isaacson
Equipo de Accerciser

     eitan@ascender.com

Peter
Parente
Equipo de Accerciser

     pparent@us.ibm.com

Manual de Accerciser v0.2.0
29-06-2007

Eitan Isaacson eitan@ascender.com

Equipo de Accerciser

Este manual describe a versión 0.1.5 de Accerciser.

Este manual describe o uso de Accerciser.

## Retroacción

Para informar dunha falla ou facer unha suxestión sobre Accerciser ou este manual, siga os pasos na Páxina de Retroacción de GNOME.

## Introdución

Accerciser é un explorador de accesibilidade interactivo escrito en Python para o escritorio GNOME. Emprega AT-SPI 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 Accerciser conta con un framework sinxelo que pode empregar para crear vistas personalizadas de información de accesibilidade.

En esencia, Accerciser é a nova xeración da ferramenta at-poke.

## Comecemos

### Arrincar Accerciser

Pode executar Accerciser dos seguintes xeitos:

Menú de Aplicacións

  Elixa o elemento de menú Programación Accerciser

Liña de ordes

  Escriba os seguintes comandos na fiestra de terminal e logo pulse Enter:

  `accerciser`

### Cando arrinque Accerciser

Cando arrinque Accerciser, amosarase a seguinte fiestra.

#### Fiestra Principal de Accerciser

Amosa a fiestra principal Accerciser. 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.

A fiestra principal Accerciser contén os seguintes elementos:

Barra de menú

  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.

Vista de Árbore de Accesibilidade

  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.

Vista dereita de complementos

  Esta é unha das dúas vistas de complementos por defecto. Cando Accerciser 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.

Vista inferior de complementos

  Pode arrastrar complementos dende ou cara esta área como se fora a vista dereita de complementos.

### Xestión de Vistas de Complementos

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 Accerciser. 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.

## Uso

Pode empregar Accerciser 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:

### Seleccione un accesíbel a través da vista en árbore

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.

### Empregar marcadores

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 Marcadores Engadir marcador... ou pulse Controld.

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.

Os marcadores poden ser xestionados accedendo ao diálogo de edición de marcadores a traverso de Marcadores Editar marcador....

## Complementos por defecto

Accerciser 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:

### Visor de Interface

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.

#### Visor de Interface

As interfaces que están soportadas polo accesible seleccionado amosanse como sensíbel.

### Monitor de eventos

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.

#### Monitor de eventos

A parte inferior da fiestra de monitorización de eventos permítelle escoller o tipo e fonde dos eventos.

Presionando ControlAltl en calquera lugar do escritorio, a último evento recollido será resaltado para unha referencia posterior. Vexa para saber como cambiar esta combinación de tecras.

### Consola IPython

Este complemento é unha consola totalmente desenvolta con IPython. Presione Tab para amosar completados para o comando actual. Presione Enter 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 `acc`. 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: `t = acc.queryText()` . Aínda que tamén se permite importar dende cartafol de traballo actual ou da ruta de Python.

### Navegador de API

Este complemento amosa as interfaces, métodos, e atributos que soporta o accesíbel seleccionado na vista en árbore.

#### Navegador de API

O navegador de API.

### Gravador de Script

Os gravar guións de Accerciser 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.

#### Gravador de Script

O gravador de script.

### Selección rápida

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>ControlAlta

### Validación

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 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 Validar para comezar a comprobación. Mentres se está a executar a comprobación, pode facer clic no botón de novo para cancelala.

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 Axuda para obter máis información sobre como resolver o problema.

## Preferencias

Hai algúns elementos en Accerciser que son configurables:

### Disposicións

Hai dous xeitos de configurar a disposición de complementos en Accerciser. Primeiro podería escollerEditar Preferencias para activar o diálogo Preferencias. Este diálogo contén separadores para cada sección, seleccione o separador Complementos. 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.

Pode saltarse o diálogo de Preferencias 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.

### Configuración global de atallos de teclado

Algúns elementos de Accerciser poden activar algunha funcionalidade por medio de atallos de teclado. Os atallos de teclado poden cambiarse no diálogo de Preferencias, pode seleccionar Editar Preferencias para activar o diálogo de Preferencias. Este diálogo contén separadores para cada sección, seleccione o separador Atallos de teclado globais. Baixo esta sección pode atopar unha lista de tódolos atallos de teclado. Cambie os mesmos ao seu gusto.

## Sobre Accerciser

Accerciser foi escrito por Eitan Isaacson (eitan@ascender.com). Para obter máis información sobreAccerciser, visite a páxina en GNOME Live! de Accerciser.

Para informar dunha falla ou facer unha suxestión desta aplicación ou este manual, siga os pasos no documento.

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