Difference between revisions of "Accessibility"

From Apache OpenOffice Wiki
Jump to: navigation, search
m (MacOSX: Made the link acessible)
(7 intermediate revisions by 6 users not shown)
Line 1: Line 1:
[[OpenOffice.org]] has support for various '''Accessibility''' aspects: keyboard navigation, scheming, assistive technology (AT) support, and much more.
+
Apache OpenOffice has support for various '''Accessibility''' aspects: keyboard navigation, scheming, assistive technology (AT) support, and much more.  
  
Details can be found here: http://ui.openoffice.org/accessibility/whitepaper.html
+
Details can be found here: http://ui.openoffice.org/accessibility/whitepaper.html  
  
 
There is a mailing list which can be used for user questions and comments, as well as for developer related things.  
 
There is a mailing list which can be used for user questions and comments, as well as for developer related things.  
  
Please subscribe to '''accessibility@ui.openoffice.org''', or have a look into http://ui.openoffice.org/servlets/SummarizeList?listName=accessibility
+
Please subscribe to '''dev@apache.openoffice.org''' by sending an email to '''dev-subscribe@apache.openoffice.org'''
  
The Accessibility Project pages are here: http://ui.openoffice.org/accessibility/
+
The Accessibility Project pages are here: http://ui.openoffice.org/accessibility/  
  
== OpenOffice.org AT support ==
+
== OpenOffice AT support ==
  
OpenOffice.org exposes it's information to AT via the Java Accessibility API (JAA) on Windows, and via GNOME Accessibility API (ATK) on Linux/Solaris with GNOME.
+
OpenOffice exposes it's information to AT via the Java Accessibility API (JAA) on Windows, via GNOME Accessibility API (ATK) on Linux/Solaris with GNOME and via NSAccessibility on MAC OSX.  
This way OpenOffice.org should be accessible with AT supporting JAA or ATK.
+
  
