Accessibility: Difference between revisions

Latest revision as of 02:14, 11 August 2024

KDE Accessibility Project

Welcome to the home page of the KDE Accessibility Project.

Quickstart

E.g. in Kubuntu 22.10:

sudo apt install kcalc accerciser
# As per https://www.freedesktop.org/wiki/Accessibility/AT-SPI2/
export QT_ACCESSIBILITY=1
# Or export QT_LINUX_ACCESSIBILITY_ALWAYS_ON=1
kcalc &
accerciser &

The application accerciser has the title Accerciser Accessibility Explorer. kcalc should appear in the application accerciser, in the left hand side tree view. If kcalc does not appear, from the accerciser application's main menu > View > Refresh Registry.

Accessibility applications

Technical Information For Application Developers

Read the KDE Human Interface Guidelines https://develop.kde.org/hig/accessibility/

Community Documentation

https://www.freedesktop.org/wiki/Accessibility/AT-SPI2/
Also ask on the IRC channel #kde-accessibility on Libera Chat or #kde-accessibility on Matrix https://webchat.kde.org/#/room/#kde-accessibility:kde.org
https://help.gnome.org/users/accerciser/stable/index.html https://gitlab.gnome.org/GNOME/accerciser
https://apachelog.wordpress.com/2022/12/14/selenium-at-spi-gui-testing/ https://invent.kde.org/sdk/selenium-webdriver-at-spi

Resources from GTK and GNOME that can be useful for understanding accessibility for desktop apps:

@@ Line 1: / Line 1: @@
+[[File:Mascot konqi-app-system.png|thumbnail|right|Help [[Konqi]] improve KDE's accessibility!]]
 == KDE Accessibility Project ==
 Welcome to the home page of the KDE Accessibility Project.
-=== User Documentation ===
+== Quickstart ==
-You can find user documentation on UserBase:
+E.g. in Kubuntu 22.10:
-* https://userbase.kde.org/Applications/Accessibility
+{{Input|1=<nowiki>
-* https://userbase.kde.org/KMag
+sudo apt install kcalc accerciser
-* https://userbase.kde.org/KMouseTool
+# As per https://www.freedesktop.org/wiki/Accessibility/AT-SPI2/
-* https://userbase.kde.org/KMouth
+export QT_ACCESSIBILITY=1
-* https://userbase.kde.org/Jovie
+# Or export QT_LINUX_ACCESSIBILITY_ALWAYS_ON=1
-* https://userbase.kde.org/System_Settings/Accessibility
+kcalc &
-* https://userbase.kde.org/Simon (not part of the KDE Accessibility module)
+accerciser &
+</nowiki>}}
-=== Application Pages ===
+The application accerciser has the title Accerciser Accessibility Explorer.
+kcalc should appear in the application accerciser, in the left hand side tree view.
+If kcalc does not appear, from the accerciser application's main menu > View > Refresh Registry.
-You can find some details on individual Accessibility apps on the application pages.
+== Accessibility applications ==
-* https://www.kde.org/applications/utilities/kmag/
+* https://apps.kde.org/categories/utilities/#accessibility
-* https://www.kde.org/applications/utilities/kmousetool/
+* https://apps.kde.org/kmag
-* https://www.kde.org/applications/utilities/kmouth/
+* https://apps.kde.org/kmousetool
-* https://www.kde.org/applications/utilities/jovie/
+* https://apps.kde.org/kmouth
-* https://simon.kde.org/
+* https://userbase.kde.org/System_Settings/Accessibility
-=== Technical Information For Application Developers ===
-For technical information on how to make your application accessible please see the following TechBase pages:
+== Technical Information For Application Developers ==
-* http://techbase.kde.org/Development/Tutorials/Accessibility
+Read the KDE Human Interface Guidelines https://develop.kde.org/hig/accessibility/
-* http://techbase.kde.org/Development/Tutorials/Text-To-Speech
-* http://techbase.kde.org/Development/Guidelines/HCI/Checklists
-=== Community Documentation ===
+== Community Documentation ==
-* http://labs.qt.nokia.com/2011/08/23/accessibility-on-linux/
+* https://www.freedesktop.org/wiki/Accessibility/AT-SPI2/
-* http://blog.qt.digia.com/blog/2012/06/18/qt-5-accessibility-apis/
+* Also ask on the IRC channel #kde-accessibility on [https://libera.chat Libera Chat] or #kde-accessibility on Matrix https://webchat.kde.org/#/room/#kde-accessibility:kde.org
-* see also: [[Accessibility/qt-atspi|Qt AT-SPI 2 Bridge]]
+* https://help.gnome.org/users/accerciser/stable/index.html https://gitlab.gnome.org/GNOME/accerciser
-* Also ask on [irc://irc.freenode.net/#kde-accessibility #kde-accessibility] on [http://freenode.net Freenode]
+* https://apachelog.wordpress.com/2022/12/14/selenium-at-spi-gui-testing/ https://invent.kde.org/sdk/selenium-webdriver-at-spi
-=== Historic ===
+Resources from GTK and GNOME that can be useful for understanding accessibility for desktop apps:
-Most of the above content is historic too as it's still about kdelibs4 and Qt4 based software. We're currently in the process of porting this software to KDE Frameworks 5 and Qt5.
+* [https://docs.gtk.org/gtk4/section-accessibility.html GTK Accessibility Entrypoint Documentation]
-The old KDE3 Accessibility site is available at [http://accessibility.kde.org/ accessibility.kde.org]
+* [https://wiki.gnome.org/Accessibility/GetInvolved/QuickStart GNOME Accessibility Quick Start Guide]
+* [https://mairin.wordpress.com/2010/02/23/painless-accessibility-tips-for-gnome-designers-and-developers/ Painless Accessibility Tips for GNOME Designers and Developers]
+* [https://wiki.gnome.org/Projects/GTK/Accessibility Status of Accessibility in GNOME]
+* [https://developer.gnome.org/documentation/guidelines/accessibility.html GNOME Accessibility Guidelines]
+* [https://developer.gnome.org/documentation/guidelines/accessibility/coding-guidelines.html GNOME Coding Guidelines to Support Accessibility]