README.CZ

   1                              UCW XKB 2.0
   2                              ===========
   3
   4                    Aneb nesmìlý pokus o dokumentaci :)
   5
   6
   7 UCW XKB je soubor klávesových map pro XFree86 4.3.x, které poskytují nové
   8 (a nekompatibilní) roz¹íøení mo¾ností konfigurace klávesnicových map. Pro
   9 X servery podporující star¹í verze XKB konfigurace slou¾í pøedchozí verze
  10 UCW XKB 1.0.
  11
  12
  13
  14
  15 1) Hlavní zmìny od UCW XKB 1.0
  16 ------------------------------
  17
  18    Pravdìpodobnì nejvìt¹í zmìnou od raných verzí UCW XKB je lep¹í
  19 porozumìní autorù v¹em záludnostem konfigurace klávesnice pod XKB
  20 Výsledné soubory jsou proto men¹í, opakovanì neimplementují to, co je
  21 ji¾ implementováno v XFree, nemají v sobì zbyteèný balast, lze je lepe
  22 kombinovat s ostatními mapami a hlavnì autoøi u¾ vìdí, co jednotlivé
  23 soubory dìlají. Jedinou výjimku tvoøí soubor compat/ucw, jeho¾ obsah
  24 byl nalezen pomocí magických rituálù (UCW = United Computer WIZARDS :)
  25
  26                                 -=-=-
  27
  28    Klávesnici lze nyní poskládat z jednotlivých komponent XFree a UCW
  29 klávesnice a je mo¾nì je libovolnì spolu kombinovat:
  30
  31    Napøíklad:
  32
  33           $ setxkbmap -rules ucw -layout us,ucw,cz-type         \
  34                       -variant qwerty,qwerty,qwertz             \
  35                       -option "lv3:caps,grp:shift_sclk"
  36
  37    vytvoøí klávesnici se tøemi grupami, které se pøepínají pomocí
  38 Shift+ScrollLock. V první je klasická americká klávesnice, v druhé
  39 èeská UCW klávesnice a v tøetí èeský psací stroj s prohozeným `z' a
  40 `y'. Poslední dvì klávesnice pou¾ívají CapsLock jako magickou klávesu.
  41
  42    Americká klávesnice je samozøejmì naprosto zbyteèná (odpovídá UCW
  43 bez magické klávesy) a do pøíkladu jsem ji zaøadil jen proto, abych se
  44 vytahoval mo¾nostmi XKB UCW a XKB vùbec :-) Uvedu tedy i èastìji
  45 pou¾ívanou konfiguraci:
  46
  47           $ setxkbmap -rules ucw -layout ucw,cz-prog            \
  48                       -option "lv3:caps,grp:shift_sclk,grp_led:scroll"
  49
  50    která obsahuje UCW a èeskou programátorskou klávesnici, navíc LED
  51 ScrollLocku bude svítit, kdy¾ bude èeská programátorská klávesnice
  52 zapnutá.
  53
  54
  55
  56
  57 2) Slovníèek pojmù - TODO
  58 --------------------------
  59
  60         - rules
  61
  62         - layout
  63
  64         - variant
  65
  66         - option
  67
  68         - group
  69
  70         - magická klávesa
  71
  72
  73
  74
  75 3) Instalace
  76 ------------
  77
  78 3.1) Debian (root)
  79
  80         dpkg -i ucw-xkb_2.0-1_all.deb
  81
  82 3.2) Instalace ruèní (root)
  83
  84    Nakopírujte obsah podadresáøù compat/ a symbols/ do
  85 podadresáøe xkb na va¹em poèítaèi, který na vìt¹inì Unixù naleznete
  86 buï v /etc/X11/xkb nebo /usr/share/X11/xkb. Pak spustte rules/setup.sh
  87 se správnými parametry.
  88
  89 3.3) Bì¾ný u¾ivatel
  90
  91    Neprivilegovanému u¾ivateli nezbývá nic jiného ne¾ rozbalit soubory
  92 do libovolného podadresáøe. Cestu k souborùm pak musí pøedat pøi
  93 výbìru klávesnice programùm setxkbmap a xkbcomp, jako napøíklad v
  94 následujícím shellovém skriptu:
  95
  96    #!/bin/sh
  97    setxkbmap -I/moje/cesta/xkb -print $@ | \
  98         xkbcomp -I/moje/cesta/xkb  - $DISPLAY
  99
 100
 101
 102
 103 4) Nastavení klávesnice
 104 -----------------------
 105
 106 4.1a) /etc/X11/XF86Config-4
 107
 108    Úpravou souboru /etc/X11/XF86Config-4 nastavuje klávesnici
 109 administrátor (root) v¹em u¾ivatelùm. V sekci klávesnice uvedete jako
 110 `Option' jednotlivé parametry XKB. Pro zvolení UCW klávesnice je nutné
 111 zvolit `ucw' pravidla (XkbRules) a samozøejmì alespoò jeden UCW layout
 112 a magickou klávesu.
 113
 114         Section "InputDevice"
 115                 Identifier      "Generic Keyboard"
 116                 Driver          "keyboard"
 117                 Option          "CoreKeyboard"
 118
 119                 Option          "XkbRules"      "ucw"
 120                 Option          "XkbModel"      "pc104"
 121                 Option          "XkbLayout"     "ucw,cz-prog"
 122                 Option          "XkbOptions"    "lv3:caps,grp:shift_sclk,grp_led:scroll"
 123         EndSection
 124
 125    Dal¹í dokumentaci naleznete v manuálových stránkách
 126
 127         $ man XF86Config-4
 128
 129 4.1b) /etc/X11/xorg.conf
 130
 131     Pro u¾ivatele X serveru Xorg je konfiguraèní soubor
 132 /etc/X11/xorg.conf s konfigurací pro v¹echny u¾ivatele. Nastavení UCW
 133 klávesnice je v principu stejné jako pro /etc/X11/XF86Config-4 (viz
 134 pøedchozí bod)
 135
 136         Section "InputDevice"
 137                 Driver       "kbd"
 138                 Identifier   "Keyboard[0]"
 139                 Option       "Protocol" "Standard"
 140
 141                 Option       "XkbRules" "ucw"
 142                 Option       "XkbLayout" "ucw"
 143                 Option       "XkbModel" "pc104"
 144                 Option       "XkbOptions" "mun:caps"
 145         EndSection
 146
 147
 148 4.2) setxkbmap & xkbcomp
 149
 150    Zmìnit klávesnici kdykoliv za bìhu X serveru lze pomocí programu
 151 setxkbmap. Pøi pou¾ití UCW klávesnice musíme pøedev¹ím zvolit pravidla
 152 (rules) a pak layout klávesnice, pøípadnì variantu nebo dal¹í
 153 parametry (options)
 154
 155         $ setxkbmap -rules ucw -layout cz-prog -options ....
 156
 157    Program setxkbmap øíká X serveru, aby nahrál novou definici
 158 klávesnice.
 159
 160    Mù¾e se stát, ¾e soubory popisující UCW klávesnici nejsou
 161 nainstalované mezi ostatními nebo jsou dokonce nainstalované do
 162 adresáøe, kam X server "nevidí" (to je docela dobøe mo¾né - napøíklad
 163 pokud jsme soubory rozbalili v domovském adresáøi na AFS). Pak program
 164 setxkbmap pou¾ijeme jen ke zpracování pravidel a k nahrání klávesnice
 165 pou¾ijeme jiný program, xkbcomp:
 166
 167         $ setxkbmap -print -I/cesta/k/xkb -rules ucw -layout .... | \
 168                 xkbcomp -I/cesta/k/xkb - $DISPLAY
 169
 170    Chcete-li zvolit klávesnici automaticky pøi pøihlá¹ení do systému,
 171 pøíkaz pro volbu klávesnice napi¹te do souboru ~/.xinitrc.
 172
 173    Dal¹í informace: man setxkbmap, xkbcomp, xinit
 174
 175 4.3) GUI nástroje.... - TODO
 176
 177    UCW XKB klávesnice zatím nijak nespolupracuje s GUI nástroji pro
 178 volbu zmìnu klávesnice, napøíklad s GNOME Keyboard Preferences.
 179
 180    Musím pøiznat, ¾e mi zmínìné programy vùbec nechybí, pokud Vám ano,
 181 mù¾ete buï vypsat tuèný ¹ek, nebo napsat specifikaci klávesnice v XML
 182 podle vzoru /etc/X11/xkb/rules/xfree86.xml nebo xfree86-cs.xml.
 183
 184
 185
 186
 187 5) Layout
 188 ---------
 189
 190    Layout urèuje základní rozvr¾ení klávesnice, v UCW XKB jich
 191 nalezneme celkem pìt:
 192
 193         ucw             - americká klávesnice
 194         cz-prog         - èeská programátorská klávesnice
 195         cz-type         - èeský psací stroj
 196         sk-prog         - slovenská programátorská klávesnice
 197         sk-type         - slovenský psací stroj.
 198
 199    Ve v¹ech UCW klávesnicích jsou písmenka s diakritikou umístìna na
 200 dané písmenko nebo do jeho bezprostøední blízkosti. Písmenko s
 201 diakritikou pak volíme pomocí magické klávesy (lv3). Napøíklad:
 202
 203         lv3 + S         => ©
 204         lv3 + e         => é
 205         lv3 + w         => ì
 206         lv3 + x         => ß
 207
 208    U programátorské klávesnice a u psacího stroje má magická klávesa
 209 je¹tì jednu funkci. V pøípadì kláves, které se li¹í od americké
 210 klávesnice (1-9, +, ...) získáme pomocí magické klávesy pùvodní
 211 klávesu z americké klávesnice:
 212
 213         lv3 + ì         => 2
 214         lv3 + shift + ì => @
 215
 216    Zvolený layout neurèuje magickou klávesu. Magickou klávesu musíme
 217 vybrat jedním z Option v kapitole 6.
 218
 219 5.1) Více klávesnicových map souèasnì
 220
 221    Layout (ucw, cz-prog...) je umístìn do tzv. grup. XKB umo¾òuje
 222 pou¾ívat souèasnì a¾ ètyøi grupy (1-4), nahrát do nich rùzné layouty
 223 a pomocí klávesnice (èi programù) z nich vybrat jednu aktivní.
 224
 225    Pokud chceme pou¾ívat klávesnici s více layouty/grupami, uvedete
 226 místo jednoho layoutu jejich seznam a jednotlivé layouty oddìlíte
 227 èárkou:
 228
 229         $ setxkbmap ... -layout "ucw,cz-prog" ...
 230
 231    Pokud pou¾íváme zároveò varianty s více grupami, musíme uvést
 232 variantu pro ka¾dou grupu zvlá¹» v seznamu oddìleném èárkami, i kdyby
 233 byly varianty pro v¹echny grupy stejné:
 234
 235         $ setxkbmap ... -layout "ucw,cz-prog" -variant "qwertz,qwertz" ...
 236
 237
 238
 239
 240 6) Varianty
 241 -----------
 242
 243    Varianty umo¾òují volit jednu z více podmo¾ností jednoho layoutu. Na
 244 rozdíl od `option' není mo¾né zvolit více variant souèasnì.
 245
 246    UCW XKB zná pouze dvì varianty klávesnice: qwert a qwertz.
 247
 248
 249
 250
 251 7) Options
 252 ----------
 253
 254   `Option' lze rozdìlit do tøí základních skupin. Parametry pro
 255 zvolení magické klávesy (lv3), parametry pro zvolení klávesy na
 256 pøepínání grup a ostatní.
 257
 258    Na rozdíl od verze 1.0, obsahuje UCW XKB pouze minimum vlastních
 259 parametrù, ostatní bylo mo¾né pøevzít z XFree86.
 260
 261    Nebo» pøi volbì klávesnice vyu¾ijete pravdìpodobnì parametry jak z
 262 UCW XKB tak z XFree86, uvedu v seznamu v¹echny významné (ostatní
 263 naleznete v /etc/X11/xkb/rules/ucw.lst)
 264
 265 7a) Klávesa pøepínající grupy
 266
 267   grp:shift_sclk        - Shift + ScrollLock (ucw)
 268   grp:sclk_toggle       - Scroll Lock (xfree)
 269
 270      .... a mnoho dal¹ích
 271
 272 7b) Magická klávesa
 273
 274   lv3:caps              - CapsLock (ucw)
 275
 276   lv3:switch            - pravý Control (xfree)
 277   lv3:menu_switch       - klávesa Menu (xfree)
 278   lv3:win_switch        - libovolná z "Win" kláves (xfree)
 279   lv3:lwin_switch       - levá "Win" klávesa (xfree)
 280   lv3:rwin_switch       - pravá "Win" klávesa (xfree)
 281   lv3:ralt_switch       - pravý Alt (xfree)
 282
 283 7c ) Ostatní
 284
 285    Volby s prefixem grp_led urèují, které LED svítí, kdy¾ jsme zvolili
 286 druhou klávesnici (druhou grupu)
 287
 288   grp_led:num           - NumLock
 289   grp_led:caps          - CapsLock
 290   grp_led:scroll        - ScrollLock
 291
 292
 293 ; arch-tag: Daniel Skarda Tue Oct 26 12:23:39 2004 (README)