Difference between revisions of "KEYMAP"

From ArchWiki
Jump to: navigation, search
m (fix gap)
(Keyboard layouts)
(48 intermediate revisions by 30 users not shown)
Line 1: Line 1:
[[Category:Internationalization (English)]]
+
[[Category:Internationalization]]
[[Category:HOWTOs (English)]]
+
[[de:KEYMAP]]
The '''KEYMAP''' variable is specified in the {{Filename|/etc/rc.conf}} file. It defines what keymap the keyboard is in the virtual consoles. Keytable files are provided by the kbd package.
+
[[es:KEYMAP]]
 +
[[fr:KEYMAP]]
 +
[[ja:KEYMAP]]
 +
[[pt:KEYMAP]]
 +
[[tr:Klavye_düzeni]]
 +
[[zh-CN:KEYMAP]]
 +
The '''KEYMAP''' variable is specified in the [[Systemd#Console_and_keymap|{{ic|/etc/vconsole.conf}}]] file. It defines what keymap the keyboard is in the virtual consoles. Keytable files are provided by the {{Pkg|kbd}} package.
  
 
==Keyboard layouts==
 
==Keyboard layouts==
This is the list of known keymap settings to work for the corresponding keyboard layouts. Usually the "map.gz" extension can be ignored.
+
This is the list of known keymap settings to work for the corresponding keyboard layouts. Most keymaps can be found in the {{ic|/usr/share/kbd/keymaps/i386/''layout''}} (''layout''=qwerty, azerty, dvorak, etc.) directory.
The list of keymaps can be found in the {{Filename|/usr/share/kbd/keymaps/''arch''}} (arch=i686, x86_64, etc.) directory.
+
  
<table border="1" cellpadding="2" cellspacing="0">
+
Less common but nonetheless useful keymaps for Arch Linux are found in the {{ic|/usr/share/kbd/keymaps/''architecture''}} (''architecture''=mac, sun, etc.) directory.
<tr>
+
 
<th>Keymap setting</th>
+
{{Note|In an X session, you can use setxkbmap to instantly apply keyboard layout: {{Ic|setxkbmap -layout dvorak}}}}
<th>Keyboard</th>
+
 
</tr>
+
{{Note|You can also use this method to modify single keys. This command would assign the compose functionality to the caps lock key: {{ic|setxkbmap -option 'compose:caps'}}
<tr>
+
This allows for example to write umlauts easily. Example for Umlaut A: {{ic| CAPSLOCK, ", A}}  ->  Ä}}
<td><code>KEYMAP="be-latin1.map.gz"</code></td>
+
 
<td>Belgian</td>
+
{{Note|If these keymaps do not work for you, make sure the keymap file exists in {{ic|/usr/share/kbd/keymaps/}} using {{Ic|find}}: {{Ic|find /usr/share/kbd/keymaps/ -name "*[your desired keymap]*"}}}}
</tr>
+
 
<tr>
+
{{Note|You can see some instructions on how to use some keymaps in their respective files with: {{Ic| zless /usr/share/kbd/keymaps/.../.../xx.map.gz}}}}
<td><code>KEYMAP="br-abnt2.map.gz"</code></td>
+
 
<td>Brazilian Portuguese</td>
+
{| class="wikitable" border="1"
</tr>
+
|-
<tr>
+
!  Keyboard
<td><code>KEYMAP="cf.map.gz"</code></td>
+
Keymap setting
<td>Canadian-French</td>
+
|-
</tr>
+
|Belgian
<tr>
+
|{{Ic|KEYMAP<nowiki>=</nowiki>be-latin1}}
<td><code>KEYMAP="croat.map.gz"</code></td>
+
|-
<td>Croatian</td>
+
|Brazilian Portuguese
</tr>
+
|{{Ic|KEYMAP<nowiki>=</nowiki>br-abnt2}}
<tr>
+
|-
<td><code>KEYMAP="cz-lat2.map.gz"</code></td>
+
|Canadian-French
<td>Czech</td>
+
|{{Ic|KEYMAP<nowiki>=</nowiki>cf}}
</tr>
+
|-
<tr>
+
|Canadian Multilingual (''in [[Arch User Repository|AUR]]'')
<td><code>KEYMAP="fr-latin9.map.gz"</code></td>
+
|{{Ic|KEYMAP<nowiki>=</nowiki>ca_multi}}
<td>French</td>
+
|-
</tr>
+
|Colemak ''(US)''
<tr>
+
|{{Ic|KEYMAP<nowiki>=</nowiki>colemak}}
<td><code>KEYMAP="de-latin1.map.gz"</code></td>
+
|-
<td>German</td>
+
|Croatian
</tr>
+
|{{Ic|KEYMAP<nowiki>=</nowiki>croat}}
<tr>
+
|-
<td><code>KEYMAP="de-latin1-nodeadkeys.map.gz"</code></td>
+
|Czech
<td>German (no dead keys)</td>
+
|{{Ic|KEYMAP<nowiki>=</nowiki>cz-lat2}}
</tr>
+
|-
<tr>
+
|Danish
<td><code>KEYMAP="lt.baltic.map.gz"</code></td>
+
|{{Ic|KEYMAP<nowiki>=</nowiki>dk}}
<td>Lithuanian (qwerty)</td>
+
|-
</tr>
+
|Dvorak
<tr>
+
|{{Ic|KEYMAP<nowiki>=</nowiki>dvorak}}
<td><code>KEYMAP="no-latin1.map.gz"</code></td>
+
|-
<td>Norwegian</td>
+
|Finnish
</tr>
+
|{{Ic|KEYMAP<nowiki>=</nowiki>fi-latin1}}
<tr>
+
|-
<td><code>KEYMAP="lat2-16.psfu.gz"</code></td>
+
|French
<td>Polish</td>
+
|{{Ic|KEYMAP<nowiki>=</nowiki>fr-latin1}}
</tr>
+
|-
<tr>
+
|German
<td><code>KEYMAP="pt-latin9.map.gz"</code></td>
+
|{{Ic|KEYMAP<nowiki>=</nowiki>de-latin1}}
<td>Portuguese</td>
+
|-
</tr>
+
|German ''(no dead keys)''
<tr>
+
|{{Ic|KEYMAP<nowiki>=</nowiki>de-latin1-nodeadkeys}}
<td><code>KEYMAP="ro_win.map.gz"</code></td>
+
|-
<td>Romanian</td>
+
|Greek
</tr>
+
|{{Ic|KEYMAP<nowiki>=</nowiki>gr}}
<tr>
+
|-
<td><code>KEYMAP="ru4.map.gz"</code></td>
+
|Italian
<td>Russian</td>
+
|{{Ic|KEYMAP<nowiki>=</nowiki>it}}
</tr>
+
|-
<tr>
+
|Lithuanian ''(qwerty)''
<td><code>KEYMAP="slovene"</code></td>
+
|{{Ic|KEYMAP<nowiki>=</nowiki>lt.baltic}}
<td>Slovene</td>
+
|-
</tr>
+
|Norwegian
<tr>
+
|{{Ic|KEYMAP<nowiki>=</nowiki>no-latin1}}
<td><code>KEYMAP="sv-latin1.map.gz"</code></td>
+
|-
<td>Swedish</td>
+
|Polish
</tr>
+
|{{Ic|KEYMAP<nowiki>=</nowiki>pl}}
<tr>
+
|-
<td><code>KEYMAP="fr_CH-latin1.map.gz"</code></td>
+
|Portuguese
<td>Swiss-French</td>
+
|{{Ic|KEYMAP<nowiki>=</nowiki>pt-latin9}}
</tr>
+
|-
<tr>
+
|Romanian
<td><code>KEYMAP="sg-latin1.map.gz"</code></td>
+
|{{Ic|KEYMAP<nowiki>=</nowiki>ro_win}}
<td>Swiss-German</td>
+
|-
</tr>
+
|Russian
<tr>
+
|{{Ic|KEYMAP<nowiki>=</nowiki>ru4}}
<td><code>KEYMAP="de_CH-latin1.map.gz"</code></td>
+
|-
<td>Swiss-German</td>
+
|Singapore
</tr>
+
|{{Ic|KEYMAP<nowiki>=</nowiki>sg-latin1}}
<tr>
+
|-
<td><code>KEYMAP="es.map.gz"</code></td>
+
|Slovene
<td>Spanish</td>
+
|{{Ic|KEYMAP<nowiki>=</nowiki>slovene}}
</tr>
+
|-
<tr>
+
|Swedish
<td><code>KEYMAP="la-latin1.map.gz"</code></td>
+
|{{Ic|KEYMAP<nowiki>=</nowiki>sv-latin1}}
<td>Spanish Latinoamerican</td>
+
|-
</tr>
+
|Swiss-French
<tr>
+
|{{Ic|KEYMAP<nowiki>=</nowiki>fr_CH-latin1}}
<td><code>KEYMAP="tr_q-latin5.map.gz"</code></td>
+
|-
<td>Turkish</td>
+
|Swiss-German
</tr>
+
|{{Ic|KEYMAP<nowiki>=</nowiki>de_CH-latin1}}
<tr>
+
|-
<td><code>KEYMAP="ua.map.gz"</code></td>
+
|Spanish
<td>Ukrainian</td>
+
|{{Ic|KEYMAP<nowiki>=</nowiki>es}}
</tr>
+
|-
</table>
+
|Spanish Dvorak
 +
|{{Ic|KEYMAP<nowiki>=</nowiki>dvorak-es}}
 +
|-
 +
|Spanish Latinoamerican
 +
|{{Ic|KEYMAP<nowiki>=</nowiki>la-latin1}}
 +
|-
 +
|Turkish
 +
|{{Ic|KEYMAP<nowiki>=</nowiki>tr_q-latin5}}
 +
|-
 +
|Ukrainian
 +
|{{Ic|KEYMAP<nowiki>=</nowiki>ua}}
 +
|-
 +
|United Kingdom
 +
|{{Ic|KEYMAP<nowiki>=</nowiki>uk}}
 +
|}
 +
 
 +
==Configuring the Console Keymap==
 +
 
 +
#{{ic|cd}} to {{ic|/usr/share/kbd/keymaps/i386/qwerty}}
 +
#Copy your default keymap ({{ic|us.map.gz}}) to a new file {{ic|personal.map.gz}}
 +
#{{ic|gunzip}} the new map file
 +
#Edit {{ic|personal.map}} using your favorite editor. Examples:
 +
#*'''Make the Right Alt key same as Left Alt key (Emacs)'''<br>change the line {{ic|include "linux-with-alt-and-altgr"}} to {{ic|include "linux-with-two-alt-keys"}}
 +
#*'''Swap CapsLock with Escape (Vim)'''<br>make {{ic|keycode 1 <nowiki>=</nowiki> Caps_Lock}} and {{ic|keycode 58 <nowiki>=</nowiki> Escape}}
 +
#*'''Make CapsLock another Control key'''<br>change the line {{ic|keycode 58 <nowiki>=</nowiki> Caps_Lock}} to {{ic|keycode 58 <nowiki>=</nowiki> Control}}
 +
#*'''Swap CapsLock with Left Control key'''<br>make {{ic|keycode 29 <nowiki>=</nowiki> Caps_Lock}} and {{ic|keycode 58 <nowiki>=</nowiki> Control}}
 +
#{{ic|gzip}} the map file
 +
#Change the default keyboard layout file that will be used by editing {{ic|/etc/vconsole.conf}} (you might have to create this file) and changing the line that says {{ic|KEYMAP<nowiki>=</nowiki>us}} to {{ic|KEYMAP<nowiki>=</nowiki>personal}}
 +
#Reboot to use your keymap the way nature intended (or run "loadkeys personal")

Revision as of 15:54, 28 February 2013

The KEYMAP variable is specified in the /etc/vconsole.conf file. It defines what keymap the keyboard is in the virtual consoles. Keytable files are provided by the kbd package.

Keyboard layouts

This is the list of known keymap settings to work for the corresponding keyboard layouts. Most keymaps can be found in the /usr/share/kbd/keymaps/i386/layout (layout=qwerty, azerty, dvorak, etc.) directory.

Less common but nonetheless useful keymaps for Arch Linux are found in the /usr/share/kbd/keymaps/architecture (architecture=mac, sun, etc.) directory.

Note: In an X session, you can use setxkbmap to instantly apply keyboard layout: setxkbmap -layout dvorak
Note: You can also use this method to modify single keys. This command would assign the compose functionality to the caps lock key: setxkbmap -option 'compose:caps' This allows for example to write umlauts easily. Example for Umlaut A: CAPSLOCK, ", A -> Ä
Note: If these keymaps do not work for you, make sure the keymap file exists in /usr/share/kbd/keymaps/ using find: find /usr/share/kbd/keymaps/ -name "*[your desired keymap]*"
Note: You can see some instructions on how to use some keymaps in their respective files with: zless /usr/share/kbd/keymaps/.../.../xx.map.gz
Keyboard Keymap setting
Belgian KEYMAP=be-latin1
Brazilian Portuguese KEYMAP=br-abnt2
Canadian-French KEYMAP=cf
Canadian Multilingual (in AUR) KEYMAP=ca_multi
Colemak (US) KEYMAP=colemak
Croatian KEYMAP=croat
Czech KEYMAP=cz-lat2
Danish KEYMAP=dk
Dvorak KEYMAP=dvorak
Finnish KEYMAP=fi-latin1
French KEYMAP=fr-latin1
German KEYMAP=de-latin1
German (no dead keys) KEYMAP=de-latin1-nodeadkeys
Greek KEYMAP=gr
Italian KEYMAP=it
Lithuanian (qwerty) KEYMAP=lt.baltic
Norwegian KEYMAP=no-latin1
Polish KEYMAP=pl
Portuguese KEYMAP=pt-latin9
Romanian KEYMAP=ro_win
Russian KEYMAP=ru4
Singapore KEYMAP=sg-latin1
Slovene KEYMAP=slovene
Swedish KEYMAP=sv-latin1
Swiss-French KEYMAP=fr_CH-latin1
Swiss-German KEYMAP=de_CH-latin1
Spanish KEYMAP=es
Spanish Dvorak KEYMAP=dvorak-es
Spanish Latinoamerican KEYMAP=la-latin1
Turkish KEYMAP=tr_q-latin5
Ukrainian KEYMAP=ua
United Kingdom KEYMAP=uk

Configuring the Console Keymap

  1. cd to /usr/share/kbd/keymaps/i386/qwerty
  2. Copy your default keymap (us.map.gz) to a new file personal.map.gz
  3. gunzip the new map file
  4. Edit personal.map using your favorite editor. Examples:
    • Make the Right Alt key same as Left Alt key (Emacs)
      change the line include "linux-with-alt-and-altgr" to include "linux-with-two-alt-keys"
    • Swap CapsLock with Escape (Vim)
      make keycode 1 = Caps_Lock and keycode 58 = Escape
    • Make CapsLock another Control key
      change the line keycode 58 = Caps_Lock to keycode 58 = Control
    • Swap CapsLock with Left Control key
      make keycode 29 = Caps_Lock and keycode 58 = Control
  5. gzip the map file
  6. Change the default keyboard layout file that will be used by editing /etc/vconsole.conf (you might have to create this file) and changing the line that says KEYMAP=us to KEYMAP=personal
  7. Reboot to use your keymap the way nature intended (or run "loadkeys personal")