Accessibility/Getting Started: Difference between revisions

    From KDE UserBase Wiki
    No edit summary
     
    (8 intermediate revisions by 4 users not shown)
    Line 1: Line 1:
    == Prerequisits ==
    {{Note|This page has old content. See page history.}}
    * Working at-spi 2 (DBus at-spi)
     
    * Either build Qt 4.8 yourself (see below) or find distribution packages.
    == Prerequisites ==
     
    * Working at-spi 2 (D-Bus at-spi)
     
    * Either build Qt 4.8 yourself (see below) or find distribution packages.


    == Packages ==
    == Packages ==
    For opensuse there is a package
     
    * https://build.opensuse.org/package/show?package=qt-at-spi&project=KDE%3AQt
    For openSUSE there is a [https://build.opensuse.org/package/show?package=qt-at-spi&project=KDE%3AQt package].
     
    Ubuntu ships an outdated version of the plugin in 11.10 which will crash. Expect a better experience in 12.4.
    Ubuntu ships an outdated version of the plugin in 11.10 which will crash. Expect a better experience in 12.4.


    == Getting the Latest Code ==
    == Getting the Latest Code ==
    === Building Qt in your home directory ===
    === Building Qt in your home directory ===
    Only needed when you want to test the latest or your distribution does not have Qt 4.8 packages yet.
    Only needed when you want to test the latest or your distribution does not have Qt 4.8 packages yet.


    If you want to build Qt in you home directory, follow these instructions, otherwise skip to the next section.
    If you want to build Qt in you home directory, follow these instructions, otherwise skip to the next section.
      git clone git://gitorious.org/qt/qt.git ~/qt4
      git clone git://gitorious.org/qt/qt.git ~/qt4
      cd ~/qt4
      cd ~/qt4
    Line 20: Line 28:


    You do not have to make install. The configure options build without Phonon which avoids some problems with KDE applications that ship their own Phonon.
    You do not have to make install. The configure options build without Phonon which avoids some problems with KDE applications that ship their own Phonon.
    After building Qt, you need to export a few variables so that it will be found by applications.
    After building Qt, you need to export a few variables so that it will be found by applications.


    Line 26: Line 35:
      export PATH=$QTDIR/bin:$PATH
      export PATH=$QTDIR/bin:$PATH
      export QT_ACCESSIBILITY=1
      export QT_ACCESSIBILITY=1
    ==== Updating Qt ====
    Once you have Qt built in your home directory, you might want to update it at some point.
    To fetch the latest patches and build them do:
    cd ~/qt4
    git pull
    make -j2


    === Bridge plugin ===
    === Bridge plugin ===
    This is the plugin that makes Qt communicate with AT-SPI via DBus.
     
    This is the plugin that makes Qt communicate with AT-SPI via D-Bus.
     
    Once you have Qt 4.8, building this plugin is easy.
    Once you have Qt 4.8, building this plugin is easy.


    Line 37: Line 55:
      make install
      make install


    You might need to use qmake-qt4 or qmake-4 if you have qmake default to the Qt 3 version.
    You might need to use <code>qmake-qt4</code> or <code>qmake4</code> if you have qmake default to the Qt 3 version. When building with system Qt, you'll have to use <code>sudo</code> to make install.
    When building with system Qt, you'll have to use sudo to make install.
     
    ==== Updating the bridge ====
    To update to the latest version of the bridge:
    cd qt-at-spi
    make
    make install


    === Running KDE/Qt applications ===
    === Running KDE/Qt applications ===
    Before starting an application you will have to set the environment variables as mentioned above if you build your own Qt. Otherwise just set:
    Before starting an application you will have to set the environment variables as mentioned above if you build your own Qt. Otherwise just set:


    Line 46: Line 70:


    Then start the application in the same terminal.
    Then start the application in the same terminal.
    Sometimes it may be interesting to run an application with a different style as the styles can influence behavior, such as how the menu is handled. To start for example KMail with the plastique style, run:
    kmail -style plastique
    Notes for styles:
    * plastique lets you access the menu by pressing the ALT key. You then need to press TAB to go from one menu item to the next. In order to open a menu you need to press the shortcut it reads, such as ALT+f for File.
    * oxygen doesn't react to pressing ALT. It requires to press ALT+f for example. There are configure options that seem to break even this behavior.


    == Status ==
    == Status ==
    Please report problems you encounter on the [[email protected]].
     
    Please report problems you encounter on the [mailto:[email protected] [email protected]].


    === Qt 4.8.0 ===
    === Qt 4.8.0 ===
    * The basics should work, Orca reads focused widgets
     
    * Many text editing widgets do not updated properly when editing or selecting text
    * The basics should work, '''Orca''' reads focused widgets
     
    * Many text editing widgets do not updated properly when editing or selecting text


    === Qt 4.8.1 ===
    === Qt 4.8.1 ===
    You can grab the 4.8 branch from gitorious.
    You can grab the 4.8 branch from gitorious.
    * Better support in text editing widgets
     
    * Better support in text editing widgets


    === Open issues ===
    === Open issues ===
    Line 62: Line 98:


    == For More Information ==
    == For More Information ==
    * [http://labs.qt.nokia.com/category/labs/accessibility/|Qt labs accessibility blog posts]
     
    * [https://mail.kde.org/mailman/listinfo/kde-accessibility|KDE Accessibility mailing list]
    * [http://labs.qt.nokia.com/category/labs/accessibility/ Qt labs accessibility blog posts]
    * [http://userbase.kde.org/Accessibility|Accessibility information for KDE users]
     
    * [http://userbase.kde.org/Accessibility/Application_Overview|Accessibility status of KDE applications]
    * [https://mail.kde.org/mailman/listinfo/kde-accessibility KDE Accessibility mailing list]
     
    * [http://userbase.kde.org/Accessibility Accessibility information for KDE users]
     
    * [http://userbase.kde.org/Accessibility/Application_Overview Accessibility status of KDE applications]
     
    [[Category:Accessibility]]
    [[Category:Needs work]]

    Latest revision as of 08:03, 18 December 2022

    Note

    This page has old content. See page history.


    Prerequisites

    • Working at-spi 2 (D-Bus at-spi)
    • Either build Qt 4.8 yourself (see below) or find distribution packages.

    Packages

    For openSUSE there is a package.

    Ubuntu ships an outdated version of the plugin in 11.10 which will crash. Expect a better experience in 12.4.

    Getting the Latest Code

    Building Qt in your home directory

    Only needed when you want to test the latest or your distribution does not have Qt 4.8 packages yet.

    If you want to build Qt in you home directory, follow these instructions, otherwise skip to the next section.

    git clone git://gitorious.org/qt/qt.git ~/qt4
    cd ~/qt4
    git checkout 4.8
    ./configure -confirm-license -opensource -no-phonon -debug -no-webkit -fast
    make -j2
    

    You do not have to make install. The configure options build without Phonon which avoids some problems with KDE applications that ship their own Phonon.

    After building Qt, you need to export a few variables so that it will be found by applications.

    export QTDIR="~/qt4"
    export LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH
    export PATH=$QTDIR/bin:$PATH
    export QT_ACCESSIBILITY=1
    

    Updating Qt

    Once you have Qt built in your home directory, you might want to update it at some point. To fetch the latest patches and build them do:

    cd ~/qt4
    git pull
    make -j2
    

    Bridge plugin

    This is the plugin that makes Qt communicate with AT-SPI via D-Bus.

    Once you have Qt 4.8, building this plugin is easy.

    git clone git://gitorious.org/qt-at-spi/qt-at-spi.git
    cd qt-at-spi
    qmake
    make
    make install
    

    You might need to use qmake-qt4 or qmake4 if you have qmake default to the Qt 3 version. When building with system Qt, you'll have to use sudo to make install.

    Updating the bridge

    To update to the latest version of the bridge:

    cd qt-at-spi
    make
    make install
    

    Running KDE/Qt applications

    Before starting an application you will have to set the environment variables as mentioned above if you build your own Qt. Otherwise just set:

    export QT_ACCESSIBILITY=1
    

    Then start the application in the same terminal.

    Sometimes it may be interesting to run an application with a different style as the styles can influence behavior, such as how the menu is handled. To start for example KMail with the plastique style, run:

    kmail -style plastique
    

    Notes for styles:

    • plastique lets you access the menu by pressing the ALT key. You then need to press TAB to go from one menu item to the next. In order to open a menu you need to press the shortcut it reads, such as ALT+f for File.
    • oxygen doesn't react to pressing ALT. It requires to press ALT+f for example. There are configure options that seem to break even this behavior.

    Status

    Please report problems you encounter on the [email protected].

    Qt 4.8.0

    • The basics should work, Orca reads focused widgets
    • Many text editing widgets do not updated properly when editing or selecting text

    Qt 4.8.1

    You can grab the 4.8 branch from gitorious.

    • Better support in text editing widgets

    Open issues

    For More Information