summaryrefslogtreecommitdiff
path: root/share/multikey
Unidiff
Diffstat (limited to 'share/multikey') (more/less context) (ignore whitespace changes)
-rw-r--r--share/multikey/README85
1 files changed, 66 insertions, 19 deletions
diff --git a/share/multikey/README b/share/multikey/README
index beed768..b0da95f 100644
--- a/share/multikey/README
+++ b/share/multikey/README
@@ -1,10 +1,8 @@
1+---- how to make your own keymap file. ----+ 1+----------------------------------------------------------------------------+
2 2| |
3first of all, later on you will be able to choose the keymap, but right now it 3| the basics |
4selects the keymap according to your language setting. for example, if your 4| |
5language is "ko", it will select $OPIE_DIR/share/multikey/ko.keymap for the 5+----------------------------------------------------------------------------+
6keymap. so if you want to make a german keymap, copy the en.keymap file to
7de.keymap, and edit it.
8 6
9your best friend is xmbfed. open the unicode font that is in 7your best friend is xmbfed. open the unicode font that is in
10$QT_DIR/lib/fonts/unifont.bdf and search for the characters you want to input. 8$QT_DIR/lib/fonts/unifont.bdf and search for the characters you want to input.
@@ -22,9 +20,8 @@ v v
22 20
23so, lets say you want to edit the 5th key on the 2nd row. find the 5th line 21so, lets say you want to edit the 5th key on the 2nd row. find the 5th line
24that starts with 2, and replace the 3rd column with the code you found in 22that starts with 2, and replace the 3rd column with the code you found in
25xmbdfed. save the file and test it out by restarting opie, or running 23xmbdfed. save the file and test it out by selecting another map, and
26 24selecting the one you are editing again.
27host$ $OPIEDIR/bin/qcop QPE/TaskBar "reloadInputMethods()"
28 25
29it worked, right? if all you see is a square in it's place, that means your 26it worked, right? if all you see is a square in it's place, that means your
30default font doesn't have that char. go to appearance and change the font to 27default font doesn't have that char. go to appearance and change the font to
@@ -33,23 +30,73 @@ one that has that char.
33and if you want, you can have an image as the label instead of the char itself. 30and if you want, you can have an image as the label instead of the char itself.
34just draw the xpm image in gimp or something, save it, open it in your text 31just draw the xpm image in gimp or something, save it, open it in your text
35editor, cut off all the surrounding stuff and leave only the stuff between the 32editor, cut off all the surrounding stuff and leave only the stuff between the
36" chars. place that after your key definition. not too hard, right? 33" chars. place that after your key definition. not too hard, right? one thing
34about this is you cant use xpm images for shift or any other meta keys.
35
36+----------------------------------------------------------------------------+
37| |
38| shift and meta keys |
39| |
40+----------------------------------------------------------------------------+
37 41
38about shift and meta characters. to place chars in the shift map, the line 42about shift and meta characters. to place chars in the shift map, the line
39should consist of two columns. the non-shifted char and the shifted char. for 43should consist of two columns. the non-shifted char and the shifted char. for
40example. 44example.
41 45
420x36 0x46 460x71 0x51
47
48so, 0x71 (q) shifted is 0x51 (Q).
49
50and now for meta chars. the reason why you have this feature is because of
51languages like german, where you can hold down the meta (alt-gr) key and enter
52in other special characters. it's like having a second shift. to add chars to
53this map, you do the following.
54
55m 0x71 0x31
56
57here, if you hold down meta and hit the 0x71 (q) key, 0x31 (1) would be input.
58get it? and one more thing about meta keys and shifting at the same time. if
59you wanted the above key to shift while meta is held down, just add the
60original shifted key to the meta map, like this.
61
62m 0x51 0x7e
63
64here if you hit meta and then shift, you would get 0x7e (!).
65
66+----------------------------------------------------------------------------+
67| |
68| circumflex and diaeresis |
69| |
70+----------------------------------------------------------------------------+
71
72just in case you use french, there are also maps for circumflex chars and
73diaeresis. for example...
74
752 0 0x69 2
760x69 0x49
77c 0x69 0xee
78d 0x69 0xef
79
80this would define an 'i' with a shift, circumflex, and a diaeresis definition.
81to shift the circumflex and diaeresis keys, do the same as you would with a
82meta key. add the orignal key shifted to the circumflex and diaeresis maps.
83
84c 0x49 0xce
85d 0x49 0xcf
43 86
44so, 0x36 shifted is 0x46. and for meta chars. the reason why you have this 87+----------------------------------------------------------------------------+
45feature is because of languages like german, where you can hold down the 88| |
46meta-alt key and enter in other special characters. it's like having 89| special keys |
47a second shift. to add chars to this map, you do the following. 90| |
91+----------------------------------------------------------------------------+
48 92
49m 0x36 0x84 93to define special keys like the meta key, circumflex or diaeresis keys, here
94is what you should use.
50 95
51and here, if you hold down the meta-alt and hit the 0x36 key, 0x84 would be 965 0x1030 0 2 # opens config dialog
52input. get it? 975 0x1022 0 3 # meta
982 0 0x2c6 2 # circumflex
990x2c6 0xa8 # diaeresis
53 100
54if you have problems, suggestions, or just want to tell me something, you can 101if you have problems, suggestions, or just want to tell me something, you can
55contact me at jake at asdfnews.org 102contact me at jake at asdfnews.org