<?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="ja">
<!-- 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 Corporation</holder> 
    </copyright><copyright><year>2010.</year><holder>松澤二郎 (matsuzawa.jr@gmail.com)</holder></copyright><copyright><year>2010.</year><holder>日本GNOMEユーザ会 (http://www.gnome.gr.jp/)</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 バージョン 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 Feedback Page</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>アプリケーション</guimenu>・メニュー</term>
          <listitem>
            <para><menuchoice><guisubmenu>プログラミング</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>ウィジェット・ツリー・ビューはデスクトップで起動しているすべてのウィジェットを表示することができます。ウィジェットを選択することで、より詳細な検査のためにロード済みプラグインの使用が可能になります。</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>のスクリプト・レコーダは、UI テスト・スクリプトを書く目的で、ユーザが他のデスクトップアプリケーションに対するキーボード操作を記録することができます。現在プラグインは次のみっつのプラットフォームのスクリプトの世代をサポートします。すなわち、Dogtail、LDTP および Accerciser ビルトイン API。一度 "録音" ボタンを押すとあらゆるキーボード操作がスクリプトに記録され、そのスクリプトは後にスタンド・アロン・スクリプトとして実行可能です。</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>このプラグインは、対象のアプリケーションの UI を通した、ウィジェットの迅速な選択を可能にするグローバルなホットキーを提供します。 <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>編集</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>画面を開いてください。この画面は各セクションのタブがありますが、<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! page</ulink>にアクセスしてください。</para>

    <para>バグの報告あるいは本アプリケーション、本マニュアルについての提案をするには、本<ulink url="ghelp:gnome-feedback" type="help">ドキュメント</ulink>の指示にしたがってください。</para>

    <para>ソースコードおよびバイナリフォーマットでの再頒布、使用については、改版の有無に関わらず、BSDライセンスの条項の下で許可されています。</para>
  </sect1> 
</article>
