# Příručka k aplikaci Accerciser verze 0.2.0

2006
2007
2008
IBM Corporation
2008, 2010
Lucas Lommer (llommer@svn.gnome.org)
2009
Marek Černocký (marek@manet.cz)
Dokumentační projekt GNOME
Eitan
Isaacson
Tým projektu Accerciser

     eitan@ascender.com

Peter
Parente
Tým projektu Accerciser

     pparent@us.ibm.com

Příručka k nástroji Accerciser verze 0.2.0
29. 6. 2007

Eitan Isaacson eitan@ascender.com

Tým projektu Accerciser

Tato příručka popisuje aplikaci Accerciser ve verzi 0.1.5

Tato příručka popisuje používání aplikace Accerciser.

## Zpětná vazba

Pokud chcete oznámit chybu nebo navrhnout vylepšení vztahující se k aplikaci Accerciser nebo této příručce, postupujte dle instrukcí na stránce Stránka s ohlasy na GNOME.

## Úvod

Accerciser je interaktivní průzkumník přístupnosti, napsaný v jazyce Python, pro pracovní prostředí GNOME. Využívá AT-SPI ke kontrole a ovládání widgetů, což vám umožňuje kontrolovat, jestli aplikace předává správné informace nástrojům zpřístupnění a automatizovat testy frameworků. Accerciser obsahuje jednoduchý zásuvný modul pro frameworky, který vám umožňuje vytvořit vlastní zobrazení informací o přístupnosti.

Accerciser je ve své podstatě nástroj at-poke příští generace.

## Začínáme

### Spuštění aplikace Accerciser

Aplikaci Accerciser lze spustit následujícími způsoby:

Nabídka Aplikace

  Zvolte z nabídky položku Programování Accerciser

Příkazová řádka

  Do konzoly napište následující příkaz a stiskněte Enter:

  `accerciser`

### Po spuštění aplikace Accerciser

Po spuštění aplikace Accerciser se zobrazí následující okno.

#### Hlavní okno aplikace Accerciser

Zobrazuje Accerciser hlavní okno, které obsahuje záhlaví, lištu nabídek, strom objektů přístupnosti, spodní a pravý prostor pro zásuvné moduly. Lišta nabídek obsahuje položky Soubor, Upravit, Zobrazit, Záložky a Nápověda.

Hlavní okno aplikace Accerciser obsahuje následující části:

Lišta nabídek

  Lišta nabídek obsahuje příkazy pro správu zásuvných modulů, správu a používání záložek, aktualizaci stromu s objekty přístupnosti a přístup k nápovědě.

Strom objektů přístupnosti

  Strom objektů přístupnosti vám umožňuje zobrazit všechny objekty od úrovně pracovní plochy. Po zvolení objektu můžete provádět další kontrolu za pomoci nahraných zásuvných modulů.

Prostor pro zásuvné moduly vpravo

  Zásuvné moduly lze zobrazovat dvěma způsoby. Při prvním spuštění aplikace Accerciser je zde uložena většina zásuvných modulů. Pokud chcete zobrazit dva zásuvné moduly najednou, přetáhněte zvolené do spodního prostoru pro zásuvné moduly nebo na plochu.

Spodní prostor pro zásuvné moduly

  Z a do tohoto prostoru můžete zásuvné moduly přetahovat stejně jako v případě prostoru pro zásuvné moduly vpravo.

### Správa zobrazení zásuvných modulů

Accerciser má dva módy pro prohlížení zásuvných modulů. Aktuální mód lze přepnout zvolením Zobrazit Jednoduché zobrazení zásuvných modulů z nabídky nebo stiskem kombinace kláves Controlt. Pokud je mód jednoduchého zobrazení zapnutý, všechny zásuvné moduly jsou zobrazeny abecedně v pravém prostoru pro zásuvné moduly, což je užitečné například pro uživatele se čtečkou obrazovky, kteří nevyužijí flexibilní rozložení zásuvných modulů aplikace Accerciser. Pokud je mód jednoduchého zobrazení vypnutý, lze karty zásuvných modulů přetahovat mezi umístěními nebo na plochu za účelem otevření nového pohledu. Umístění zásuvných modulů lze také ovlivnit z kontextové nabídky dostupné u karty modulu nebo v okně nastavení.

