~vorlon/gnome-user-docs/ubuntu-jaunty

 

<para>

The next steps enable <application>gok</application> (GNOME Onscreen Keyboard). These steps are not necessary for Solaris (which ships with <application>gok</application> already loaded) and target Debian platforms (Ubuntu, etc.). See further down for rpm-based distributions (RedHat, Fedora, etc.).

</para>

<procedure>

<step>

<para>

Choose <menuchoice><guimenuitem>Applications</guimenuitem><guimenuitem>Accessories</guimenuitem><guimenuitem>Terminal</guimenuitem></menuchoice>.

</para>

</step>

<step>

<para>

Enter: <userinput>sudo apt-get install gok</userinput>

</para>

</step>

<step>

<para>

Enter: <userinput>gok</userinput>

</para>

</step>

</procedure>

<para>

If the Sticky Keys feature is not yet enabled, <application>gok</application> will do so the first time it runs.

</para>

<para>

Installing <application>gok</application> for rpm-based systems (specifically, Fedora RedHat):

</para>

<procedure>

<step>

<para>

Download <ulink 

url="http://rpmfind.net/linux/rpm2html/search.php?query=gnome-common">the gok RPM package</ulink>.

</para>

<figure id="enable-gok-fig1">

<title>RPM Search Results</title>

<screenshot>

<mediaobject>

<imageobject>

<imagedata fileref="figures/RPM_search_gnome_common.png" format="PNG"/>

</imageobject>

<textobject>

<phrase>Package listing</phrase>

</textobject>

</mediaobject>

</screenshot>

</figure>

</step>

<step>

<para>

Choose <menuchoice><guimenuitem>Applications</guimenuitem><guimenuitem>Accessories</guimenuitem><guimenuitem>Terminal</guimenuitem></menuchoice>.

</para>

</step>

<step>

<para>

Enter: <userinput>rpm -Uvh your_downloaded_file.rpm</userinput>

</para>

</step>

<step>

<para>

You will need to install several additional files from the RedHat distribution:

</para>

<para>

<userinput>cd /distro_path/redhat-8.0/RedHat/RPMS</userinput>

</para>

<para>

<userinput>rpm -Uvh perl-SGMLSpm-1.03ii-6.noarch.rpm</userinput>

</para>

<para>

<userinput>rpm -Uvh docbook-style-dsssl-1.76-6.noarch.rpm</userinput>

</para>

<para>

<userinput>rpm -Uvh docbook-utils-0.6.11-2.noarch.rpm</userinput>

</para>

<para>

<userinput>rpm -Uvh gtk-doc-0.9-5.noarch.rpm</userinput>

</para>

<para>

<userinput>rpm -Uvh at-spi-1.0.1-4.i386.rpm</userinput>

</para>

<para>

<userinput>rpm -Uvh at-spi-devel-1.0.1-4.i386.rpm</userinput>

</para>

<para>

<userinput>rpm -Uvh libwnck-devel-0.17-1.i386.rpm</userinput>

</para>

</step>

<step>

<para>

Install the latest version of <application>gok</application> from GNOME CVS:

</para>

<note>

<para>

When prompted for a password, press <keycap>Enter</keycap>.

</para>

</note>

<para>

<userinput>

cvs -d :pserver:anonymous@anoncvs.gnome.org:

/cvs/gnome login

</userinput>

</para>

<para>

<userinput>

cvs -d :pserver:anonymous@anoncvs.gnome.org:/cvs/gnome -z3 checkout gok

</userinput>

</para>

<note>

<para>

To update this release, use the terminal command <userinput>cvs -q up -P -d</userinput>

</para>

</note>

</step>

<step>

<para>

Run the autogen script:

</para>

<para>

<userinput>cd gok/</userinput>

</para>

<para>

<userinput>./autogen.sh</userinput>

</para>

<para>

<userinput>make</userinput>

</para>

<para>

<userinput>su -</userinput>

</para>

<para>

<userinput>make install</userinput>

</para>

<para>

<userinput>gok</userinput>

</para>

<note>

<para>

Because <application>gok</application> does not install <application>gconf</application> settings for individual users, run as root instead of an unpriviledged user.

</para>

</note>

</step>

</procedure>

Most mouse-related accessibility options can be found by using <menuchoice><guimenuitem>System</guimenuitem><guimenuitem>Preferences</guimenuitem><guimenuitem>Mouse</guimenuitem></menuchoice> and selecting the <guilabel>Accessibility</guilabel> tab. Two additional panel applets can optionally be added to the GNOME menu bar / system panel as well; see the sections below. 

</para>

A click can be issued by having the mouse pointer dwell in a given spot for a specified delay. In this mode, click-type is determined by the <guilabel>ClickType</guilabel> window, <application>Dwell Click</application> applet, or by the direction in which the user moves the mouse after the dwell time has elapsed. There is only a determined amount of time to move the mouse to indicate the click type; after that time has elapsed the pointer movement does not trigger a click until after the dwell time of the next pointer stop. The click-type can be single, double, drag or right.

The mouse pointer can be locked into an area of the screen so the pointing device is free for other tasks. For example, this capability allows a powerchair user to control the mouse pointer from the powerchair joystick.

In the <guilabel>Capture Pointer</guilabel> section, the user can specify under what circumstances the pointer gets captured when it moves into the capture area. For example, if the <keycap>Ctrl</keycap> modifier key is checked, the pointer gets captured when it is over the capture area and the user presses the <keycap>Ctrl</keycap> modifier key. If no modifier is checked and the mouse button is set to 0, the pointer only has to move into the capture area to get locked. It is also possible to specify a combination of modifiers with the chosen mouse button.

In the <guilabel>Release Pointer</guilabel> section, the user can specify what modifier or mouse button releases the pointer. It is also possible to specify a combination of modifiers with the chosen mouse button.

<section id="onboard">

<title>onBoard</title>

<para>

<application>onBoard</application> (formerly known as <application>sok</application>) is an alternate implementation of an on-screen keyboard (similar to <application>gok - GNOME Onscreen Keyboard</application>). The <application>onBoard</application> application is available for Ubuntu version 6.10 and forward. Packages may be downloaded for other distributions. 

</para>

</section>