# Manuale di Accerciser v0.2.0

2006
2007
2008
IBM Corporation
2007, 2008
Lorenzo Travaglio (ltrav02@yahoo.it)
GNOME Documentation Project
Eitan
Isaacson
Team Accerciser

     eitan@ascender.com

Peter
Parente
Team Accerciser

     pparent@us.ibm.com

Manuale di Accerciser v0.2.0
29/06/2007

Eitan Isaacson eitan@ascender.com

Team Accerciser

Questo manuale descrive la versione 0.1.5 di Accerciser.

Questo manuale descrive l'uso di Accerciser.

## Commenti

Per segnalare un problema o inviare suggerimenti riguardanti Accerciser o questo manuale, seguire le istruzioni presenti nella Pagina dei commenti di GNOME.

## Introduzione

Accerciser è un esploratore interattivo di accessibilità per l'ambiente grafico GNOME scritto in Python. Usa AT-SPI per ispezionare e controllare i widget, permettendo di controllare se un'applicazione fornisce le corrette informazioni di tecnologia assistiva e framework di test automatici. Accerciser dispone di un semplice framework di plugin con il quale è possibile creare viste personalizzate delle informazioni di accessibilità.

Essenzialmente, Accerciser è uno strumento at-poke di ultima generazione at-poke.

## Per iniziare

### Avviare Accerciser

È possibile avviare Accerciser in uno dei seguenti modi:

Menù Applicazioni

  Selezionare la voce di menù Programmazione Accerciser.

Riga di comando

  Digitare il seguente comando in una finestra terminale quindi premere Invio:

  `accerciser`

### Avvio di Accerciser

All'avvio di Accerciser apparirà la seguente finestra.

#### Finestra principale di Accerciser

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

La finestra principale di Accerciser contiene i seguenti elementi:

Barra dei menù

  La barra dei menù contiene i comandi per la gestione dei plugin, la gestione e l'uso dei segnalibri, l'aggiornamento della vista dell'albero degli elementi accessibili nonché l'accesso a questa finestra di aiuto.

Vista dell'albero degli elementi accessibili

  La vista dell'albero degli elementi accessibili consente la vista di tutti gli elementi accessibili partendo dal livello del desktop. La selezione di un elemento accessibile ne rende disponibile l'analisi successiva per mezzo dei plugin caricati.

Vista plugin destro

  Questa è una delle due viste predefinite dei plugin. Quando Accerciser viene avviato per la prima volta, molti plugin risiedono qui. È possibile trascinare le schede dei plugin sulla vista inferiore dei plugin o sulla scrivania per visualizzare due o più plugin contemporaneamente.

Pannello inferiore visualizzazione plugin

  È possibile trascinare plugin dalla vista destra verso quest'area o viceversa.

### Gestione vista plugin

Accerciser dispone di due modalità per la visualizzazione dei plugin. La modalità corrente può essere scambiata mediante il menù Vista Vista singolo plugin o premendo Ctrl t. In modalità singola, tutti i plugin saranno posti, ordinati alfabeticamente nella finestra di visualizzazione in alto a destra, ciò può risultare utile per gli utenti che non abbiano dimestichezza con la disposizione spaziale a livelli dei plugin di Accerciser. Quando la modalità singola è disabilitata le linguette dei plugin possono essere trascinate verso differenti visualizzazioni o sul desktop per spostare il plugin desiderato in una nuova visualizzazione. Il posizionamento dei plugin può anche essere manipolato mediante il menù contestuale dei plugin, che può essere attivato tanto dalle linguette dei plugin quanto dalla porzione «plugin» della finestra di dialogo delle Preferenze.

## Uso

È possibile usare Accerciser per analizzare ogni widget di accessibili contenuto nella vista ad albero usando i plugin disponibili. Per prima cosa occorre selezionare un elemento accessibile da ispezionare usando uno dei seguenti metodi:

### Selezionare un elemento accessibile mediante la vista ad albero.

Usare la visualizzazione ad albero per esplorare la gerarchia degli oggetti accessibili con radice sul desktop. Quando viene aperto, un nodo rivela i suoi figli, viceversa chiudendolo li nasconde. Ogni nodo mostra un'icona per ogni applicazione associata o ruoli widget ed ogni nome di accessibile, qualora disponibile. La seconda colonna mostra la quantità di nodi che verranno visualizzati all'apertura dell'elemento.

### Gestire i segnalibri.

Accerciser consente di allocare nei segnalibri gli elementi accessibili selezionati per un successivo esame. Ciò può essere utile qualora l'applicazione dovesse essere fatta ripartire, per esempio in seguito ad una nuova generazione. Per inserire l'elemento attualmente selezionato scegliere Segnalibri Aggiungi segnalibro... o premere Ctrl d.

I segnalibri agli elementi accessibili in Accerciser sono definiti mediante un nome di applicazione ed un «percorso» nella gerarchia interna dell'applicazione verso l'accessibile marcato. Quando l'applicazione è in uno stato differente (ad esempio frame multiple a livello alto) il percorso potrebbe risultare errato.

I segnalibri possono essere modificati tramite la finestra di gestione segnalibri, raggiungibile mediante Segnalibri Modifica segnalibri....

## Plugin predefiniti

Accerciser contiene diversi plugin predefiniti. Questi permettono di visualizzare molteplici informazioni sull'elemento accessibile correntemente selezionato nell'albero di visualizzazione, nonché sui suoi vicini. I plugin predefiniti disponibili nella versione 0.1.5 sono i seguenti:

### Visualizzatore interfaccia

