diff options
Diffstat (limited to 'doc/kword/a11y.docbook')
| -rw-r--r-- | doc/kword/a11y.docbook | 365 |
1 files changed, 365 insertions, 0 deletions
diff --git a/doc/kword/a11y.docbook b/doc/kword/a11y.docbook new file mode 100644 index 00000000..bcf95101 --- /dev/null +++ b/doc/kword/a11y.docbook @@ -0,0 +1,365 @@ +<chapter id="a11y"> +<chapterinfo> +<authorgroup> +<author> +<firstname>Gary</firstname> +<surname>Cramblitt</surname> +</author> +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> +</chapterinfo> + +<title>For Users with Disabilities</title> +<para>This section of the documentation discusses accessibility features in &kword; +for users with disabilities. Some of these features apply to &kde; as a whole and are controlled from +<ulink url="help:kcontrol">&kcontrolcenter;</ulink>. Some apply to all &koffice; applications, +and some are specific to &kword;.</para> + +<sect1 id="a11y-install"> +<title>Installing the <command>kdeaccessibility</command> Module</title> +<indexterm><primary>kdeaccessibility</primary></indexterm> +<para> +Most of the features described in this chapter are enabled by installing the +<command>kdeaccessibility</command> module. +The <command>kdeaccessibility</command> module is part of the &kde; project +<ulink url="http://www.kde.org">http://www.kde.org</ulink>. The <command>kdeaccessibility</command> +package can be obtained from &kde-ftp;, the +main ftp site of the &kde; project. +</para> + +<para>Many distributions offer precompiled binaries on their ftp sites. Please check your distribution's web sites for more information.</para> + +<para>More information about &kde; accessibility can be obtained by +visiting <ulink url="http://accessibility.kde.org/">http://accessibility.kde.org/</ulink>. +</para> +</sect1> + +<sect1 id="a11y-sight"> +<title>Visual Impairments</title> +<indexterm><primary>Visual Impairments</primary></indexterm> + +<note><para>&kword; is not usable by totally blind users. It is hoped that +a general screen reader for the blind will be available in future versions of &kde;. +</para></note> + +<sect2 id="a11y-theming"> +<title>Theming</title> +<indexterm><primary>Theming</primary></indexterm> +<para>For low-sighted or light allergic users, several features are available in the &kcontrolcenter; +<menuchoice><guimenu>Appearance & Themes</guimenu><guimenuitem>Theme Manager</guimenuitem></menuchoice>, +like high contrast color themes. If you are light allergic, the +<guilabel>HighContrastDark</guilabel> or <guilabel>HighContrastLight</guilabel> themes +may be helpful. If you have difficulty reading small fonts or seeing small icons, the +<guilabel>HighContrastDark-big</guilabel> or <guilabel>HighContrastLight-big</guilabel> +themes will increase the size of text, buttons, and icons. You may also customize +background, colors, fonts, and icons from the same dialog. A set of monochrome icons +is available. +</para> + +<tip><para>If you choose one of the <guilabel>Big</guilabel> themes, you may discover that +some windows are too large to fit your monitor. Purchasing a larger monitor will be helpful. +You can drag the portions of the window not visible into the visible area by +holding down the &Alt; key and dragging with the &LMB; anywhere +within the screen. If you have trouble operating a mouse, you can also move screens by pressing +<keycombo action="simul">&Alt;<keycap>F3</keycap></keycombo>. In +the dropdown Windows Operations Menu, choose +<menuchoice><guimenuitem>Move</guimenuitem></menuchoice>. +Move the screen with the arrow keys and press &Esc; to finish the move. +</para></tip> + +</sect2> + +<sect2 id="a11y-kmagnifier"> +<title>&kmagnifier;</title> +<indexterm><primary>magnifier</primary></indexterm> +<para>The <command>kdeaccessibility</command> module includes a screen magnifier +application called <ulink url="help:kmag">&kmagnifier;</ulink>. +If it is installed, you can run it from +<menuchoice><guimenu>K-Button</guimenu><guimenuitem>Utilities</guimenuitem> +<guimenuitem>KMag (Screen Magnifier)</guimenuitem></menuchoice>. +</para> +</sect2> + +<sect2 id="a11y-tts"> +<title>Text-to-Speech</title> +<indexterm><primary>Text-to-Speech</primary></indexterm> +<indexterm><primary>TTS</primary></indexterm> +<para>The <command>kdeaccessibility</command> module includes a Text-to-Speech +component called KTTS. If KTTS is installed, you can configure &kword; to +speak the text that is under the mouse pointer or speak the text of each +screen widget as it receives focus. Before using this feature, first configure +KTTS. See <ulink url="help:kttsd">The KTTS Handbook</ulink> for details. +To turn on the TTS feature in &kword;, +select <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure +&kword;...</guimenuitem></menuchoice> from the menubar. +This will display a dialog box. +Clicking on <guilabel>TTS</guilabel> will allow you to change +the following:</para> + +<screenshot> +<mediaobject> +<imageobject><imagedata fileref="tts.png" format="PNG"/></imageobject> +</mediaobject> +</screenshot> + +<variablelist> +<varlistentry> +<term><guilabel>Speak widget under mouse pointer</guilabel></term> +<listitem><para>When checked, &kword; will speak the text of each widget +as the mouse pointer moves over the widget.</para> +</listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Speak widget with focus</guilabel></term> +<listitem><para>When checked, &kword; will speak the text of each widget +as it receives focus.</para> +</listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Speak tool tips</guilabel></term> +<listitem><para>When checked, &kword; will speak the popup tool tip +for each widget in addition to the text of the widget.</para> +</listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Speak What's This</guilabel></term> +<listitem><para>When checked, &kword; will speak the What's This help +for each widget in addition to the text of the widget.</para> +</listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Say whether disabled</guilabel></term> +<listitem><para>When checked, &kword; will speak the word "disabled" +if the widget is currently disabled (grayed).</para> +</listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Speak accelerators</guilabel></term> +<listitem><para>When checked, &kword; will speak the accelerator +of the widget in addition to the text of the widget. +Accelerators are the underlined letters you see in the text of the +widget. For example, in the main menu, the +<menuchoice><guimenuitem>Quit</guimenuitem></menuchoice> menu item +has the "Q" underlined. You can choose it by pressing <keycap>Q</keycap>. +To speak the accelerator, check this option and enter the +word you want to speak before the accelerator in the +<guilabel>Prefaced by the word</guilabel> box. In this +example shown above, &kword; will speak "Accelerator Q".</para> +</listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Polling interval</guilabel></term> +<listitem><para>This option determines how often &kword; will +check for a change in the widget under the mouse pointer or +a new focused widget. You should leave this option on the +default setting.</para> +</listitem> +</varlistentry> +</variablelist> + +<note><para> +If the <guibutton>TTS</guibutton> option does not appear +on this screen, you do not have the KTTS component installed +in your system. +</para></note> + +<note><para>Not all widgets are spoken. For example, +the items on the main menubar are not spoken. The text of the +&kword; document window is also not spoken, but see +<xref linkend="doc-structure"/> for another way to speak the document. +</para></note> + +</sect2> + +</sect1> + +<sect1 id="a11y-motor"> +<title>Motor Impairments and Mouseless Operation</title> +<indexterm><primary>Motor Impairments</primary></indexterm> +<indexterm><primary>Mouseless Operation</primary></indexterm> + +<sect2 id="a11y-kmousetool"> +<title>KMouseTool</title> +<para>If you can operate a mouse, but have trouble clicking, the +<ulink url="help:kmousetool">KMouseTool</ulink> application may help. Run it from +<menuchoice><guimenu>K-Button</guimenu><guimenuitem>Utilities</guimenuitem> +<guimenuitem>KMouseTool (Automatik Mouse Click)</guimenuitem></menuchoice>. +</para> +</sect2> + +<sect2 id="a11y-kbd-xaccess"> +<title>XAccess Features</title> +<indexterm><primary>XAccess</primary></indexterm> +<indexterm><primary>Sticky Keys</primary></indexterm> +<indexterm><primary>Slow Keys</primary></indexterm> +<indexterm><primary>Bounce Keys</primary></indexterm> + +<para>The &kcontrolcenter; offers several keyboard features collectively called XAccess. +They include:</para> +<variablelist> +<varlistentry> +<term><guilabel>Sticky Keys</guilabel></term> +<listitem><para>This feature permits operation of meta keys, such as +&Alt;, &Ctrl;, and &Shift; without having to hold the keys down. It is useful +when you can only use one finger or one hand to operate the keyboard. +With <guilabel>Sticky Keys</guilabel> on, press and release a &Alt;, &Ctrl;, or &Shift; key, then +press another key. The result is as if you pressed both keys at once. +Press the &Alt;, &Ctrl;, or &Shift; key again to turn off the sticky key. +Activate this feature in +<menuchoice><guimenu>K-Button</guimenu><guimenuitem>&kcontrolcenter;</guimenuitem> +<guimenuitem>Regional & Accessibility</guimenuitem><guimenuitem>Accessibility</guimenuitem> +<guimenuitem>Modifier Keys</guimenuitem></menuchoice>.</para> +</listitem> +</varlistentry> +<varlistentry> +<term>Slow Keys</term> +<listitem><para>This feature is useful if you have hand tremors or difficulty +accurately pressing keys. It prevents +inadvertent key presses by requiring that a key be held down for a minimum +time before it is accepted. Activate this feature in +<menuchoice><guimenu>K-Button</guimenu><guimenuitem>&kcontrolcenter;</guimenuitem> +<guimenuitem>Regional & Accessibility</guimenuitem><guimenuitem>Accessibility</guimenuitem> +<guimenuitem>Keyboard Filters</guimenuitem></menuchoice>.</para> +</listitem> +</varlistentry> +<varlistentry> +<term>Bounce Keys</term> +<listitem><para>This feature is also useful if you have hand tremors. It prevents +inadvertent repeated key presses by preventing another keystroke for +a certain amount of time. Activate this feature in +<menuchoice><guimenu>K-Button</guimenu><guimenuitem>&kcontrolcenter;</guimenuitem> +<guimenuitem>Regional & Accessibility</guimenuitem><guimenuitem>Accessibility</guimenuitem> +<guimenuitem>Keyboard Filters</guimenuitem></menuchoice>.</para> +</listitem> +</varlistentry> +</variablelist> + +</sect2> + +<sect2 id="a11y-mouse-emulation"> +<title>Mouse Emulation</title> +<indexterm><primary>Mouse Emulation</primary></indexterm> +<para>Mouse Emulation permits you to move and click the mouse using the keyboard. +Press <keycombo>&Alt;<keycap>F12</keycap></keycombo> to activate it. Use the arrow keys +to move the mouse pointer to the desired location, and press <keycap>spacebar</keycap> +to "click" the mouse. Unfortunately, you cannot use Mouse Emulation to perform +&RMB; clicks or dragging. +</para> +</sect2> + +<sect2 id="a11y-mouse-navigation"> +<title>Mouse Navigation</title> +<indexterm><primary>Mouse Navigation</primary></indexterm> +<para>This feature permits you to emulate the mouse using the numeric keypad +of your keyboard. To activate it, go to +<menuchoice><guimenu>K-Button</guimenu><guimenuitem>&kcontrolcenter;</guimenuitem> +<guimenuitem>Peripherals</guimenuitem><guimenuitem>Mouse</guimenuitem> +<guimenuitem>Mouse Navigation</guimenuitem></menuchoice>. +Check the <guilabel>Move pointer with keyboard (using the num pad)</guilabel> box. When you do this, the other settings will become enabled, and you can customize the keyboard pointer behavior further, if required. + The various keys on the number pad move in the direction you would expect. Note that you can move diagonally as well as up, down, left and right. The <keycap>5</keycap> key emulates a click to a pointer button, typically &LMB;. You change which button is emulated by using the <keycap>/</keycap> key (which makes it &LMB;), +<keycap>*</keycap> key (which makes it middle mouse button) and <keycap>-</keycap> (which makes it &RMB;). + Using the <keycap>+</keycap> emulates a doubleclick to the selected pointer button. You can use the +<keycap>0</keycap> key to emulate holding down the selected pointer button (for easy dragging), +and then use the <keycap>.</keycap> to emulate releasing the selected pointer button. +</para> + +<screenshot> +<mediaobject> +<imageobject><imagedata fileref="mousenav.png" format="PNG"/></imageobject> +</mediaobject> +</screenshot> + +</sect2> + +<sect2 id="a11y-motor-shortcuts"> +<title>Keyboard shortcuts</title> + +<para>&kword; has a number of keyboard shortcuts that will be useful +to users who cannot operate a mouse. See <xref linkend="keys"/> for +details. In addition, the following tips will be useful: +</para> + +<orderedlist> +<listitem><para> +Several of the functions that can only be performed with the mouse in the +main document panel can be performed with the keyboard in the +<guilabel>Document Structure</guilabel> area. See <xref linkend="doc-structure"/>. +You can switch from the document panel +to the <guilabel>Document Structure</guilabel> area by pressing <keycombo action="simul"> +&Alt;<keycap>1</keycap></keycombo>. Switch to the +document panel by pressing +<keycombo action="simul">&Alt;<keycap>2</keycap></keycombo>. +</para></listitem> +<listitem><para>Use the <keycap>Menu</keycap> key to pop up the context +menu. On most keyboards, the <keycap>Menu</keycap> key is on the righthand +side of the keyboard between the <keycap>&Windows;</keycap> and &Ctrl; +keys. It has a menu icon on it. +</para></listitem> +<listitem><para> +When inserting a new frame into the document, you can insert the frame +at the current position of the text caret, instead of positioning it with +the mouse. Just press <keycap>&Enter;</keycap> when the crosshairs appear. You can resize +the new frame or change its position by changing the numbers in the +<guilabel>Connect Frame</guilabel> dialog. See +<xref linkend="add-text-frame"/> for details. +</para></listitem> +<listitem><para> +In order to change the properties of a frame or delete a frame, you must first select it. +To do so without using the mouse, position the text caret anywhere inside the frame and +choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Select Frame</guimenuitem></menuchoice> +from the main menubar. Alternatively, press <keycombo action="simul">&Alt;<keycap>1</keycap></keycombo> to +go to the <guilabel>Document Structure</guilabel> area, +scroll to the desired frame, press the <keycap>Menu</keycap> key to pop up the context +menu and choose +<menuchoice><guimenuitem>Properties</guimenuitem></menuchoice> +or <menuchoice><guimenuitem>Delete Frame</guimenuitem></menuchoice>. +</para></listitem> +<listitem><para>You cannot use the arrow keys to move the text caret into some +frames within the document panel. To move the caret inside the frame, +press <keycombo action="simul">&Alt;<keycap>1</keycap></keycombo> to +go to the <guilabel>Document Structure</guilabel> area, +scroll to the desired frame, press the <keycap>Menu</keycap> key to pop up the context +menu and choose <menuchoice><guimenuitem>Edit Text</guimenuitem></menuchoice>. +</para></listitem> +</orderedlist> + +</sect2> + +<sect2 id="a11y-motor-panel-sizing"> +<title>Resizing panels</title> + +<para>You can move the sizing bar between the <guilabel>Document Structure</guilabel> area +and the main document panel by pressing <keycap>F8</keycap>. A sizing icon appears +overtop the sizing bar. Use the arrow keys to move the bar left or right. +Press <keycap>F8</keycap> again or &Esc; when finished sizing. +</para> + +</sect2> + +<sect2 id="a11y-motor-moving-focus"> +<title>Setting focus to widgets</title> + +<para>Normally, one can use the 	 and <keycombo action="simul">&Shift;	</keycombo> +to move focus from one widget to the next in any application. However, when focus is on +the main document in &kword;, pressing 	 does not move the focus; instead it inserts +a tabulator into the document. You can set focus to any widget that can receive focus by +pressing <keycombo action="simul">&Alt;<keycap>F8</keycap></keycombo>. A small lettered box appears +overtop each widget on the screen that can receive focus. +</para> + +<screenshot> +<mediaobject> +<imageobject><imagedata fileref="kbd-focus-ext.png" format="PNG"/></imageobject> +</mediaobject> +</screenshot> + +<para>Press the letter to move focus to the corresponding widget. Press +<keycombo action="simul">&Alt;<keycap>F8</keycap></keycombo> again or &Esc; +to abandon moving the focus. +</para> + +</sect2> + +</sect1> + +</chapter> |