## Použití

Aplikaci Accerciser můžete použít ke kontrole přístupnosti widgetů zobrazených ve Stromu objektů přístupnosti za pomoci dostupných zásuvných modulů. Prvním krokem je výběr objektu, který lze provádět těmito způsoby:

### Ze Stromu objektů přístupnosti vyberte objekt.

Použijte strom objektů přístupnosti pro navigaci v hierarchii objektů s nejvyšší úrovní na pracovní ploše. Rozvinutím položky stromu zobrazíte všechny podřízené položky, kdežto zavinutí je skryje. Každá položka zobrazuje ikonu aplikace nebo widgetu dle příslušnosti a název. Druhý sloupec pak udává, kolik bude zobrazeno položek, pokud bude daná rozvinuta.

### Používání záložek

Accerciser umožňuje ukládat objekty přístupnosti, které chcete zkoumat později. Toto je užitečné například, pokud je nutné zkoumanou aplikaci restartovat. Aktuálně vybraný objekt přidáte do záložek zvolením Záložky Přidat záložku... z nabídky nebo stisknutím kombinace kláves Controld.

Záložky objektů přístupnosti jsou v aplikaci Accerciser definovány názvem aplikace a "cestou" k umístění objektu v interní hierarchii přístupnosti aplikace. Pokud je cílová aplikace v jiném stavu než při uložení (například vícenásobné rámce nejvyšší úrovně), mohou být cesty neplatné.

Záložky můžete spravovat z okna správy záložek, které je dostupné vybráním položky Záložky Upravit záložky... z nabídky.

## Výchozí zásuvné moduly

Accerciser obsahuje několik výchozích zásuvných modulů. Ty vám umožňují prohlížet různorodé informace o aktuálně vybraném objektu přístupnosti ve stromu a jeho sousedů. Výchozí zásuvné moduly dostupné pro verzi 0.1.5 jsou:

### Prohlížeč rozhraní

Tento zásuvný modul zobrazuje informace o tom, jaká rozhraní jsou pro zvolený objekt přístupnosti ve stromu dostupná. Nedostupná rozhraní jsou zašedlá. Pod každým rozpínačem jsou zobrazeny různé nástroje pro prohlížení a kontrolu.

#### Prohlížeč rozhraní

Rozhraní, která zvolený objekt přístupnosti podporuje, jsou rozlišena.

### Monitor událostí

Tento zásuvný modul sleduje zvolené typy událostí pro vybraný objekt přístupnosti ve stromu. pro zvolenou aplikaci ve stromu nebo celou pracovní plochu.

#### Monitor událostí

Spodní část okna Monitor událostí umožňuje výběr typu a zdroje událostí.

Stiskem kombinace kláves ControlAltl kdekoliv na ploše způsobíte zvýraznění poslední zaznamenané události, aby bylo možno ji později dohledat. popisuje způsob, jak tuto kombinaci kláves změnit.

### Konzola IPythonu

Tento zásuvný modul je plnohodnotnou konzolou IPythonu. Stisknutím klávesy Tab zobrazíte nabídku dokončení příkazu. Stisknutím klávesy Enter spustíte jakýkoliv funkční kód v jazyce Python. Příkazy mají přístup k aktuálně vybranému objektu přístupnosti ve stromu podle cesty proměnné `acc`. Dále jsou také do konzoly zahrnuty jako místní všechny dostupné funkce a konstanty balíčku pyatspi. Nejdůležitější jsou funkce pro dotazy na rozhraní přístupnosti, například dotaz na rozhraní Text: `t = acc.queryText()` . Také jsou dovoleny importy z aktuálního pracovního adresáře a cesty Pythonu.

### Prohlížeč API

