<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" 
	"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % globalent SYSTEM "../../../libs/global.ent">
%globalent;
<!ENTITY % cdo-C SYSTEM "../../../libs/cdo-C.ent">
%cdo-C;
<!ENTITY % gnome-menus-C SYSTEM "../../../ubuntu/libs/gnome-menus-C.ent">
%gnome-menus-C;
<!ENTITY % xinclude SYSTEM "../../../libs/xinclude.mod">
%xinclude;
<!ENTITY language "en">
<!ENTITY ubuntu '<phrase>Ubuntu</phrase>'>
]>
<article id="accessibility" status="draft">
	<articleinfo>
	<title>Using Accessibility Tools</title>
    	&legalnotice;
	</articleinfo>
	<para>This section describes how to enable and use the accessibility tools which are included with Ubuntu.</para>

<sect1 id="enabling-accessibility" status="writing">
	<title>Enabling accessibility tools</title>
	<para>You must enable the assistive technology services before you are able to use many of the accessibility tools available in Ubuntu.</para>
	<procedure>
		<step>
			<para>Press <menuchoice><guimenuitem>System</guimenuitem><guimenuitem>Preferences</guimenuitem><guimenuitem>Accessibility</guimenuitem><guimenuitem>Assistive Technology Preferences</guimenuitem></menuchoice>.</para>
		</step>
		<step>
			<para>Tick <guilabel>Enable assistive technologies</guilabel> and then press <guibutton>Close and Log Out</guibutton>.</para>
		</step>
		<step>
			<para>Log back in to Ubuntu. The assistive technology services will be started automatically.</para>
		</step>
	</procedure>
	<para>Once basic assistive technology support is enabled, it is possible to start accessibility services such as the screenreader, screen magnifier and on-screen keyboard.</para>
</sect1>

<sect1 id="screenreader" status="writing">
	<title>Screenreader</title>
	<para>A <emphasis>screenreader</emphasis> reads the text on the screen, such as the label on the currently-selected button.</para>
	<para>To enable the screenreader:</para>
	<procedure>
		<step>
			<para>Ensure that assistive technology support is enabled (see <ulink type='help' url="ghelp:enabling-accessibility">Enabling accessibility tools</ulink>).</para>
		</step>
		<step>
			<para>Press <menuchoice><guimenuitem>System</guimenuitem><guimenuitem>Preferences</guimenuitem><guimenuitem>Accessibility</guimenuitem><guimenuitem>Assistive Technology Preferences</guimenuitem></menuchoice>.</para>
		</step>
		<step>
			<para>Under <guilabel>Screenreader and magnifier</guilabel>, tick <guilabel>Start screenreader and magnifier at log in</guilabel>.</para>
		</step>
		<step>
			<para>Press <guibutton>Start</guibutton> to start the screenreader immediately.</para>
		</step>
	</procedure>
	<!--Experimental 
	
	<bibliolist>
		<title>Additional Information</title>
		<biblioentry><para><ulink url=''>Screencast: Enabling the screenreader</ulink></para></biblioentry>
		<biblioentry><para><ulink url=''>Screenshot of the Assistive Technology Preferences dialog</ulink></para></biblioentry>
		<biblioentry><para><ulink url=''>Walkthrough of the screenreader preferences</ulink></para></biblioentry>
	</bibliolist> -->
	
</sect1>

<sect1 id="magnifier" status="writing">
	<title>Screen magnifier</title>
	<para>A <emphasis>screen magnifier</emphasis> magnifies a section of the screen around the mouse pointer, making it appear larger in another area of the screen.</para>
	
	<procedure>
		<step>
			<para>Ensure that assistive technology support is enabled (see <ulink type='help' url="ghelp:enabling-accessibility">Enabling accessibility tools</ulink>).</para>
		</step>
		<step>
			<para>Press <menuchoice><guimenuitem>System</guimenuitem><guimenuitem>Preferences</guimenuitem><guimenuitem>Accessibility</guimenuitem><guimenuitem>Assistive Technology Preferences</guimenuitem></menuchoice>.</para>
		</step>
		<step>
			<para>Under <guilabel>Screenreader and magnifier</guilabel>, tick <guilabel>Start screenreader and magnifier at log in</guilabel>.</para>
		</step>
		<step>
			<para>Press <guibutton>Settings</guibutton>. The settings window may take a short while to appear.</para>
		</step>
		<step>
			<para>Select the <guilabel>Magnifier</guilabel> tab and tick <guilabel>Enable magnifier</guilabel>.</para>
		</step>
		<step>
			<para>Press <guibutton>Apply</guibutton>. The screen magnifier will be started after a short delay.</para>
		</step>
	</procedure>
