<?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="zh_CN">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <articleinfo> 
    <title><application>Accerciser</application> 手册 v0.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 手册 v0.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 v0.1.5</releaseinfo> 
    <abstract role="description">
      <para>本手册描述 <application>Accerciser</application> 的使用。</para>
    </abstract> 
    <legalnotice> 
      <title>反馈</title> 
      <para>报告 <application>Accerciser</application> 程序或手册的 BUG 或提供建议，请参照  <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">at-poke</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>Applications</guimenu> 菜单</term>
          <listitem>
            <para>选择 <menuchoice><guisubmenu>Programming</guisubmenu><guimenuitem>Accerciser</guimenuitem></menuchoice> 菜单项。</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>命令行</term>
          <listitem>
            <para>在控制台窗口中键入如下命令，然后按下 <keycap>Return</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>可访问控件视图允许查看所有的桌面级的accessibles启动。选择一个可进入的，使用加载插件作进一步检查。</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>View</guimenu><guimenuitem>Single plugin view</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>Bookmarks</guimenu><guimenuitem>Add Bookmark...</guimenuitem></menuchoice>或者按下<keycombo><keycap>Control</keycap><keycap>d</keycap></keycombo>。</para>
      <para>书签来进入Accerciser被界定成一个应用程序和一个应用程序内部组织的"path"来进入书签。当目标程序在不同状态时(比如：多高层框架)，这个路径可能是错误的。</para>
      <para>书签可以通过书签编辑对话框 <menuchoice><guimenu>Bookmarks</guimenu><guimenuitem>Edit Bookmarks...</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包所有的功能和常数在本地控制台是可用的。这些中最重要的搜寻其他辅助接口的功能。比如，搜寻文本接口：<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嵌入的API。一旦你在任意键盘交互中按下"Record"按钮将被记录成一个脚本，它随后作为一个单独标准的脚本被执行。</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>通过目标程序的用户界面，插件提供全局热键来快速选择。按下<keycombo><keycap>Control</keycap><keycap>Alt</keycap><keycap>a</keycap></keycombo>将选择<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>Validate</guibutton>按钮来启动测试。当测试开始运行，再次按下按钮取笑它。</para>

      <para>当测试完成，报告表格显示所有错误的严格描述。双击表格的一列显示树的关联访问。用条目的选择，按下<guibutton>Help</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>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice>来激活<guilabel>Preferences</guilabel>对话框。这个对话框包括每个项的标签，选择<guilabel>Plugins</guilabel>标签。在项里您将找到所有可用插件的目录视图。右击任一插件目录来配置它的视图。</para>
        
      <para>您可以通过拖入拖出来移动插件标签来省略<guilabel>Preferences</guilabel>对话框。拖入一个插件标签至主窗口对按钮或右侧插件区域将移动插件。拖入标签至桌面将创建一个新的插件窗口并相应的插件将会拖出。</para>
    </sect2>
    <sect2 id="accerciser-hotkey-config">
      <title>全局热键配置</title>
      <para>在<application>Accerciser</application>里的一些元素通过热键会启用某些功能。通过<guilabel>Preferences</guilabel>对话框热键组合可以更改，如此做您可以选择<menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice>来激活<guilabel>Preferences</guilabel>对话框。对话框包括每一部分的内容标签，选择<guilabel>Global Hotkeys</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>Eitan Isaacson(<email>eitan@ascender.com</email>)写了<application>Accerciser</application>。想得到更多的关于<application>Accerciser</application>的信息，请访问<ulink url="http://live.gnome.org/Accerciser" type="http"><application>Accerciser</application> GNOME Live! page</ulink>。</para>

    <para>报告BUG或提供本程序或手册的建议，依照如下链接<ulink url="ghelp:gnome-feedback" type="help">document</ulink>的指示。</para>

    <para>重新发布和使用源码和二进制形式，不管有没有修改，在BSD许可条框下是被许可的。</para>
  </sect1> 
</article>
