IT翻訳 Nobuyuki の仕事部屋

ボランティアでソフトウエアーローカライズのために翻訳をしている。

Gecko Info for Windows Accessibility Vendors更新対応2

2005-05-30 20:33:49 | InTranslated
さて、本日から更新文書対応のため、草稿を作り直す作業に入ります。

旧バージョン: Gecko Info for Windows Accessibility Vendors Rev.1.02
新バージョン: Gecko Info for Windows Accessibility Vendors Rev.1.13

進め方は、原文(旧、新)と訳文(新)を表示して行きます。

変更部分は、新たに追加されたところと、従来の文章が微妙に変更された部分とがないまぜになっているので、新、旧を明確に区別するのは、けっこう難しいようです。

原文(旧):  青色表示
原文(新):  緑色表示
訳文(新):  黒色表示
*注記/コメント: 赤色表示


Gecko Info for Windows Accessibility Vendors

This FAQ explains how makers of Windows screen readers, voice dictation packages and magnification software can support Gecko-based software. The base of our support for these products is MSAA (Microsoft Active Accessibility), external content DOM support, and the keyboard API/user interface. Currently, support for accessibility API's exists only on the Windows platform.


Gecko Info for Windows Accessibility Vendors

This FAQ explains how makers of Windows screen readers, voice dictation packages and magnification software can support Gecko-based software. The base of our support for these products is MSAA (Microsoft Active Accessibility), external readonly DOM support, and the keyboard API/user interface.

For Firefox and all other Gecko-based products: this documentation only applies to up-to-date builds of Firefox -- currently not an official releases. Grab the current build of Firefox which supports these features.


Windows アクセシビリティベンダー向け Gecko 情報

この FAQ は Windows のスクリーンリーダ、音声検出パッケージ、拡大鏡ソフトウェアの製作者が、どうすれば Gecko ベースのソフトウェアをサポート出来るかについて説明しています。これらの製品に対する私たちのサポートのベースとなるのは、MSAA (Microsoft Active Accessibility)、外部の readonly DOM サポート、およびキーボード API/ ユーザインターフェイスです。

Firefox とその他の Gecko ベースの製品すべてにとって、この文書は現在まだ公式リリースになっていない Firefox の最新のビルドにのみ適用されます。これらの機能をサポートする Firefox の現行のビルドを見てください。



Contents

* Definitions
* Windows Applications Based on the Gecko Layout Engine
* MSAA Support: IAccessible Methods
* MSAA Support: Event Tracking and Unique ID's
* MSAA Features We Do Not Support
* Intentional Differences with Internet Explorer
* Enhancing Performance on the Client End via IEnumVARIANT
* Additional DOM support
* Keyboard UI Information
* Beyond HTML: Other Types of Web Content
* Questions or Comments?


Contents

* Definitions
* Windows Applications Based on the Gecko Layout Engine
* How to Find the Content Window and Load the Document
* MSAA Support: IAccessible Methods
* MSAA Support: Event Tracking and Unique ID's
* MSAA Features We Do Not Support
* Intentional Differences with Internet Explorer
* Table of MSAA Roles Supported
* Enhancing Performance on the Client End via IEnumVARIANT
* Avoiding Memory Leaks
* Additional DOM support
* Keyboard UI Information
* Beyond HTML: Other Types of Web Content -- DHTML, MathML, SVG, XForms and XUL
* Questions or Comments?



目次

* 定義
* Gecko レイアウトエンジンに基づく Windows アプリケーション
* コンテンツウィンドウの見つけ方とドキュメントの読み込み方法//新規追加の節//
* MSAA サポート: IAccessible のメソッド
* MSAA サポート: イベント追跡と一意の ID
* サポートしない MSAA の機能
* Internet Explorer との意図的な違い
* サポートされる MSAA Roles の一覧表//新規追加の節//
* IEnumVARIANT によるクライアントエンドの性能向上
* メモリリークを回避する//新規追加の節//
* 追加的 DOM サポート
* キーボード UI 情報
* HTML を超えて: 他の種類のウェブコンテンツ -- DHTML、MathML、SVG、XForms、XUL
* 質問あるいはコメント?


//目次から明らかなのは、新たに 3 節が追加されていますが、従来の節でも追加変更がかなり在るようです。//

Definitions

