# Keyboards

## Keyboard Types

Some GOK keyboards are specified in xml, and some are created dynamically while GOK is running.

You can create new keyboards or modify existing ones by editing keyboard xml files.

## Installed Keyboards

Keyboard XML Format: There is no formal schema or DTD for the GOK keyboard XML format. An examination of the existing *.kbd.in files is the best way to learn the format. A good place to start is to try and modify launcher.kbd.in to launch your favorite application.

### Main Keyboard

The GOK - Main screen is comprised of the following seven buttons:

- Compose

- Launcher

- Activate

- Settings

- Menus

- Toolbars

- UI Grab

### Compose

Selecting "Compose" launches the alphanumeric keyboard.

#### Word Completion

The top spaces above the function keys are used for word completion displays.

#### Modifier Latching and Locking

"Latching" or "locking" of modifier keys, such as Shift and Ctrl, may be performed by enabling Sticky Keys. To enable Sticky Keys use the Keyboard accessibility preference tool in the Accessibility section of the GNOME Desktop Preferences.

Once Sticky Keys is enabled a modifier may be "latched" by selecting it. When a modifier is latched it will be applied to the next keystroke and then unlatched once that keystroke is output. For example, to output Shift + A one would select Shift to latch it and then select A. To "lock" a modifier select it twice. When a modifier is locked it will be applied to all following keystrokes until it is unlocked by selecting it again. For example, the output Ctrl + A followed by Ctrl + B followed by Ctrl + C one could perform the following: select Ctrl, select Ctrl again to lock it, select A, select B, select C and select Ctrl to unlock.

- Capslock - The "!" (exclamation) symbol indicates that Capslock is "on".

- Modifiers such as Shift and Ctrl: The "+" (plus) symbol attached to one of these keys indicates that the key is "latched" or "locked".

### Dynamic Keyboards

Dynamic Keyboards are created when GOK is running. An example is a GOK keyboard that is made up of keys based on the menus of the current active application.

#### Activate

Selecting this button generates a keyboard that displays all windows currently available on a user's system. It is useful for toggling between panels, accessing the GNOME desktop, files, folders and documents, the GOK Main, GOK Settings and so on.

#### Menus

The Menus button provides access to all menu items in the current application. If, for example, a word processing application is open the GOK might generate a Menus keyboard with the following buttons:

- Back - Returns user to GOK - Main

- File - Generates a new keyboard displaying all options associated with File

- Edit - Generates a new keyboard displaying all options associated with Edit

- View - Generates a new keyboard displaying all options associated with View

- Search - Generates a new keyboard displaying all options associated with Search

- Documents - Generates a new keyboard displaying all options associated with current documents.

- Help - Generates a new keyboard displaying all options associated with application's Help feature

#### Toolbars

If an application has an associated Toolbar, this button will provide access to these items in a dynamically generated onscreen keyboard.

#### UI Grab

The UI Grab generates a keyboard of all tool buttons associated with an application. For example, if a word processing application is "in focus" the GUI keyboard generated might feature the following toolbar buttons:

- Back - Returns user to GOK - Main

- New - Opens a new file

- Open - Opens an existing file

- Save - Saves current file

- Close - Closes current file

- Print - Prints current file

- Undo - Undo last action

- Redo - Redo the action that has been reversed by Undo

- Cut - Cut the selection

- Copy - Copy the selection

- Paste - Paste or insert text saved on the clipboard elsewhere in document

- Find - Search for a string

- Replace - Replace a string

#### Text Manipulation

This key (found on the Compose keyboard) launches an onscreen Text Editing keyboard which includes the following buttons:

- CTRL + Z - undo last action

- Word L - cursor moves one space to the left of the last entry

- Word R - cursor moves one space to the right of the last entry

- S Word L - highlights last entry left of the cursor

- S Word R - highlights last entry right of the cursor

- S Letter L - highlights letter to the left of the cursor

- S Letter R - highlights letter to the right of the cursor

- Left - move cursor left

- Right - move cursor right

- Up - move cursor up

- Down - move cursor down

- Cut - cuts highlighted text

- Copy - copies highlighted text

- Paste - inserts or "pastes" highlighted text into a document

- Clear - clears all