Difference between revisions of "Development/Tutorials/Accessibility"
(Link to Community Wiki)
 
(15 intermediate revisions by 4 users not shown)
Line 1: Line 1:
−
== QAccessible ==
+
{{Archived}}
  
−
[http://doc.qt.nokia.com/4.7/accessible.html QAccessible] is the Qt Accessible framework. Each Qt/KDE application supports QAccessible out of the box.
+
{{Info|The [https://community.kde.org/Accessibility KDE Accessibility Project] is now located at the KDE Community Wiki.}}
  
−
== Qt AT-SPI ==
+
= Introduction =
 +
Below is a list of tutorials for KDE accessibility improvements.
  
−
[http://gitorious.org/qt-at-spi qt-at-spi] is a Qt plugin that bridges the QAccessible API’s to the AT-SPI 2 protocol enabling Qt applications to be used with Orca, Accerciser, and GOK.
+
== Screen Reader ==
 +
;[http://userbase.kde.org/Accessibility Accessibility Documentation for Users on userbase.kde.org]
 +
:''Explains how to get started with screen readers as a user.''
  
−
For a brief overview of how atk/at-spi accessibility works on linux platforms, take a look at [http://a11y.org/atspi http://a11y.org/atspi].
+
;[[Development/Tutorials/Accessibility/Checklist|Accessibility Checklist]]
 +
:''What to look for in your application to make it accessible for as many people as possible.''
  
−
=== Setup a test environment ===
+
;[[Development/Tutorials/Accessibility/Screen_Reader_Setup|Screen Reader]]
−
In order to set up a test environment to help improve qt-at-spi (or at-spi itself)  You'll need a few things.  Orca can be installed from your distribution, as can accerciser, however accerciser will need to be run in a particular way to work with at-spi2 as I'll mention later.  You'll also need at-spi2-core and at-spi2-atk to test gtk applications.  You'll also need pyatspi2.  The simplest way to get these is to clone them from the following git urls:
+
:''This tutorial will explain some details about using screen readers with KDE applications.''
−
 
+
A screen reader is an application that uses speech synthesis to allow users with visual impairments to use a computer.
−
git://git.gnome.org/at-spi2-core
 
−
git://git.gnome.org/at-spi2-atk
 
−
git://git.gnome.org/pyatspi2
 
−
 
 
−
Then proceed to build them by running
 
−
 
 
−
./autogen.sh --disable-relocate
 
−
make
 
−
make install
 
−
(or sudo make install if your user doesn't have write privileges to /usr/local)
 
−
 
 
−
=== How to test at-spi2 with gtk ===
 
−
Once these are installed, you can then test at-spi2 by running gcalctool with a few environment variables set.  As mentioned on the [http://a11y.org/dbus at-spi dbus site] under "Instructions for Testing" you'll need some environment variables set.  I use a file called ~/.a11ybashrc with the following contents:
 
−
 
 
−
export GTK_PATH=/usr/local/lib/gtk-2.0/
 
−
export PYTHONPATH=/usr/local/lib/python2.6/site-packages/
 
−
export QT_ACCESSIBILITY=1
 
−
export GTK_MODULES=gail:atk-bridge
 
−
 
 
−
then I just source ~/.a11ybashrc to set up my shell for testing accessibility.
 
−
 
 
−
Then to test just run gcalctool with gcalctool & from that shell.  You should see at-spi2-registryd in your process table once gcalctool has started.  If not you are likely still using at-spi instead of at-spi2.  You can use d-feet or qdbusviewer, or just qdbus to inspect the dbus interface of the registry and the accessible methods of the application at this point.  You should also be able to run orca and hear the text of the calculator tool at this point.
 
−
 
 
−
==== How to test at-spi2 with Qt ====
 
−
Once you have a gtk app running correctly with orca and/or accerciser you are ready to try qt-at-spi. In order to do so, just clone the repo from
 
−
git://gitorious.org/qt-at-spi
 
−
Then run
 
−
qmake
 
−
make
 
−
make install
 
−
 
 
−
There is a handy calculator in qt-at-spi under the test folder that can be used to test qt's at-spi plugin with.  Make sure QT_ACCESSIBILITY is set in your environment and run
 
−
test/test
 
−
from the source folder of qt-at-spi.  You should see some console message about the bridge initializing.  You'll also see the calculator's dbus path in the org.a11y.atspi.Registry GetChildren output.
 
−
 
 
−
== KAccessible ==
 
−
 
 
−
[http://websvn.kde.org/trunk/KDE/kdeaccessibility/kaccessible/ kaccessible] implements a QAccessibleBridgePlugin to provide accessibility services like focus tracking and a screenreader.
 
−
 
 
−
You need to call "export QT_ACCESSIBILITY=1" before you start the application that should be made accessible. Then a kaccessible icon should display in the icon system tray. Once running focus tracking in kmagnifier and KWin's zooming plugin are following the focus from now on.
 
  
 
== Jovie ==
 
== Jovie ==
 +
[http://websvn.kde.org/trunk/KDE/kdeaccessibility/jovie/ Jovie] is a subsystem within the KDE desktop for conversion of text to audible speech.
  
−
[http://websvn.kde.org/trunk/KDE/kdeaccessibility/jovie/ Jovie] is a subsystem within the KDE desktop for conversion of text to audible speech.
+
;[[Development/Tutorials/Text-To-Speech|Text-To-Speech]]
 +
:''How to utilize Jovie text-to-speech service in your application.''
  
−
See also the [http://techbase.kde.org/Development/Tutorials/Text-To-Speech Text-To-Speech tutorial].
 
  
 
== Simon ==
 
== Simon ==
  
−
[http://simon-listens.org/ Simon] is an open-source speech recognition program and replaces the mouse and keyboard.
+
[http://simon.kde.org Simon] is an open-source speech recognition program and replaces the mouse and keyboard.

Latest revision as of 12:22, 30 May 2019


This page has been archived
The information on this page is outdated or no longer in use but is kept for historical purposes. Please see the Category:Archives for similar pages.
Dialog-information.png
Information
The KDE Accessibility Project is now located at the KDE Community Wiki.


Introduction

Below is a list of tutorials for KDE accessibility improvements.

Screen Reader

Accessibility Documentation for Users on userbase.kde.org
Explains how to get started with screen readers as a user.
Accessibility Checklist
What to look for in your application to make it accessible for as many people as possible.
Screen Reader
This tutorial will explain some details about using screen readers with KDE applications.

A screen reader is an application that uses speech synthesis to allow users with visual impairments to use a computer.

Jovie

Jovie is a subsystem within the KDE desktop for conversion of text to audible speech.

Text-To-Speech
How to utilize Jovie text-to-speech service in your application.


Simon

Simon is an open-source speech recognition program and replaces the mouse and keyboard.

Retrieved from "https://techbase.kde.org/index.php?title=Development/Tutorials/Accessibility&oldid=102352"

This page was last edited on 30 May 2019, at 12:22. Content is available under Creative Commons License SA 4.0 unless otherwise noted.