More details about this can be found here: http://ui.openoffice.org/accessibility/at-support.html.
+
More details about this can be found [http://ui.openoffice.org/accessibility/at-support.html here].  
  
=== Windows ===
+
Information for Developers and Testers can be found [[Accessibility/Developer|here]].
  
To use [[Java]] Accessibility, a current version of Java (v1.5 or newer) must be installed.
+
=== Windows  ===
This can be found here: http://java.sun.com/
+
  
Verify that OpenOffice.org uses the correct version: Choose menu Tools/Options/Java.
+
To use [[Java]] Accessibility, a current version of Java (v1.5 or newer) must be installed. This can be found here: http://java.sun.com/
  
You also need the “Java Access Bridge for Windows v2”, which can be found here: http://java.sun.com/products/accessbridge/
+
Verify that OpenOffice uses the correct version: Choose menu Tools/Options/Java.  
  
You also have to activate AT support in OpenOffice.org: Choose menu Tools/Options/Accessibility and check “Support assistive technology tools”.
+
You also need the “Java Access Bridge for Windows v2”, which can be found here: http://www.oracle.com/technetwork/java/javase/tech/index-jsp-136191.html (former url http://java.sun.com/products/accessbridge/ doesn't work anymore)
If you can't access the OOo GUI, you might want to use a registry key: HKEY_CURRENT_USER\Software\OpenOffice.org\Accessibility\AtToolSupport (dword:1)
+
(Attention: If that key exists, the value from configuration will be ignored)
+
  
If you want to install the Access-Bridge only for one user, you can find some hints at [[Windows Access Bridge Single-User Install]].
+
You also have to activate AT support in OpenOffice: Choose menu Tools/Options/Accessibility and check “Support assistive technology tools”. If you can't access the OOo GUI, you might want to use a registry key: HKEY_CURRENT_USER\Software\OpenOffice.org\Accessibility\AtToolSupport (dword:1) (Attention: If that key exists, the value from configuration will be ignored)
 +
 
 +
If you want to install the Access-Bridge only for one user, you can find some hints at [[Windows Access Bridge Single-User Install]].  
  
 
Adding support for IAccessible2 is an ongoing effort, see [[Accessibility/IAccessible2 support]] for the status.
 
Adding support for IAccessible2 is an ongoing effort, see [[Accessibility/IAccessible2 support]] for the status.
  
=== GNOME ===
+
=== GNOME ===
 +
 
 +
Everything you need is included in current versions of GNOME.
  
Everything you need is included in current versions of GNOME.
+
Activate AT support globally: Preferences/Accessibility/Assistive Technology Support, check “Enable assistive technologies” More information can be found here: http://developer.gnome.org/projects/gap/
  
Activate AT support globally: Preferences/Accessibility/Assistive Technology Support, check “Enable assistive technologies”
+
[[Accessibility/TextAttributes]] lists the mapping between OOo text properties and ATK text attributes.  
More information can be found here: http://developer.gnome.org/projects/gap/
+
  
[[Accessibility/TextAttributes]] lists the mapping between OOo text properties and ATK text attributes.
+
=== MacOSX  ===
  
=== MacOSX ===
+
[http://wiki.services.openoffice.org/wiki/Accessibility/MacOSX MacOSX Accessibility information].
  
[http://wiki.services.openoffice.org/wiki/Accessibility/MacOSX MacOSX Accessibility information].
+
OpenOffice interacts well in general with the VoiceOver screen reader that is built into Mac OS X. Enable the screen reader using Command-F5 and set the options using control-option-F8. OpenOffice accepts the VoiceOver Navigation well and for the most part the options are available to the screen reader. Some options can't be accessed with the screen reader navigation.  
  
=== AT that works ===
+
=== AT that works ===
  
In general, AT support is much better on GNOME than on Windows. This is no limitation within OpenOffice.org, but in Windows AT, which concentrates on other things, not on Java Accessibility.
+
In general, AT support is much better on GNOME than on Windows. This is no limitation within OpenOffice, but in Windows AT, which concentrates on other things, not on Java Accessibility.  
  
* Windows, Screen Reader
+
*Windows, Screen Reader  
** ZoomText 7.11, 8.12, 9.x
+
**ZoomText 7.11, 8.12, 9.x  
** JAWS 6.2, 7.x
+
**JAWS 6.2, 7.x  
** NVDA (open source!)
+
**NVDA (open source!)
  
* Windows, Screen Magnifier
+
*Windows, Screen Magnifier  
** ZoomText 7.11, 8.12, 9.x
+
**ZoomText 7.11, 8.12, 9.x
  
* Windows, On Screen keyboard
+
*Windows, On Screen keyboard  
** Probably all, because they just send Windows messages
+
**Probably all, because they just send Windows messages
  
* GNOME, Screen Reader
+
*GNOME, Screen Reader  
** Orca
+
**Orca  
** Gnopernicus
+
**Gnopernicus
  
* GNOME, Screen Magnifier
+
*GNOME, Screen Magnifier  
** Gnopernicus
+
**Gnopernicus  
** (Orca)
+
**(Orca)
  
* GNOME, On Screen keyboard
+
*GNOME, On Screen keyboard  
** GOK
+
**GOK  
** Dasher
+
**Dasher
  
* Mac OSX
+
*Mac OS X
** Voice Over
+
**VoiceOver
  
=== Orca ===
+
=== Orca ===
  
In order to get OpenOffice.org (Version 2.3 and up) speaking through the graphical screenreader Orca (http://live.gnome.org/Orca), you don't necessarily need to start a gnome-session in GNU/Linux. Setting and exporting the following variables in the shell, will tell the soffice command to use the atk-spi bridge of GTK.  
+
In order to get OpenOffice (Version 2.3 and up) speaking through the graphical screenreader Orca (http://live.gnome.org/Orca), you don't necessarily need to start a gnome-session in GNU/Linux. Setting and exporting the following variables in the shell, will tell the soffice command to use the atk-spi bridge of GTK.  
  
 
   <tt>export SAL_USE_VCLPLUGIN="gtk" GTK_MODULES="gail:atk-bridge"</tt>
 
   <tt>export SAL_USE_VCLPLUGIN="gtk" GTK_MODULES="gail:atk-bridge"</tt>
  <tt>orca &  # if not already running</tt>
+
<tt>orca &amp; # if not already running</tt>
  <tt>soffice file.odt</tt>
+
<tt>soffice file.odt</tt>
  
 
With Orca running, all of OOo's menu functions are accessible with speech and braille using the left "Alt" key or the right "Menu" key on your keyboard, in combination with navigation functions that Orca provides with its hotkeys (usually Scroll_Lock plus one or more other keys).
 
With Orca running, all of OOo's menu functions are accessible with speech and braille using the left "Alt" key or the right "Menu" key on your keyboard, in combination with navigation functions that Orca provides with its hotkeys (usually Scroll_Lock plus one or more other keys).
Line 90: Line 89:
 
While the normal (edit) mode for presentations works well with AT, the slide show itself doesn't expose much information. The reason is the the slide show only has elements optimized for the slide show, and doesn't know the real objects in the presentation document. Even knowing the real objects, it's unclear how to best expose the content, given that you won't see all content at once, but the many transition effects result in many changes to what you see on the screen.  
 
While the normal (edit) mode for presentations works well with AT, the slide show itself doesn't expose much information. The reason is the the slide show only has elements optimized for the slide show, and doesn't know the real objects in the presentation document. Even knowing the real objects, it's unclear how to best expose the content, given that you won't see all content at once, but the many transition effects result in many changes to what you see on the screen.  
  
For making slide shows accessible, people should use the [http://extensions.services.openoffice.org/project/presenter-screen Presenter Console]. (Please note the the currently available extension is not accessible - an update should be available in the OOo 3.2 time frame.  
+
For making slide shows accessible, people should use the [http://extensions.services.openoffice.org/project/presenter-screen Presenter Console]. (Please note the the currently available extension is not accessible - an update should be available in the OOo 3.2 time frame. See also [[Presenter Console]] for a description of the extension.  
See also [[Presenter Console]] for a description of the extension.
+
  
 
In the presenter console, the critical information is exposed to AT: Current slide and it's notes.  
 
In the presenter console, the critical information is exposed to AT: Current slide and it's notes.  
Line 97: Line 95:
 
We believe that the presentation slides itself are not a good source for gathering the critical information you need while giving a life presentation, and that people would put information they need in the notes.  
 
We believe that the presentation slides itself are not a good source for gathering the critical information you need while giving a life presentation, and that people would put information they need in the notes.  
  
I hope some (accessible) documentation / help explaining the keyboard usage will also be available with the next version. See [[Presenter Console#Keyboard Shortcuts]] for a list of the support keyboard shortcuts.
+
I hope some (accessible) documentation / help explaining the keyboard usage will also be available with the next version. See [[Presenter Console#Keyboard_Shortcuts]] for a list of the support keyboard shortcuts.  
  
 
<br>  
 
<br>  
  
== OpenOffice.org DAISY support  ==
+
== OpenOffice DAISY support  ==
  
 
An Extension for exporting ODT to DAISY / DTBOOK is available here:  
 
An Extension for exporting ODT to DAISY / DTBOOK is available here:  
  
[http://odt2dtbook.sourceforge.net/ odt2dtbook OpenOffice.org Extension]
+
[http://odt2dtbook.sourceforge.net/ odt2dtbook OpenOffice.org Extension]  
  
== External Links ==
+
== External Links ==
  
[http://markhobley.yi.org:9088/ The Accessibility Users' Wiki]
+
[http://markhobley.yi.org:9088/ The Accessibility Users' Wiki]  
  
[[Category:Article]]
+
[[Category:Article]] [[Category:Accessibility]] [[it:IT/Accessibility|it:IT/Accessibility]]
[[Category:Accessibility]]
+
[[fr:FR/Accessibility|fr:FR/Accessibility]]

Revision as of 16:27, 22 December 2014

Apache OpenOffice has support for various Accessibility aspects: keyboard navigation, scheming, assistive technology (AT) support, and much more.

Details can be found here: http://ui.openoffice.org/accessibility/whitepaper.html

There is a mailing list which can be used for user questions and comments, as well as for developer related things.

Please subscribe to dev@apache.openoffice.org by sending an email to dev-subscribe@apache.openoffice.org

The Accessibility Project pages are here: http://ui.openoffice.org/accessibility/

OpenOffice AT support

OpenOffice exposes it's information to AT via the Java Accessibility API (JAA) on Windows, via GNOME Accessibility API (ATK) on Linux/Solaris with GNOME and via NSAccessibility on MAC OSX.

More details about this can be found here.

Information for Developers and Testers can be found here.

Windows

To use Java Accessibility, a current version of Java (v1.5 or newer) must be installed. This can be found here: http://java.sun.com/

Verify that OpenOffice uses the correct version: Choose menu Tools/Options/Java.

You also need the “Java Access Bridge for Windows v2”, which can be found here: http://www.oracle.com/technetwork/java/javase/tech/index-jsp-136191.html (former url http://java.sun.com/products/accessbridge/ doesn't work anymore)

You also have to activate AT support in OpenOffice: Choose menu Tools/Options/Accessibility and check “Support assistive technology tools”. If you can't access the OOo GUI, you might want to use a registry key: HKEY_CURRENT_USER\Software\OpenOffice.org\Accessibility\AtToolSupport (dword:1) (Attention: If that key exists, the value from configuration will be ignored)

If you want to install the Access-Bridge only for one user, you can find some hints at Windows Access Bridge Single-User Install.

Adding support for IAccessible2 is an ongoing effort, see Accessibility/IAccessible2 support for the status.

GNOME

Everything you need is included in current versions of GNOME.

Activate AT support globally: Preferences/Accessibility/Assistive Technology Support, check “Enable assistive technologies” More information can be found here: http://developer.gnome.org/projects/gap/

Accessibility/TextAttributes lists the mapping between OOo text properties and ATK text attributes.

MacOSX

MacOSX Accessibility information.

OpenOffice interacts well in general with the VoiceOver screen reader that is built into Mac OS X. Enable the screen reader using Command-F5 and set the options using control-option-F8. OpenOffice accepts the VoiceOver Navigation well and for the most part the options are available to the screen reader. Some options can't be accessed with the screen reader navigation.

AT that works

In general, AT support is much better on GNOME than on Windows. This is no limitation within OpenOffice, but in Windows AT, which concentrates on other things, not on Java Accessibility.

  • Windows, Screen Reader
    • ZoomText 7.11, 8.12, 9.x
    • JAWS 6.2, 7.x
    • NVDA (open source!)
  • Windows, Screen Magnifier
    • ZoomText 7.11, 8.12, 9.x
  • Windows, On Screen keyboard
    • Probably all, because they just send Windows messages
  • GNOME, Screen Reader
    • Orca
    • Gnopernicus
  • GNOME, Screen Magnifier
    • Gnopernicus
    • (Orca)
  • GNOME, On Screen keyboard
    • GOK
    • Dasher
  • Mac OS X
    • VoiceOver

Orca

In order to get OpenOffice (Version 2.3 and up) speaking through the graphical screenreader Orca (http://live.gnome.org/Orca), you don't necessarily need to start a gnome-session in GNU/Linux. Setting and exporting the following variables in the shell, will tell the soffice command to use the atk-spi bridge of GTK.

 export SAL_USE_VCLPLUGIN="gtk" GTK_MODULES="gail:atk-bridge"
orca &  # if not already running
soffice file.odt

With Orca running, all of OOo's menu functions are accessible with speech and braille using the left "Alt" key or the right "Menu" key on your keyboard, in combination with navigation functions that Orca provides with its hotkeys (usually Scroll_Lock plus one or more other keys).

AT support while giving a presentation

While the normal (edit) mode for presentations works well with AT, the slide show itself doesn't expose much information. The reason is the the slide show only has elements optimized for the slide show, and doesn't know the real objects in the presentation document. Even knowing the real objects, it's unclear how to best expose the content, given that you won't see all content at once, but the many transition effects result in many changes to what you see on the screen.

For making slide shows accessible, people should use the Presenter Console. (Please note the the currently available extension is not accessible - an update should be available in the OOo 3.2 time frame. See also Presenter Console for a description of the extension.

In the presenter console, the critical information is exposed to AT: Current slide and it's notes.

We believe that the presentation slides itself are not a good source for gathering the critical information you need while giving a life presentation, and that people would put information they need in the notes.

I hope some (accessible) documentation / help explaining the keyboard usage will also be available with the next version. See Presenter Console#Keyboard_Shortcuts for a list of the support keyboard shortcuts.


OpenOffice DAISY support

An Extension for exporting ODT to DAISY / DTBOOK is available here:

odt2dtbook OpenOffice.org Extension

External Links

The Accessibility Users' Wiki

Personal tools
In other languages