# Підручник Accerciser версія 0.2.0

2006
2007
2008
Корпорація IBM
Проект документації GNOME
Eitan
Isaacson
Команда розробників Accerciser

     eitan@ascender.com

Peter
Parente
Команда розробників Accerciser

     pparent@us.ibm.com

Підручник Accerciser версія 0.2.0
2007-06-29

Eitan Isaacson eitan@ascender.com

Команда розробників Accerciser

Цей підручник описує Accerciser версії 0.1.5.

Цей підручник дає розкриває основи роботи з Accerciser.

## Відгук

Якщо Ви бажаєте повідомити про помилку або дати пораду щодо пакунку Accerciser чи його документації, скористайтеся правилами Сторінки відгуків GNOME.

## Вступ

Accerciser є інтерактивним провідником по елементах доступності для GNOME, який створено за допомогою Python. Він використовує Постачальника послуг інтерфейсу зручних технологій (AT-SPI) для спостереження та контролю графічних елементів, дозволяючи перевірити, чи програма дає вірну інформацію для технологій зручності та каркасів автоматизованої перевірки. Accerciser має простий каркас додатків, який можна використовувати для створення спеціалізованих представлень інформації про доступність.

По суті, Accerciser є наступним поколінням засобів записування.

## Основи роботи

### Запуск Accerciser

Ви можете запустити Accerciser одним з наступних методів:

Через меню Програми

  Клацнувши на елементі меню Програмування Дослідження доступності програм Accerciser.

Через командний рядок

  Наберіть наступну команду у терміналі та натисніть Enter:

  `accerciser`

### Коли Ви запускаєте Accerciser

При запуску Accerciser, з'являється наступне вікно.

#### Accerciser Головне вікно

Показує Accerciser головне вікно. Містить заголовок, панель меню, дерево доступних елементів, правосторонню область відображення додатків та нижню область відображення додатків. Панель меню містить такі елементи як Файл, Правка, Закладки, Вигляд та Довідка.

Головне вікно Accerciser має наступні елементи:

Панель меню

  Панель меню містить команди керування додатками, керування та використання закладок, поновлення вигляду дерева доступних елементів та доступ до цієї довідки.

Вигляд дерева доступних елементів

  Вигляд дерева доступних елементів дозволяє переглядати всі доступні елементи, які працюють на рівні стільниці. Вибір доступних елементів дозволяє проводити подальший аналіз завантажених додатків.

Правостороння область перегляду додатків

  Існує дві первинних області перегляду додатків. Коли Accerciser запускається вперше, більшість додатків знаходяться тут. Ви можете перетягнути вкладки з додатками до нижньої області перегляду або на стільницю, щоб переглядати два додатки одночасно.

Нижня область перегляду додатків

  Ви можете перетягнути додатки на цю область або з неї так само як і з правосторонньою областю перегляду додатків.

### Керування переглядом додатків

Accerciser має два режими перегляду додатків. Поточну область модулів можна увімкнути за допомогою Вигляд Поточна область модулів або натиснувши комбінацію Controlt. Коли увімкнено поточну область модулів, всі модулі будуть знаходитися у верхньому правому вікні перегляду модулів, відсортовані у алфавітному порядку. Такий режим можна використовувати для користувачів, які користуються лише екраном і не використовують зручний модуль Accerciser для схеми розміщення у просторі. Коли режим поточної області модулів вимкнено, модуль вкладок можна перенести до інших модулів перегляду або ж на стільницю, щоб встановити для заданого модуля новий режим перегляду. Також, розміщенням модлуів можна керувати з контекстного меню модулів, яке можна запустити або з вкладки модулів або ж з діалогового вікна налаштування модулів.

## Використання

Ви можете використовувати Accerciser для перегляду доступних графічних елементів, які відображаються у вигляді дерева, використовуючи доступні модулі. Першим кроком є вибір об'єкту, за яким буде проводитися спостереження, використовуючи один з наступних методів:

### Вибір об'єкту з деревоподібного списку

Використовуйте деревоподібний список для переміщення по ієрархії об'єктів, прив'язаних до стільниці. Розгортання елемента дерева показує його безпосередніх нащадків, в той час я згортання - приховує їх. Кожен вузол має значок, який пов'язується з програмою або графічним елементом та його іменем, якщо таке існує. Список у другому стовпці показує скільки вузлів буде показано, якщо розгорнути об'єкт.

### Використання закладок

Accerciser дозволяє створювати закладки з обраних об'єктів для подальшого аналізу. Така функція може бути корисною, якщо кінцева програма повинна перезапуститися, наприклад після повторної компіляції. Для створення закладки поточного об'єкту виконайте Закладки Додати закладку... або натисніть Controld.

Закладки на об'єкти у Accerciser визначаються іменем програми та "шляхом" у внутрішній ієрархії об'єктів програми до закладеного об'єкту. Коли кінцева програма перебуває у іншому стані (напр. декілька рамок верхнього рівня) шлях може бути невірним.

Керування закладками здійснюється через діалогове меню Закладки Правка закладок....

## Первинні модулі

Accerciser постачається з кількома первинними модулями. Ці модулі дозволяють переглядати різну інформацію про поточний вибраний об'єкт у деревоподібному списку та його сусідів. Первинні модулі, які доступні для версії 0.1.5:

### Перегляд інтерфейсу