</sect1>

<sect1 id="highcontrast" status="writing">
	<title>Using high-contrast desktop themes</title>
	<para>Desktop themes which use high-contrast colors are available. These make many on-screen items easier to see.</para>
	<procedure>
		<step>
			<para>Press <menuchoice><guimenuitem>System</guimenuitem><guimenuitem>Preferences</guimenuitem><guimenuitem>Theme</guimenuitem></menuchoice>.</para>
		</step>
		<step>
			<para>Select <guilabel>High Contrast Inverse</guilabel> or <guilabel>High Contrast Large Print Inverse</guilabel>. The theme will be changed instantly.</para>
		</step>
	</procedure>
	<para>Additional high-contrast themes are available from various sources:</para>
	<itemizedlist>
		<listitem>
			<para>Several additional themes are available from the <application>gnome-accessibility-themes-extras</application> package.</para>
		</listitem>
		<listitem>
			<para>The <ulink url="http://art.gnome.org/themes">GNOME Art website</ulink> has a collection of high-contrast themes available.</para>
		</listitem>
	</itemizedlist>
</sect1>

<sect1 id="largerscreen" status="writing">
	<title>Make on-screen items appear larger</title>
	<para>It is possible to change certain settings so that items on-screen appear larger and so are easier to see.</para>
	<procedure>
		<step>
			<para>Press <menuchoice><guimenuitem>System</guimenuitem><guimenuitem>Preferences</guimenuitem><guimenuitem>Font</guimenuitem></menuchoice>.</para>
		</step>
		<step>
			<para>Press <guibutton>Details...</guibutton> to show the <application>Font Rendering Details</application>.</para>
		</step>
		<step>
			<para>Increase the <guilabel>Resolution</guilabel>. A value of 150-180 dots per inch should appear quite large on most computer screens.</para>
		</step>
		<step>
			<para>Press <guibutton>Close</guibutton> to apply the new resolution, if it has not been applied already.</para>
		</step>
	</procedure>
</sect1>

<sect1 id="onscreenkeyboard" status="writing">
	<title>Typing with an on-screen keyboard</title>
	
	<para></para>
	
	<procedure>
		<step>
			<para>Ensure that assistive technology support is enabled (see <ulink type='help' url="ghelp:enabling-accessibility">Enabling accessibility tools</ulink>).</para>
		</step>
		<step>
			<para>Press <menuchoice><guimenuitem>System</guimenuitem><guimenuitem>Preferences</guimenuitem><guimenuitem>Accessibility</guimenuitem><guimenuitem>Assistive Technology Preferences</guimenuitem></menuchoice>.</para>
		</step>
		<step>
			<para>Under <guilabel>On-screen keyboard</guilabel>, tick <guilabel>Start on-screen keyboard at log in</guilabel>. The on-screen keyboard will start automatically when you next log in.</para>
		</step>
		<step>
			<para>Press <guibutton>Start</guibutton> to start the on-screen keyboard immediately.</para>
		</step>
	</procedure>
</sect1>

