[accessibility-guide] More updates from Kendell Clark
Ben Cotton
bcotton at fedoraproject.org
Wed Apr 8 02:27:26 UTC 2015
commit 68af1eb2d4dd0e398e5eef05b3208df7be93e9ff
Author: Ben Cotton <bcotton at fedoraproject.org>
Date: Tue Apr 7 22:27:16 2015 -0400
More updates from Kendell Clark
en-US/Screen_Readers.xml | 123 ++++++++++++++++++++++++++++++++++++++++++++--
1 files changed, 118 insertions(+), 5 deletions(-)
---
diff --git a/en-US/Screen_Readers.xml b/en-US/Screen_Readers.xml
index 92f90cd..b41f51b 100644
--- a/en-US/Screen_Readers.xml
+++ b/en-US/Screen_Readers.xml
@@ -6,10 +6,111 @@
<para>Screen readers are important accessibility tools that allow a person with limited vision to have the computer read what is on the screen. There are numerous solutions that provide this service. This section covers some of the ones available to Fedora users.</para>
<section id="Orca">
<title>Orca for GNOME</title>
- <para>GNOME supplies its own screen reader, <package>Orca</package>. This package is installed by default on all Fedora systems. Additional information on <package>Orca</package> may be found by visiting <ulink url="http://live.gnome.org/Orca/"></ulink>.</para>
- <para>To enable <package>Orca</package> you may run <command>orca</command> from the command line. This first time you will be asked a number of preference questions. After the initial configuration, run <command>orca</command> a second time to start <application>orca</application>. The graphical application which starts has options for changing the preferences, quitting the program, and obtaining help. During the initial setup, the questions are also said allow as they are displayed in the terminal. </para>
- <para>Alternately, from the graphical menus select <menuchoice><guilabel>System > Preferences > Assistive Technologies</guilabel></menuchoice> and check the box labeled "Enable Assistive Technologies" then click <guilabel>Preferred Applications</guilabel> to ensure that either <application>Orca</application> or <application>Orca and Magnifier</application> is selected.</para>
- </section>
+ <para>GNOME supplies its own screen reader,
+ <application>Orca</application>. This package is installed
+ by default on all Fedora systems. Additional information
+ on <application>Orca</application> may be found by visiting
+ <ulink url="http://live.gnome.org/Orca/"></ulink>.</para>
+
+ <para>To enable <application>Orca</application>, press
+ <keycombo><keycap> Alt</keycap><keycap>Super</keycap>
+ <keycap>S</keycap></keycombo>. You will shortly hear
+ "screen reader on." <application>Orca</application> will
+ start from then on until it is disabled with <keycombo>
+ <keycap>Alt</keycap><keycap>Super</keycap><keycap>S</keycap>
+ </keycombo>. After disabling <application>Orca</application>,
+ you will hear "screen reader off."</para>
+
+ <para><application>Orca</application> can be launched
+ manually by pressing <keycombo><keycap>Alt</keycap>
+ <keycap>F2</keycap></keycombo> to open the run dialog
+ and typing <command>orca</command>. Similarly,
+ <application>Orca</application> can be launched from a
+ terminal window with the <command>orca</command>
+ command.</para>
+
+ <para>You can set various settings of <application>Orca
+ </application> such as the speech synthesizer, rate,
+ pitch, voice, volume, punctuation level, verbosity, and
+ so on by accessing
+ <application>Orca</application>'s preferences. This can
+ be done from anywhere while
+ <application>Orca</application> is running by pressing
+ the "orca" key plus the space bar. If you are using the
+ desktop layout (the default) this is either the
+ <keycap>insert</keycap> key on your keyboard, which is
+ normally to the left of the <keycap>home</keycap> key,
+ or the numpad <keycap>insert</keycap> key, which is at
+ the bottom of the number pad. If you are using the laptop
+ keyboard layout, the “orca” key is the <keycap>caps
+ lock</keycap> key, which is just above
+ <keycap>shift</keycap> on most keyboards. You can change
+ the keyboard layout by accessing
+ <application>Orca</application>'s preferences and
+ tabbing to the <guilabel>Keyboard Layout</guilabel>
+ combo box on the <guilabel>General</guilabel> tab, which
+ is the default tab opened when the preferences are opened.
+ If you need more help on <application>Orca</application>,
+ press the <guibutton>help</guibutton> button in
+ <application>Orca</application>'s preferences
+ to access the <application>Orca</application> manual in
+ <application>Yelp</application>, the GNOME help
+ application.</para>
+
+ <note id="Orca_in_mate">
+ <title>Enabling Orca in MATE</title>
+ <para>If You are using the MATE spin of Fedora,
+ press <keycombo><keycap>Alt</keycap>
+ <keycap>Super</keycap><keycap>S</keycap>
+ </keycombo>. You will shortly hear "screen reader
+ on." Go to <menuchoice><guimenu>System</guimenu>
+ <guisubmenu>Preferences</guisubmenu>
+ <guimenuitem>Assistive technologies</guimenuitem>
+ </menuchoice> and check the box labeled
+ <guilabel>Enable assistive technologies.</guilabel>
+ Be sure to press the <guibutton>Preferred
+ applications</guibutton> button and make sure
+ <application>Orca</application> is set to launch
+ at startup.</para>
+ </note>
+
+ <para>Should <application>Orca</application> crash or
+ become unresponsive, it can be restarted either by
+ toggling <application>Orca</application> off then on
+ again, or by opening the run dialog and typing
+ <command>orca -replace</command>.</para>
+
+ <section id="Orca-Karet_navigation">
+ <title>Karet navigation</title>
+
+ <para> For many GNOME applications that display
+ web content, such as the GNOME web browser, the
+ <application>Evince</application> document
+ reader, and the GNOME help application, you
+ cannot read content with
+ <application>Orca</application> until the system
+ karet is enabled. This is a blinking cursor
+ that follows your progress as you scroll through
+ the text with the arrow keys.</para>
+
+ <para>To enable karet navigation, press the
+ <keycap>F7</keycap> key. You will be asked if
+ you wish to enable karet navigation, followed
+ by a <guilabel>do not ask me again<guilabel>
+ option which makes the selection permanent. This
+ need only be done once. After enabling karet
+ navigation, <application>Orca</application>
+ can be used to read the contents of those
+ applications. This is not required in most
+ other applications. However, if
+ <application>Orca</application> is ever unable
+ to read the contents of an application which
+ contains text content, such as a web browser or
+ text editor, try pressing <keycap>F7</keycap> to
+ see if it is turned off.</para>
+ </section>
+ </section>
+
<section id="Jovie">
<title>Jovie for KDE</title>
<para><package>Jovie</package> is the KDE system for Text-to-Speech, previously known as ktts. <package>Jovie</package> consists of a Text-to-Speech Daemon, a <application>Konqueror</application> plugin, and an extension for the <application>Kate</application> text editor. The Daemon provides text-to-speech functionality to applications, such as <application>KMouth</application> and <application>KNotify</application>, via D-Bus. It also provides an icon from the system tray, for additional features. From this tray icon, <package>Jovie</package> can speak the contents of a text file, speak the contents of the clipboard, and access the control module for configuration. Comprehensive information on jovie can be found on the KDE website: <ulink url="http://docs.kde.org/stable/en/kdeaccessibility/jovie/index.html"></ulink></para>
@@ -18,7 +119,19 @@
<section id="Emacspeak">
<title>Using Emacspeak with Fedora</title>
<para><application>Emacspeak</application> is a speech interface that allows visually impaired users to interact independently and efficiently with the computer. <application>Emacspeak</application> has dramatically changed how hundreds of blind and visually impaired users around the world interact with the personal computer and the Internet. A rich suite of task-oriented speech-enabled tools provides efficient speech-enabled access to the evolving semantic world wide web. When combined with Linux running on low-cost PC hardware, <application>Emacspeak</application> provides a reliable, stable speech-friendly solution that opens up the Internet to visually impaired users around the world.</para>
- <para>Before using <application>Emacspeak</application>, you should familiarize yourself with some documentation. Start with <citetitle>A Gentle Introduction to Emacspeak</citetitle> by Gary Lawrence Murphy, which is available online at <ulink url="http://tldp.org/LDP/espk-ug/html/index.html"></ulink></para>
+ <para><application>Emacspeak</application> is not
+ installed on Fedora by default. To install it, open a
+ terminal and run <command>dnf install emacspeak</command>
+ as root. Once this is complete you can launch
+ <application>Emacspeak</application> by typing
+ <command>emacspeak</command> in a terminal. If all is
+ working properly, you should hear
+ <application>Emacspeak</application> report "welcome to
+ emacspeak. I am completely operational, and all my
+ circuits are functioning perfectly!"</para>
+
+ <para>Before using <application>Emacspeak</application>,
+ you should familiarize yourself with some documentation. Start with <citetitle>A Gentle Introduction to Emacspeak</citetitle> by Gary Lawrence Murphy, which is available online at <ulink url="http://tldp.org/LDP/espk-ug/html/index.html"></ulink></para>
<!-- Temporarily removing this text as it has been deemed to be inaccurate.
added back with fix for mail -->
<para>The <citetitle>Emacspeak HOWTO</citetitle> written by Jim Van Zandt is also a very good resource, although the document is limited to the Slackware distribution. The Emascspeak HOWTO is available online at: <ulink url="http://slackware.osuosl.org/slackware-3.3/docs/Emacspeak-HOWTO"></ulink></para>
More information about the docs-commits
mailing list