Цей модуль показує інформацію про доступні інтерфейси для вибраного об'єкту деревоподібного списку. Інтерфейси, які не підтримуються показуються сірим кольором. Пізні інструменти, які використовуються для перегляду та керування інтерфейсом доступні під кожним розширювачем.

#### Перегляд інтерфейсу

Інтерфейси, які підтримуються вибраними об'єктами, показуються як такі, що можна змінювати.

### Монітор подій

Цей модуль переглядає обрані типи подій для об'єкта чи програми, які вибираються з з деревоподібного списку або ж стільниці загалом.

#### Монітор подій

Нижня частина вікна монітора подій дозволяє вибрати тип та джерело подій.

Натиснувши ControlAltl будь-де в межах стільниці, буде підсвічено останню записану подію, яка буде використовуватися для подальших посилань. Детальніша інформація про зміну комбінації клавіш для цієї події.

### Консоль IPython

Цей модуль є повністю самостійною консоллю IPython. Натисніть Tab щоб побачити можливі завершення для поточної команди. Натисніть Enter для виконання коду Python. Команди, введені з консолі, мають доступ до вибраного об'єкту з дерева об'єктів через змінну `acc`. Окрім цього, всі функції та константи пакунку pyatspi доступні з консолі як локальні. Найбільш важливими з них є функції звертання до інших інтерфейсів об'єкту. Наприклад, запит до інтерфейсу Текст (Text): `t = acc.queryText()` . Також дозволено операцію імпорту з поточної робочої теки та шляху Python.

### Навігатор програмного інтерфейсу (API)

Цей модуль показує інтерфейси, методи та ознаки, які підтримуються об'єктом, який обрано з деревоподібного списку.

#### Навігатор програмного інтерфейсу (API)

Навігатор програмного інтерфейсу (API).

### Запис сценарію

Запис сценарію Accerciser дозволяє користувачам записувати взаємодію клавіатури з іншими програмами стільниці з метою створення сценаріїв перевірки користувацького інтерфейсу. Наразі модуль підтримує генерацію сценаріїв для трьох платформ: Dogtail, LDTP та вбудованого програмного інтерфейсу Accerciser. Як тільки Ви натиснете кнопку "Запис", вся робота клавіатури буде записуватися до сценарію, який можна буде виконати потім, як окремий сценарій.

#### Запис сценарію

Запис сценарію.

### Швидкий вибір

This plugin provides global hotkeys for allowing quick selection of accessibles through the target application's UI. Pressing ControlAlta will select the last focused widget's accessible in Accerciser. Натискання ControlAltt дозволить вибрати той об'єкт графічного елементу, який знаходиться під курсором.

### Перевірка

Цей модуль перевіряє, чи має програма проблеми з об'єктами та генерує звіт включаючи рівень критичності та опис проблеми. Звіт з'єднує помилки з відповідною документацією про виправлення типових помилок. Модуль можна розширювати відповідними схемами, які визначають правила перевірки.

Для запуску перевірки, спершу виберіть елемент з дерева об'єктів. Модуль перевірить вказаний об'єкт та його нащадків. Далі виберіть схему, яка буде використовуватися для перевірки. Потім, для початку перевірки, клацніть на кнопці Перевірити. Для скасування процесу перевірки, клацніть на цю ж кнопку ще раз.

Коли перевірка завершується, генерується звітна таблиця, яка показує рівень критичності та опис всіх помилок. Подвійне клацання на рядку таблиці показує об'єкти дерева, які пов'язані з проблемою. Коли обрано елемент, клацніть на кнопці Довідка, щоб отримати інформацію про вирішення проблеми.

## Налаштування

У Accerciser існують деякі елементи, які можна налаштувати:

### Макет модулів

У Accerciser існує два методи налаштування макету модулів. Перший полягає у виборі елементу меню Правка Параметри для активації діалогового вікна Параметри. Це діалогове вікно містить вкладки для кожного розділу, нас цікавить вкладка Модулі. У цьому розділі ви знайдете перелік виглядів для доступних модулів. Праве клацання мишкою дозволить налаштувати вигляд для будь-якого модуля.

Ви можете оминути діалогове вікно Параметри, використовуючи операцію переносу для руху закладок модулів. Перенесення закладки модуля з нижньої або правої області модуля до головного вікна перенесе сам модуль. Перенесення вкладки на стільницю створить вікно нового модуля та перенесе туди сам модуль.

### Налаштування глобальних гарячих клавіш

Окремі елементи Accerciser можуть бути доступними через глобальні клавіші. Комбінацію гарячих клавіш можна змінити у діалоговому вікні Параметри. Для його активації необхідно скористатися пунктом меню Правка Параметри. Це діалогове вікно містить вкладки для кожного розділу, виберіть вкладку Глобальні гарячі клавіші. У цьому розділі Ви знайдете список переглядів для всіх доступних властивостей гарячих клавіш. Змініть комбінації гарячих клавіш на Ваш розсуд.

## Про Accerciser

Accerciser написав Eitan Isaacson (eitan@ascender.com). Щоб отримати більше інформаціх про Accerciser, відвідайте сторінкуAccerciser в рамках проекту GNOME Live!.

Якщо ж Ви знайшли помилку, або знаєте як покращити цю програму чи документацію, скористайтеся цими вказівками.

Поширення та використання двійкового та джерельного кодів з внесенням до нього змін або ж без них дозволено згідно вимог ліцензії BSD.