Difference between revisions of "Accessibility"

From Apache OpenOffice Wiki
Jump to: navigation, search
m (added links to sub-pages)
(OpenOffice DAISY support)
 
(14 intermediate revisions by 10 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@openoffice.apache.org''' by sending an email to '''dev-subscribe@openoffice.apache.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”
+
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/  
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.
+
[[Accessibility/TextAttributes]] lists the mapping between OOo text properties and ATK text attributes.  
  
=== MacOSX ===
+
=== MacOSX ===
  
Please have a look [http://wiki.services.openoffice.org/wiki/Accessibility/MacOSX here].
+
[http://wiki.services.openoffice.org/wiki/Accessibility/MacOSX MacOSX Accessibility information].  
  
=== AT that works ===
+
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.
  
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.
+
=== AT that works  ===
  
* Windows, Screen Reader
+
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.  
** ZoomText 7.11, 8.12, 9.x
+
** JAWS 6.2, 7.x
+
** NVDA (open source!)
+
  
* Windows, Screen Magnifier
+
*Windows, Screen Reader
** ZoomText 7.11, 8.12, 9.x
+
**ZoomText 7.11, 8.12, 9.x  
 +
**JAWS 6.2, 7.x
 +
**NVDA (open source!)
  
* Windows, On Screen keyboard
+
*Windows, Screen Magnifier
** Probably all, because they just send Windows messages
+
**ZoomText 7.11, 8.12, 9.x
  
* GNOME, Screen Reader
+
*Windows, On Screen keyboard
** Orca
+
**Probably all, because they just send Windows messages
** Gnopernicus
+
  
* GNOME, Screen Magnifier
+
*GNOME, Screen Reader
** Gnopernicus
+
**Orca
** (Orca)
+
**Gnopernicus
  
* GNOME, On Screen keyboard
+
*GNOME, Screen Magnifier
** GOK
+
**Gnopernicus
** Dasher
+
**(Orca)
  
* Mac OSX
+
*GNOME, On Screen keyboard
** Voice Over
+
**GOK
 +
**Dasher
  
=== Orca ===
+
*Mac OS X
 +
**VoiceOver
  
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.  
+
=== 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.  
  
 
   <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).
  
=== External Links ===
+
== 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 [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.
 +
 
 +
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.
 +
 
 +
<br>
 +
 
 +
== OpenOffice DAISY support  ==
 +
 
 +
An Extension for exporting ODT to DAISY / DTBOOK is available here:
 +
 
 +
[https://extensions.openoffice.org/en/project/export-daisy-xmlaudio-odt2daisy odt2daisy OpenOffice.org Extension]
 +
 
 +
More details at http://odt2daisy.sf.net
 +
 
 +
== 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]]

Latest revision as of 17:59, 26 November 2017

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@openoffice.apache.org by sending an email to dev-subscribe@openoffice.apache.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:

odt2daisy OpenOffice.org Extension

More details at http://odt2daisy.sf.net

External Links

The Accessibility Users' Wiki

Personal tools
In other languages