Tento zásuvný modul zobrazuje rozhraní, metody a atributy, které podporuje ve stromu zvolený objekt přístupnosti.

#### Prohlížeč API

Prohlížeč API

### Záznamník skriptů

Záznamník skriptů aplikace Accerciser umožňuje zaznamenávat interakci pomocí klávesnice s ostatními aplikacemi na ploše za účelem vytvoření skriptu na testování uživatelského rozhraní. V současné době podporuje zásuvný modul generování skriptů pro tři platformy: Dogtail, LDTP a vestavěné API aplikace Accerciser. Od stisknutí tlačítka "Record" bude každá akce provedená pomocí klávesnice zaznamenána do skriptu, který může být později samostatně spuštěn.

#### Záznamník skriptů

Záznamník skriptů

### Rychlý výběr

Tento zásuvný modul poskytuje globální klávesové zkratky umožňující rychlý výběr objektů přístupnosti napříč uživatelským rozhraním aplikace. Stiskem kombinace kláves ControlAlta zaměříte v aplikaci Accerciser poslední objekt přístupnosti widgetu. Stiskem kombinace ControlAltt vyberete objekt přístupnosti widgetu, který je pod ukazatelem.

### Validace

Tento zásuvný modul kontroluje aplikace z hlediska přístupnosti a sestavuje zprávu obsahující závažnost a popis problémů. Ve zprávě jsou odkazy na návod v dokumentaci, jak odstranit nejběžnější problémy.

Pokud chcete Validaci použít, nejprve vyberte ze Stromu objektů přístupnosti cíl. Zásuvný modul objekt prozkoumá, včetně všech jeho potomků. Následně vyberte schéma, které chcete pro test použít a po klepnutí na tlačítko Validovat se test spustí. Pokud test běží, opětovným klepnutím na tlačítko jej zrušíte.

Po dokončení testu vám tabulka zprávy ukáže u každé chyby závažnost a popis. Poklepáním na řádek tabulky zobrazíte odpovídající objekt přístupnosti ve stromu. Když máte objekt vybrán, klepněte na tlačítko Nápověda a zobrazí se informace o možnostech odstranění problému.

## Nastavení

Některé elementy aplikace Accerciser lze konfigurovat:

### Rozložení zásuvných modulů

V aplikaci Accerciser existují dva způsoby nastavení rozložení zásuvných modulů. Nejdříve zvolením Upravit Nastavení z nabídky otevřete okno Nastavení, které obsahuje kartu pro každou oblast. Zvolte kartu Zásuvné moduly a na ní naleznete seznam dostupných zásuvných modulů. Klepnutím pravým tlačítkem na libovolný modul v seznamu umožní změnit jeho zobrazení.

Bez použití okna Nastavení můžete přetahovat karty zásuvných modulů. S moduly lze hýbat přetažením do spodního nebo pravého prostoru pro zásuvné moduly. Přetažení karty na plochu otevře nové okno a zásuvný modul do něj umístí.

### Nastavení globálních klávesových zkratek

Některé elementy aplikace Accerciser mohou nabízet část funkcí prostřednictvím klávesových zkratek. V okně Nastavení je lze změnit. Pokud tak chcete učinit, zvolte z nabídky položku Upravit Nastavení a objeví se okno Nastavení. Z karet v tomto okně, které jsou pro každou oblast, vyberte kartu Globální klávesové zkratky. Dole naleznete seznam všech funkcí, ke kterým lze zkratku nastavit. Kombinace kláves závisí jen na vás.

## O aplikaci Accerciser

Accerciser napsal Eitan Isaacson (eitan@ascender.com). Více informací popisuje stránka projektu Accerciser na GNOME Live!.

Pokud chcete oznámit chybu nebo navrhnout vylepšení vztahující se k aplikaci nebo této příručce, postupujte podle instrukcí v tomto dokumentu.

Re-distribuce a použití ve zdrojové nebo binární podobě, s nebo bez úprav, je povoleno v souladu se zněním licence BSD.