Questo plugin visualizza informazioni sulle interfacce disponibili per l'accessibile selezionato nell'albero di visualizzazione. Le interfacce non supportate sono visualizzate in grigio. Gli strumenti per visualizzare e controllare le interfacce sono disponibili mediante gli espansori.

#### Visualizzatore interfaccia

Le interfacce supportate dell'accessibile selezionato sono visualizzate come sensibili.

### Monitor eventi

Questo plugin visualizza gli eventi selezionati dall'albero degli accessibili, dalla finestra ad albero delle applicazioni o dal desktop intero.

#### Monitor eventi

La parte inferiore della finestra di monitor degli eventi permette di prelevare il tipo e la sorgente degli eventi.

Mediante Ctrl Alt l in qualsiasi parte del desktop, verrà evidenziato l'ultimo evento registrato, per una successiva analisi. Per modificare questa combinazione di tasti, consultare .

### Console IPython

Questo plugin rappresenta una console IPython completa. Premere Tab per visualizzare i possibili completamenti per il comando attuale. Premendo Invio verrà eseguito ogni comando Python valido. I comandi alla console hanno accesso all'accessibile attualmente selezionato nell'albero degli accessibili mediante la variabile `acc`. In aggiunta, tutte le funzioni e le costanti dal pacchetto «pyatspi» sono disponibili come locali nella console. Le più importanti fra di esse sono le funzioni di interrogazione verso altre interfacce di accessibili; ad esempio per l'interrogazione di interfacce di testo: `t = acc.queryText()` . È anche possibile l'importazione dalla directory di lavoro o da un percorso Python.

### Esploratore API

Questo plugin visualizza le interfacce, i metodi e gli attributi supportati dall'accessibile selezionato nella visualizzazione ad albero.

#### Esploratore API

Esploratore API.

### Registratore di script

Il registratore di script di Accerciser permette la memorizzazione delle interazioni da tastiera con altre applicazioni desktop allo scopo di costruire gli script di test per l'interfaccia utente. Attualmente il plugin consente la generazione di script per tre piattaforme: Dogtail, LDTP ed una API interna di Accerciser. Una volta premuto il pulsante «Registra» ogni interazione da tastiera verrà registrata in uno script che potrà essere eseguito in seguito come uno script a sé stante.

#### Registratore di script

Il registratore di script

### Selezione veloce

Questo plugin fornisce le scorciatoie globali da tastiera per la selezione veloce degli accessibili tramite l'interfaccia utente dell'applicazione. Premendo Ctrl Alt a verrà selezionato l'ultimo widget dell'accessibile selezionato in Accerciser. Premendo Ctrl Alt t verrà selezionato l'accessibile del widget che si trova sotto al puntatore.

### Validazione

Questo plugin verifica le applicazioni in merito ai problemi di accessibilità e genera un report includendone la gravità e la descrizione dei problemi. Il report collega gli errori alla documentazione riguardante i rimedi ai problemi più comuni. Il plugin è estensibile con schemi di test che definiscano le regole di validazione.

Per lanciare il validatore occorre anzitutto selezionare un elemento nell'albero degli accessibili. Il plugin verificherà l'accessibile selezionato e tutti i suoi discendenti. Occorre quindi selezionare uno schema di test. Premere quindi il pulsante Validazione per avviare il test. Un'ulteriore pressione del pulsante arresterà l'esecuzione del test.

Al termine del test, la tabella dei risultati visualizzerà gravità e descrizione di tutti gli errori. Un doppio clic su una riga della tabella mostrerà il relativo accessibile nell'albero. Con l'elemento selezionato, fare clic su Aiuto per ottenere le informazioni sulla possibile soluzione del problema.

## Preferenze

Alcuni elementi di Accerciser sono configurabili:

### Disposizione dei plugin

Esistono due metodi per configurare la disposizione dei plugin di Accerciser. Anzitutto occorre selezionare Modifica Preferenze per attivare la finestra di dialogo delle Preferenze. Questa finestra contiene schede per ogni sezione, selezionare quindi la scheda Plugin. In questa sezione è contenuto un elenco di tutti i plugin disponibili. Fare clic con il tasto destro su qualsiasi plugin per configurarne la visualizzazione.

È possibile ignorare la finestra Preferenze usando il trascinamento per muovere le schede dei plugin. Trascinare una scheda di plugin dall'area dei plugin inferiore o superiore nella finestra principale per spostare il plugin. Trascinando una scheda sul desktop verrà creata una nuova finestra al cui interno verrà depositato il plugin.

### Configurazione generale delle scorciatoie

Alcuni elementi di Accerciser possono abilitare determinate funzionalità mediante scorciatoie. Le combinazioni dei tasti possono essere modificate mediante la finestra delle Preferenze, per farlo occorre selezionare Modifica Preferenze per attivare la finestra delle Preferenze. Selezionare quindi la scheda Scorciatoie generali. All'interno di questa scheda è contenuto un elenco di tutte le combinazioni di tasti disponibili. A questo punto è possibile modificare a piacimento le combinazioni di tasti.

## Informazioni su Accerciser

Accerciser è stato scritto da Eitan Isaacson (eitan@ascender.com). Per ulteriori informazioni su Accerciser occorre visitare la pagina Accerciser GNOME Live! page.

Per segnalare un problema o un suggerimento riguardante quest'applicazione, seguire le istruzioni contenute in questo documento.

La redistribuzione e l'uso di sorgenti ed eseguibili, con o senza modificazioni, sono permessi secondo i termini della licenza BSD.