* Gecko : Mozilla's rendering engine. Gecko is the internal engine that Mozilla uses to render any kind of web content. It supports HTML, Cascading Style Sheets (CSS) and the Document Object Model (DOM).
* MSAA : Microsoft Active Accessibility, an API devised by Microsoft so that accessibility aids can track what's going on inside the user interface of any software package that supports it. If you seriously need to understand MSAA, you'll need to read the docs on MSDN and play with the sample apps and code that come with MSAA SDK 1.3. (I recommend SDK 1.3 because the MSAA SDK 2.0 doesn't come with the source code to the testing tools. The other differences are minor).
* DOM : Document Object Model. This is the W3C's specification for how web content is exposed to Javascripts and other languages. It covers content, style and events. Inside the process, Gecko-based products have full support for DOM level 1, and more support for the standard is on the way. However, exposing the entire DOM to external software packages is quite involved. We have chosen a subset of the DOM needed for accessibility aid vendors. Events such as focus changes must be tracked through MSAA events, rather than DOM events.



Definitions

Here are some basic definitions that you'll need for this document to make sense:

* Gecko : The rendering engine for Firefox, Thunderbird, Nvu, Mozilla Seamonkey and other applications. Gecko is the internal engine that Mozilla uses to render any kind of web content. It supports HTML, XHTML, Cascading Style Sheets (CSS) and the Document Object Model (DOM).
* MSAA : Microsoft Active Accessibility, an API devised by Microsoft so that accessibility aids can track what's going on inside the user interface of any software package that supports it. If you seriously need to understand MSAA, you'll need to read the docs on MSDN and play with the sample apps and code that come with MSAA SDK 1.3. (I recommend SDK 1.3 because the MSAA SDK 2.0 doesn't come with the source code to the testing tools. The other differences are not important).
* DOM : Document Object Model. This is the W3C's specification for how web content is exposed to Javascript and other languages. It covers content, style and events. Inside the Gecko process, code has full to DOM APIs. However, exposing the entire DOM to external software packages is quite involved, partially because changes to the DOM in Firefox must occur on the main thread. We have chosen a subset of readonly methods in the DOM needed for assistive technology vendors. Events such as focus changes must be tracked through MSAA events, rather than DOM events.
* XUL: The XML-based language used by Firefox and Mozilla to develop the UI. Similar to HTML in that it can be combined with CSS and Javascript to make powerful applications. Contains more desktop-style widgets than HTML and follows a box layout model, rather than being text-flow based.
* Roles, states and events: please read the MSAA documentation on MSDN if you are unfamiliar with these. in general we abbreviate by removing redundant words. For example, we may say EVENT_ALERT instead of the full EVENT_SYSTEM_ALERT.



定義

この文書を理解する上で必要になる基本的定義を示します:

* Gecko : Firefox、Thunderbird、Nvu、Mozilla Seamonkey、その他アプリケーション用のレンダリングエンジン。Gecko は Mozilla があらゆる種類のウェブコンテンツを表示するために使う内部エンジンです。HTML、Cascading Style Sheets (CSS)、Document Object Model (DOM) をサポートします。
* MSAA : Microsoft Active Accessibility は Microsoft によって作られた API で、アクセシビリティの補助機能が、ユーザーインターフェイスをサポートするソフトウエアーにおいて、ユーザーインターフェイスの内部で発生している事を追跡できます。もし MSAA を真剣に理解しようとするならば、MSDN で資料を読み、MSAA SDK 1.3 によって提供されるアプリケーションとコードを試してみる必要があります。(MSAA SDK 2.0 はテストツールのソースコードを備えていないので、 SDK 1.3 を推奨します。他の違いは重要ではありません。)
* DOM : Document Object Model。これは、ウェブコンテンツがどのようにして Javascript や他の言語へ公開されるかについての W3C の仕様です。DOM はコンテンツ、スタイル、イベントをカバーします。Gecko の内部処理は、DOM API のコードに溢れていますが(草稿訳注:ここの訳自信なし)、全 DOM を外部ソフトウェアパッケージに公開することはあまりに大掛かりとなります。ひとつには、Firefox において DOM へ変更を加えることは、メインスレッドで行われることになるからです。私たちは、アクセシビリティ補助機器ベンダーに必要とされる、 DOM のサブセットを選り抜きました。フォーカスの変更などのイベントは DOM イベントではなく、MSAA イベントによって追跡される必要があります。
* XUL: ユーザインターフェイスを開発するのに Firefox や Mozilla によって使われる XML をベースとする言語。強力なアプリケーションを作成するのに CSS や Javascript と組み合わせて仕様可能である点が、HTML と似ている。HTML よりデスクトップ型のウィジェットをより多く含み、テキストフロー(text-flow)ではなく、ボックスレイアウトの方式を採用します。
* 役割、状態、イベント: これらをあまりご存知でなければ、MSDN で MSAA の文書を読んでください。通常余分な言葉を省くことで、短縮します。例えば、EVENT_SYSTEM_ALERT とすべて言わずに、EVENT_ALERT とすることができます。


//定義では最後の 2 項目が追加されました:XUL と 役割、状態、イベント//

本日はここまでとしますが、変更分は新草稿に反映します。
旧草稿新草稿

以上