Re: Documentation

[Alejandro Piñeiro <apinheiro igalia com>]

On 17/07/16 12:35, Javier Hernandez wrote:

Hey Jean Philippe,

On Sun, Jul 17, 2016 at 2:07 AM, MENGUAL Jean-Philippe <mengualjeanphi free fr> wrote:

Hi,

I'm collecting all the available doc about accessibility infrastructure.
What should I say to a dev who want to help:
- at-spi;
- GTK tips for accessibility

* https://wiki.gnome.org/Accessibility

* https://developer.gnome.org/accessibility-devel-guide/stable/gad-how-it-works.html.en

* https://developer.gnome.org/accessibility-devel-guide/stable/

 

Where can I find info about ATK? What's the diff ATK/AT-SPI?

ATK: https://developer.gnome.org/atk/

AT-SPI: https://www.freedesktop.org/wiki/Accessibility/AT-SPI2/

Some time ago, the accessibility team also made an effort to improve wikipedia pages:
https://en.wikipedia.org/wiki/Accessibility_Toolkit
https://en.wikipedia.org/wiki/Assistive_Technology_Service_Provider_Interface

Among other things, we made an effort to explain the difference between ATK and AT-SPI.

 

Finally, does some doc exist to make Orca work with other toolkits:
- if I understand qt-at-spi = at-spi for Qt

Right, look at this link https://community.kde.org/Accessibility/qt-atspi

 

- ATK is generic

ATK is for GTK, built-into GTK itself

No. There is an ATK implementation built-into GTK itself, but ATK is generic and tries to be as abstracted as possible. We made a list of projects implementing ATK on the wikipedia page, but fwiw, here a list of projects that has an implementation of ATK:
  * Clutter.
  * Gnome-shell (it uses clutter built-in ATK implementation as a base)
  * LibreOffice
  * Unity3D (although not sure if it is still working)
  * WebKitGTK (although it uses "GTK" thing, it only uses GTK accessibility support for the main container, most of the accessibility support is a custom implementation of ATK)
  * Mozilla (ditto)

 

- Java has its own bus (what about with Orca)?

Java has its own bridge, https://wiki.gnome.org/Attic/Java%20Access%20Bridge

This bridge has been deprecated for a long time. It is based on at-spi1 (that one based on Corba). For at-spi2 you should use Java Atk Wrapper:
https://wiki.gnome.org/Accessibility/JavaAtkWrapper

As the name says, it is a wrapper. It wraps Java accessibility with ATK, so it uses at-spi2-atk. Technically you could consider the java-atk-wrapper another ATK implementation. So no, Java doesn't use its own bus these days.

 

- WxWidgets: I see a wxaccessible, but I don't know what about Orca.
Joanie told me some widgets should be connected to ATK. Can you explain
me the archstecture or tell me a doc about it?

Some doc about WxWidgets: https://www.wxwidgets.org/docs/tutorials/accessibility/

Briefly, I guess what Joanie said is that WxWidgets needs to "export" the accessibility information of the widgets to AT-SPI in a way that Orca can "understand" them properly.

 

Thanks for your help.

Regards,

Hope that helps :)

Bien à toi,

Javi

 

--

Jean-Philippe MENGUAL

HYPRA, progressons ensemble

Tél.: 01 84 73 06 61
Mail: contact hypra fr

Site Web: http://hypra.fr
_______________________________________________
gnome-accessibility-list mailing list
gnome-accessibility-list gnome org
https://mail.gnome.org/mailman/listinfo/gnome-accessibility-list

_______________________________________________
gnome-accessibility-list mailing list
gnome-accessibility-list gnome org
https://mail.gnome.org/mailman/listinfo/gnome-accessibility-list