Kvkbd"> xmodmap"> Alt Gr"> ]> The &kvkbd; Handbook TodorGyumyushevyodor1@gmail.com GuillaumeMartressmarter@ubuntu.com 2007-2014 Todor Gyumyushev 2008 Guillaume Martres &FDLNotice; 2020 0.4.8 &tde; &kvkbd; is a virtual keyboard for &tde; TDE Kvkbd keyboard virtual accessibility Introduction &kvkbd; is a simple virtual keyboard for &tde;. It can be used instead of a physical keyboard or for devices with a touch screen but no keyboard. It is also useful to quickly test a keyboard mapping to locate some keys. Using &kvkbd; &kvkbd; interface When first launched, &kvkbd; will appear in the bottom-right corner of the screen. It can be moved by clicking and dragging on any part of the background area. Resize it by clicking and dragging on the stripes at the bottom right. The default style will be the system style which can be overridden whether launched from the command line or via the .desktop file with any &tde; or &TQt; style installed on the system. Example: kvkbd --style plastik, as shown here. The button on the top right is used to hide the keyboard - to show it again, just click on the tray icon. French keyboard: The AD11 key, ringed, is a dead key. To use the numeric keypad, click the double arrow on the right. The Num pad display can be toggled by clicking on the Num Lock key . To display and select the shift characters, use both &Shift; keys:  • Click either &Shift; key, which will 'lock', and then the other &Shift; key and the shift characters will be displayed.  • Then click on the character to print it. Otherwise, if you know which key the shift character is on, then the expected behaviour applies, and &Shift; 'key' will print it. Spanish keyboard shift characters: The configuration menu The &kvkbd; configuration menu is accessible by clicking on the configuration button or by right clicking on the tray icon. Select "Font" to choose the font used to display the characters on the keys. Check "Auto Resize Font" to resize the font when &kvkbd; is resized. Select "Keyboard color" to choose a colour for the keyboard [background]. Select "Key color" to choose a colour for the keys/buttons. &kvkbd; needs to be restarted for the chosen colour to display. Check "Dock Widget" to display a small dock which can be placed anywhere on screen. Click on the dock to hide or show the virtual keyboard. Check "Lock on screen" to fix the position and size of the keyboard on the screen. Keys The &kvkbd; keyboard is based on the US layout with an extra key to the right of Left &Shift; for non-US keyboards - the extra key duplicates < and > characters on the US keyboard. For non-US keyboards, the key which is normally lower left of the &Enter; key is placed above the &Enter; key. Where set up in the keyboard mapping file, &AltGr; will enable selection of the character mapped to the lower right of any key, and &AltGr; &Shift; for any upper right character. The &Shift;, &Ctrl;, Alt* keys 'lock' when clicked to simulate holding down a key on a physical keyboard. Whether the *Win keys 'lock' will depend on the build time option chosen. Dead Keys Using &Shift; and/or &AltGr; which need press and hold on a physical keyboard will need click only for &kvkbd;. For example, using the AD11 key [ ˆ ] on the oss variant of the French[fr]/azerty keyboard: setxkbmap fr -variant oss Character: dead_circumflex  dead_diaeresis dead_tilde dead_abovering K/B press: ˆ o &Shift;+ˆ u &AltGr;+ˆ e &AltGr;+&Shift;+ˆ a &kvkbd; click:  ˆ o &Shift; ˆ u  &AltGr; ˆ e  &AltGr; &Shift; ˆ a Printed: ô ü å Note that &kvkbd; is compiled for keycodes defined by evdev » /etc/X11/xkb/keycodes/evdev. &kvkbd; will have reduced functionality in systems using another keycode definitions file which can be checked by: • running xev in a konsole • pressing or clicking Menu • looking for keycode 135 among the output Using &kvkbd; with &tdm; &kvkbd; doesn't work with &tdm;. Use with other Display Managers by editing /etc/.../Xsetup. Add this: HOME=/root kvkbd --loginhelper There is no configuration button in the loginhelper mode. To change the default config, launch &kvkbd; as root: tdesu kvkbd and make the changes there from the configuration menu. &kvkbd; is run without the --loginhelper option when run from a konsole. Autostart Add kvkbd.desktop to the &tde; Autostart directory for &kvkbd; to run when &tde; starts. For a specific keyboard layout:  Exec=setxkbmap <xx>;kvkbd Or, with &xmmp;: [as in the example]  Exec=setxkbmap <xx>;&xmmp; -e 'keycode 133=quotedbl';&xmmp; -e 'keycode 134=asterisk';kvkbd Or, including the setxkbmap compose option:  Exec=setxkbmap -option compose:menu <xx>;xmodmap -e 'keycode 133=quotedbl';xmodmap -e 'keycode 134=asterisk';kvkbd Layout switching &kvkbd; will dynamically switch keyboard layouts as they are changed, either through the command line or using the &tde; Keyboard Tool. Refer to the &kxkb; Handbook for details on keyboard layout switching. Customizing &kvkbd; Key mapping Using the compose option for setxkbmap, it could be useful for example to set the Menu key as the compose key to set up user specified characters or character strings. Examples Add the Euro symbol for a US keyboard [¹] • Add <Multi_key> <e> <r> : U20AC # "€" EuroSign to ~/.XCompose [²] • Run setxkbmap -option compose:menu us • Start new konsole or editor • Click Menu e r .. and should be displayed Add a shortcut for a frequently used text string • Add <Multi_key> <t> <r> : "&tde; rocks" to ~/.XCompose • Run setxkbmap -option compose:menu <xx> • Start new konsole or editor • Click Menu t r .. and &tde; rocks should be displayed Assign keycodes &xmmp; can be used to assign keycodes to any key. If &kvkbd; has been built for the Win keys to function as non-control keys, they can conveniently be used for frequently used characters which might otherwise be more cumbersome to generate. For example, the " and * characters on a gb keyboard are &Shift;+2 and &Shift;+8, and they could be assigned to the Win keys: &xmmp; -e 'keycode 133=quotedbl' &xmmp; -e 'keycode 134=asterisk' Then LWin would print " and RWin would print * [¹] To emulate a keyboard where the Euro sign is engraved on the 5 key, setxkbmap us -variant euro and &AltGr; 5 would be more appropriate. [²] This is an easier combination to enter than the other Euro options in /usr/share/X11/locale/<LOCALE>/Compose, which doesn't include this combination.     However, if ~/.XCompose 'includes' /usr/share/X11/locale/<LOCALE>/Compose, any duplicated compose sequences in ~/.XCompose will have priority. Composite Characters Create a character that doesn't have a direct unicode mapping, but is composed of unicode characters in the font being used. As an example -- a-ogonek [U0105] + combining acute [U0301] -- ą́́ Add the character and chosen key combination to the ~/.XCompose file: echo "<Multi_key> <space> <a> : \"$(printf '\u0105\u0301')\" # aogonek + combining acute" >> ~/.XCompose Test: • Run setxkbmap -option compose:menu <xx> • Start new editor • Print the character:   Menu space a Credits and License &kvkbd; Program Copyright © 2007-2014 Todor Gyumyushev yodor1@gmail.com Program and Documentation Copyright © 2008 Guillaume Martres smarter@ubuntu.com &underFDL; &underGPL; Installation For your own build of &kvkbd;, see the INSTALL file. &documentation.index;