<?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="uk">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <articleinfo> 
    <title>Підручник <application>Accerciser</application> версія 0.2.0</title>       

    <copyright> 
      <year>2006</year> 
      <year>2007</year> 
      <year>2008</year> 
      <holder>Корпорація IBM</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</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>Команда розробників Accerciser</orgname> 
          <address> <email>eitan@ascender.com</email> </address> 
        </affiliation> 
      </author> 

      <author role="editor"> 
        <firstname>Peter</firstname> 
        <surname>Parente</surname> 
        <affiliation> 
          <orgname>Команда розробників 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>Підручник Accerciser версія 0.2.0</revnumber> 
        <date>2007-06-29</date> 
        <revdescription> 
          <para role="author">Eitan Isaacson <email>eitan@ascender.com</email></para>
          <para role="publisher">Команда розробників Accerciser</para>
        </revdescription> 
      </revision> 
    </revhistory> 

    <releaseinfo>Цей підручник описує Accerciser версії 0.1.5.</releaseinfo> 
    <abstract role="description">
      <para>Цей підручник дає розкриває основи роботи з <application>Accerciser</application>.</para>
    </abstract> 
    <legalnotice> 
      <title>Відгук</title> 
      <para>Якщо Ви бажаєте повідомити про помилку або дати пораду щодо пакунку <application>Accerciser</application> чи його документації, скористайтеся правилами <ulink url="ghelp:gnome-feedback" type="help">Сторінки відгуків 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>Вступ</title> 

    <para><application>Accerciser</application> є інтерактивним провідником по елементах доступності для GNOME, який створено за допомогою Python. Він використовує <ulink url="http://directory.fsf.org/at-spi.html" type="http">Постачальника послуг інтерфейсу зручних технологій (AT-SPI)</ulink> для спостереження та контролю графічних елементів, дозволяючи перевірити, чи програма дає вірну інформацію для технологій зручності та каркасів автоматизованої перевірки. <application>Accerciser</application> має простий каркас додатків, який можна використовувати для створення спеціалізованих представлень інформації про доступність.</para>

    <para>По суті, <application>Accerciser</application> є наступним поколінням засобів <ulink url="http://svn.gnome.org/viewcvs/at-poke" type="http">записування</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>Основи роботи</title> 

    <sect2 id="myapp-start">
      <title>Запуск <application>Accerciser</application></title>
      <para>Ви можете запустити <application>Accerciser</application> одним з наступних методів:</para> 
      <variablelist>
        <varlistentry>
          <term>Через меню <guimenu>Програми</guimenu></term>
          <listitem>
            <para>Клацнувши на елементі меню <menuchoice><guisubmenu>Програмування</guisubmenu><guimenuitem>Дослідження доступності програм Accerciser</guimenuitem></menuchoice>.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Через командний рядок</term>
          <listitem>
            <para>Наберіть наступну команду у терміналі та натисніть <keycap>Enter</keycap>:</para>
            <para> 
              <command>accerciser</command> 
            </para> 
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>

    <sect2 id="accerciser-when-start">
      <title>Коли Ви запускаєте <application>Accerciser</application></title>
      <para>При запуску <application>Accerciser</application>, з'являється наступне вікно.</para>

      <!-- ==== Figure ==== -->
      <figure id="mainwindow-fig"> 
        <title><application>Accerciser</application> Головне вікно</title> 
        <screenshot> 
          <mediaobject> 
            <imageobject><imagedata fileref="figures/accerciser.png" format="PNG"/> 
            </imageobject>
            <textobject> 
              <phrase>Показує <application>Accerciser</application> головне вікно. Містить заголовок, панель меню, дерево доступних елементів, правосторонню область відображення додатків та нижню область відображення додатків. Панель меню містить такі елементи як Файл, Правка, Закладки, Вигляд та Довідка.</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>Головне вікно <application>Accerciser</application> має наступні елементи:</para>
      <variablelist>
        <varlistentry>
          <term>Панель меню</term>
          <listitem>
			<para>Панель меню містить команди керування додатками, керування та використання закладок, поновлення вигляду дерева доступних елементів та доступ до цієї довідки.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Вигляд дерева доступних елементів</term>
          <listitem>
			<para>Вигляд дерева доступних елементів дозволяє переглядати всі доступні елементи, які працюють на рівні стільниці. Вибір доступних елементів дозволяє проводити подальший аналіз завантажених додатків.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Правостороння область перегляду додатків</term>
          <listitem>
            <para>Існує дві первинних області перегляду додатків. Коли <application>Accerciser</application> запускається вперше, більшість додатків знаходяться тут. Ви можете перетягнути вкладки з додатками до нижньої області перегляду або на стільницю, щоб переглядати два додатки одночасно.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Нижня область перегляду додатків</term>
          <listitem>
            <para>Ви можете перетягнути додатки на цю область або з неї так само як і з правосторонньою областю перегляду додатків.</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>
	<sect2>
	  <title>Керування переглядом додатків</title>
	  <para><application>Accerciser</application> має два режими перегляду додатків. Поточну область модулів можна увімкнути за допомогою <menuchoice><guimenu>Вигляд</guimenu><guimenuitem>Поточна область модулів</guimenuitem></menuchoice> або натиснувши комбінацію <keycombo><keycap>Control</keycap><keycap>t</keycap></keycombo>. Коли увімкнено поточну область модулів, всі модулі будуть знаходитися у верхньому правому вікні перегляду модулів, відсортовані у алфавітному порядку. Такий режим можна використовувати для користувачів, які користуються лише екраном і не використовують зручний модуль <application>Accerciser</application> для схеми розміщення у просторі. Коли режим поточної області модулів вимкнено, модуль вкладок можна перенести до інших модулів перегляду або ж на стільницю, щоб встановити для заданого модуля новий режим перегляду. Також, розміщенням модлуів можна керувати з контекстного меню модулів, яке можна запустити або з вкладки модулів або ж з діалогового вікна налаштування модулів.</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>Використання</title> 
    <para>Ви можете використовувати <application>Accerciser</application> для перегляду доступних графічних елементів, які відображаються у вигляді дерева, використовуючи доступні модулі. Першим кроком є вибір об'єкту, за яким буде проводитися спостереження, використовуючи один з наступних методів: <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>Вибір об'єкту з деревоподібного списку</title> 
      <para>Використовуйте деревоподібний список для переміщення по ієрархії об'єктів, прив'язаних до стільниці. Розгортання елемента дерева показує його безпосередніх нащадків, в той час я згортання - приховує їх. Кожен вузол має значок, який пов'язується з програмою або графічним елементом та його іменем, якщо таке існує. Список у другому стовпці показує скільки вузлів буде показано, якщо розгорнути об'єкт.</para>
      
    </sect2> 
    <sect2 id="accerciser-bookmarks"> 
      <title>Використання закладок</title> 
      <para>Accerciser дозволяє створювати закладки з обраних об'єктів для подальшого аналізу. Така функція може бути корисною, якщо кінцева програма повинна перезапуститися, наприклад після повторної компіляції. Для створення закладки поточного об'єкту виконайте <menuchoice><guimenu>Закладки</guimenu><guimenuitem>Додати закладку...</guimenuitem></menuchoice> або натисніть <keycombo><keycap>Control</keycap><keycap>d</keycap></keycombo>.</para>
      <para>Закладки на об'єкти у Accerciser визначаються іменем програми та "шляхом" у внутрішній ієрархії об'єктів програми до закладеного об'єкту. Коли кінцева програма перебуває у іншому стані (напр. декілька рамок верхнього рівня) шлях може бути невірним.</para>
      <para>Керування закладками здійснюється через діалогове меню <menuchoice><guimenu>Закладки</guimenu><guimenuitem>Правка закладок...</guimenuitem></menuchoice>.</para>
    </sect2> 
  </sect1>

  <!-- ============= Plugins =================================== -->
  <sect1 id="accerciser-default-plugins"> 
    <title>Первинні модулі</title> <para><application>Accerciser</application> постачається з кількома первинними модулями. Ці модулі дозволяють переглядати різну інформацію про поточний вибраний об'єкт у деревоподібному списку та його сусідів. Первинні модулі, які доступні для версії 0.1.5:</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>Перегляд інтерфейсу</title>
      <para>Цей модуль показує інформацію про доступні інтерфейси для вибраного об'єкту деревоподібного списку. Інтерфейси, які не підтримуються показуються сірим кольором. Пізні інструменти, які використовуються для перегляду та керування інтерфейсом доступні під кожним розширювачем.</para>

      <figure id="iface-viewer-fig"> 
        <title>Перегляд інтерфейсу</title> 
        <screenshot> 
          <mediaobject> 
            <imageobject>
              <imagedata fileref="figures/interface_viewer.png" format="PNG"/> 
            </imageobject>
            <textobject> 
              <phrase>Інтерфейси, які підтримуються вибраними об'єктами, показуються як такі, що можна змінювати.</phrase>
            </textobject> 
          </mediaobject> 
        </screenshot> 
      </figure>
    </sect2> 
    <sect2 id="accerciser-event-monitor"> 
      <title>Монітор подій</title> 
      <para>Цей модуль переглядає обрані типи подій для об'єкта чи програми, які вибираються з з деревоподібного списку або ж стільниці загалом.</para>
      <figure id="event-monitor-fig"> 
        <title>Монітор подій</title> 
        <screenshot> 
          <mediaobject> 
            <imageobject><imagedata fileref="figures/event_monitor.png" format="PNG"/> 
            </imageobject>
            <textobject> 
              <phrase>Нижня частина вікна монітора подій дозволяє вибрати тип та джерело подій.</phrase> 
            </textobject> 
          </mediaobject> 
        </screenshot> 
      </figure>
      <tip>
        <para>Натиснувши <keycombo><keycap>Control</keycap><keycap>Alt</keycap><keycap>l</keycap></keycombo> будь-де в межах стільниці, буде підсвічено останню записану подію, яка буде використовуватися для подальших посилань. Детальніша інформація <xref linkend="accerciser-hotkey-config"/> про зміну комбінації клавіш для цієї події.</para>
      </tip>
    </sect2> 
    <sect2 id="accerciser-console"> 
      <title>Консоль IPython</title> 
      <para>Цей модуль є повністю самостійною консоллю <ulink url="http://ipython.scipy.org/moin/" type="http">IPython</ulink>. Натисніть <keycap>Tab</keycap> щоб побачити можливі завершення для поточної команди. Натисніть <keycap>Enter</keycap> для виконання коду Python. Команди, введені з консолі, мають доступ до вибраного об'єкту з дерева об'єктів через змінну <varname>acc</varname>. Окрім цього, всі функції та константи пакунку pyatspi доступні з консолі як локальні. Найбільш важливими з них є функції звертання до інших інтерфейсів об'єкту. Наприклад, запит до інтерфейсу Текст (Text): <command>t = acc.queryText() </command>. Також дозволено операцію імпорту з поточної робочої теки та шляху Python.</para> 
    </sect2> 
    <sect2 id="accerciser-api-browser"> 
      <title>Навігатор програмного інтерфейсу (API)</title>
      <para>Цей модуль показує інтерфейси, методи та ознаки, які підтримуються об'єктом, який обрано з деревоподібного списку.</para>
      <figure id="api-browser-fig"> 
        <title>Навігатор програмного інтерфейсу (API)</title>
        <screenshot> 
          <mediaobject> 
            <imageobject><imagedata fileref="figures/api_browser.png" format="PNG"/> 
            </imageobject>
            <textobject> 
              <phrase>Навігатор програмного інтерфейсу (API).</phrase> 
            </textobject> 
          </mediaobject> 
        </screenshot> 
      </figure>
    </sect2> 
    <sect2 id="accerciser-script-recorder"> 
      <title>Запис сценарію</title>
      <para>Запис сценарію <application>Accerciser</application> дозволяє користувачам записувати взаємодію клавіатури з іншими програмами стільниці з метою створення сценаріїв перевірки користувацького інтерфейсу. Наразі модуль підтримує генерацію сценаріїв для трьох платформ: Dogtail, LDTP та вбудованого програмного інтерфейсу Accerciser. Як тільки Ви натиснете кнопку "Запис", вся робота клавіатури буде записуватися до сценарію, який можна буде виконати потім, як окремий сценарій.</para>
      <figure id="script-recorder-fig"> 
        <title>Запис сценарію</title>
        <screenshot> 
          <mediaobject> 
            <imageobject><imagedata fileref="figures/script_recorder.png" format="PNG"/> 
            </imageobject>
            <textobject> 
              <phrase>Запис сценарію.</phrase> 
            </textobject> 
          </mediaobject> 
        </screenshot> 
      </figure>
    </sect2> 
    <sect2 id="accerciser-quick-select"> 
      <title>Швидкий вибір</title>
      <para>This plugin provides global hotkeys for allowing quick selection of accessibles through the target application's UI. Pressing <keycombo><keycap>Control</keycap><keycap>Alt</keycap><keycap>a</keycap></keycombo> will select the last focused widget's accessible in <application>Accerciser</application>. Натискання <keycombo><keycap>Control</keycap><keycap>Alt</keycap><keycap>t</keycap></keycombo> дозволить вибрати той об'єкт графічного елементу, який знаходиться під курсором.</para>
    </sect2> 

    <sect2 id="accerciser-validate"> 
      <title>Перевірка</title>
      <para>Цей модуль перевіряє, чи має програма проблеми з об'єктами та генерує звіт включаючи рівень критичності та опис проблеми. Звіт з'єднує помилки з відповідною документацією про виправлення типових помилок. Модуль можна розширювати відповідними схемами, які визначають правила перевірки.</para>

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

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

  </sect1>
  <!-- ============= Customization ============================= -->
  <!-- Use this section to describe how to customize the application. -->
  <sect1 id="accerciser-prefs"> 
    <title>Налаштування</title>
    <para>У <application>Accerciser</application> існують деякі елементи, які можна налаштувати:</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>Макет модулів</title> 
      <para>У <application>Accerciser</application> існує два методи налаштування макету модулів. Перший полягає у виборі елементу меню <menuchoice><guimenu>Правка</guimenu><guimenuitem>Параметри</guimenuitem></menuchoice> для активації діалогового вікна <guilabel>Параметри</guilabel>. Це діалогове вікно містить вкладки для кожного розділу, нас цікавить вкладка <guilabel>Модулі</guilabel>. У цьому розділі ви знайдете перелік виглядів для доступних модулів. Праве клацання мишкою дозволить налаштувати вигляд для будь-якого модуля.</para>
        
      <para>Ви можете оминути діалогове вікно <guilabel>Параметри</guilabel>, використовуючи операцію переносу для руху закладок модулів. Перенесення закладки модуля з нижньої або правої області модуля до головного вікна перенесе сам модуль. Перенесення вкладки на стільницю створить вікно нового модуля та перенесе туди сам модуль.</para>
    </sect2>
    <sect2 id="accerciser-hotkey-config">
      <title>Налаштування глобальних гарячих клавіш</title>
      <para>Окремі елементи <application>Accerciser</application> можуть бути доступними через глобальні клавіші. Комбінацію гарячих клавіш можна змінити у діалоговому вікні <guilabel>Параметри</guilabel>. Для його активації необхідно скористатися пунктом меню <menuchoice><guimenu>Правка</guimenu><guimenuitem>Параметри</guimenuitem></menuchoice>. Це діалогове вікно містить вкладки для кожного розділу, виберіть вкладку <guilabel>Глобальні гарячі клавіші</guilabel>. У цьому розділі Ви знайдете список переглядів для всіх доступних властивостей гарячих клавіш. Змініть комбінації гарячих клавіш на Ваш розсуд.</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>Про <application>Accerciser</application></title> 
    <para><application>Accerciser</application> написав Eitan Isaacson (<email>eitan@ascender.com</email>). Щоб отримати більше інформаціх про <application>Accerciser</application>, відвідайте сторінку<ulink url="http://live.gnome.org/Accerciser" type="http"><application>Accerciser</application> в рамках проекту GNOME Live!</ulink>.</para>

    <para>Якщо ж Ви знайшли помилку, або знаєте як покращити цю програму чи документацію, скористайтеся цими <ulink url="ghelp:gnome-feedback" type="help">вказівками</ulink>.</para>

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