<sect1 id="keyboard-accessibility" status="writing">
	<title>Enabling keyboard accessibility features</title>
	<para>There are several ways in which you can modify the behaviour of the keyboard in order to make it easier or more practical to use.</para>
	<procedure>
		<step>
			<para>Press <menuchoice><guimenuitem>System</guimenuitem><guimenuitem>Preferences</guimenuitem><guimenuitem>Accessibility</guimenuitem><guimenuitem>Keyboard Accessibility</guimenuitem></menuchoice>.</para>
		</step>
		<step>
			<para>Tick <guilabel>Enable keyboard accessibility features</guilabel>.</para>
		</step>
		<step>
			<para>Enable the individual features that you would like to use.</para>
		</step>
	</procedure>
	
	<sect2 id="keyboard-accessibility-features" status="writing">
		<title>Available keyboard accessibility features</title>
		<itemizedlist>
			<listitem>
				<para><emphasis role='strong'>Sticky Keys</emphasis> allows you to type keyboard shortcuts by only pressing one key at a time, rather than having to hold down several keys at once. For example, rather than holding down <keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo> to copy some text, you could just press <keycap>Ctrl</keycap> and then <keycap>C</keycap> in sequence.</para>
			</listitem>
			<listitem>
				<para><emphasis role='strong'>Repeat Keys</emphasis> causes several letters to be typed when you hold down a key for a while, rather than just one. It is enabled by default, but people who find that they accidentally type the same letter more than once can adjust the timing or turn off the feature to prevent this problem from occurring.</para>
			</listitem>
			<listitem>
				<para><emphasis role='strong'>Slow Keys</emphasis> will only allow letters you type to appear on the screen if you hold the key down for at least a certain time. This helps to prevent the accidental mis-typing of keys. For example, accidentally brushing against a key should not cause that letter to be typed on the screen.</para>
			</listitem>
			<listitem>
				<para><emphasis role='strong'>Bounce Keys</emphasis> causes duplicate key presses within a certain time to be ignored. For example, if your finger accidentally bounces on a key, the letter will only be typed once.</para>
			</listitem>
			<listitem>
				<para><emphasis role='strong'>Toggle Keys</emphasis> causes the computer to beep when a toggle key on the keyboard is pressed. Toggle keys include <keycap>Caps Lock</keycap>, <keycap>Num Lock</keycap> and <keycap>Scroll Lock</keycap>. The computer will beep once when a toggle key is turned on, and beep twice when it is turned off.</para>
			</listitem>
			<listitem>
				<para><emphasis role='strong'>Mouse Keys</emphasis> allow you to move the mouse pointer by using the numerical keypad on your keyboard, if it has one. For example, pressing the <keycap>8</keycap> button causes the mouse pointer to move up. Mouse keys only works if <keycap>Num Lock</keycap> is turned off on your keyboard.</para>
			</listitem>
		</itemizedlist>
	</sect2>
</sect1>

<sect1 id="texttospeech" status="writing">
	<title>Using text-to-speech tools</title>
	<para>Text-to-speech applications are able to take text and read it to you by using a synthesized voice. <application>Festival</application> is one such application.</para>
	<procedure>
		<step>
			<para>Install the <application>festival</application> and <application>esound-clients</application> packages.</para>
		</step>
		<step>
			<para>Press <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo> and type <userinput>gksudo gedit /etc/festival.scm</userinput>, then press <guibutton>Run</guibutton>.</para>
		</step>
		<step>
			<para>Add the following lines to the end of the file and then press <guibutton>Save</guibutton>:</para>
			<screen>(Parameter.set 'Audio_Command "esdplay $FILE")
(Parameter.set 'Audio_Method 'Audio_Command)
(Parameter.set 'Audio_Required_Format 'snd)</screen>
		</step>
		<step>
			<para>To test the text-to-speech system, press <menuchoice><guimenuitem>Applications</guimenuitem><guimenuitem>Accessories</guimenuitem><guimenuitem>Terminal</guimenuitem></menuchoice>, type <userinput>festival</userinput> and then press <keycap>Return</keycap>.</para>
		</step>
		<step>
			<para>Type <userinput>(SayText "Hello")</userinput> into the <application>Terminal</application> and press <keycap>Return</keycap>. The computer should say <quote>Hello</quote>.</para>
		</step>
	</procedure>
	<para>It is possible to install additional voices for use with <application>Festival</application>. Open the <application>Synaptic Package Manager</application>, search for <userinput>festvox</userinput> and then install a package from the list of results.</para>
</sect1>

</article>

