xmodmap

本文章或章节需要扩充。

原因：为什么 xmodmap 只推荐用于最简单的任务？ (在 Talk:Xmodmap 中讨论)

xmodmap 是一个用于修改 Xorg 中键映射表和指针按钮映射的工具。

xmodmap 与 X keyboard extension (XKB) 没有直接关系，因为它在 X 中处理 *键码* 的想法与 XKB 不同（XKB 是更新的）。通常，它只推荐用于最简单的任务。有关高级布局配置，请参阅 X keyboard extension。

注

xmodmap 的设置会被 setxkbmap 重置，后者不仅会将字母数字键更改为指定的映射值，还会将所有其他键重置为启动默认值 (请参阅 LQWiki:Configuring keyboards)。
由于 Xorg 的一个限制，xmodmap 的设置不会自动应用于热插拔设备。如果在应用自定义表后将键盘添加到系统，则必须重新应用自定义表。 [1]

简介

在 Xorg 中有两种键盘值：键码 (keycodes) 和 按键符号 (keysyms)。

键码 (keycode): 键码是按下按键或鼠标按钮时内核接收到的数字表示。
按键符号 (keysym): 按键符号 是分配给 *键码* 的值。例如，按下 a 会生成 *键码 38*，该键码被映射到 *按键符号 0×61*，这与 ASCII 表中的 a 匹配。; 按键符号 由 Xorg 在一个定义 *键码*-*按键符号* 关系的键码表中管理，这个表被称为键映射表。运行 xmodmap 可以显示它。

安装

xmodmap 可以通过 xorg-xmodmap 包进行安装。

可选地，安装 xkeycaps，这是一个 xmodmap 的图形前端。

键映射表

打印当前键映射表，格式化为表达式

$ xmodmap -pke

[...]
keycode  57 = n N
[...]

每个键码后面跟着它映射到的 按键符号。上面的示例表明，*键码 57* 被映射到小写的 n，而大写的 N 被映射到 *键码 57* 加上 Shift。

表中的每个 按键符号 列对应于一种特定的修饰键组合

按键
Shift+按键
Mode_switch+按键
Mode_switch+Shift+按键
ISO_Level3_Shift+按键
ISO_Level3_Shift+Shift+按键

并非所有 按键符号 都必须设置，但要仅分配后面的 按键符号，请使用 NoSymbol 值。

要查看哪个 *键码* 对应于一个按键，请参阅 Keyboard input#Identifying keycodes in Xorg 以获取关于 xev 工具的详细信息，该工具在您按下按键时将输出与该键相关的键码/按键符号信息。

提示对于多媒体按键，有预定义的描述性 *按键符号*，例如 XF86AudioMute 或 XF86Mail。这些 *按键符号* 可以在 /usr/include/X11/XF86keysym.h 中找到。许多多媒体程序都设计为无需配置任何第三方应用程序即可使用这些 *按键符号*。

请注意，xmodmap 受 xkbd 设置的影响，因此 US(intl) xkbd 布局有全部八个按键符号可用，但默认的 US 布局则没有（它缺少 level3 中定义的 ralt_switch 符号）。要使所有 8 个按键符号可用，您应该配置键盘的 (intl) 变体。以 US 布局为例，在调用 xmodmap 测试当前 X 会话中的更改之前，使用 $ setxkbmap -layout 'us(intl)'。要永久更改此设置，请编辑 xorg 配置或您的 .xprofile 或 .xinitrc 文件。有关完整说明，请参阅 Xorg/Keyboard configuration#Setting keyboard layout。

自定义表

创建键映射（例如 ~/.Xmodmap）

$ xmodmap -pke > ~/.Xmodmap

测试更改

$ xmodmap ~/.Xmodmap

激活自定义表

使用 GDM、XDM 或 LightDM 时，无需 source ~/.Xmodmap。对于 startx，使用

~/.xinitrc

[[ -f ~/.Xmodmap ]] && xmodmap ~/.Xmodmap

或者，编辑全局启动脚本 /etc/X11/xinit/xinitrc。

测试更改

进行临时更改

$ xmodmap -e "keycode 46 = l L l L lstroke Lstroke lstroke"
$ xmodmap -e "keysym a = e E"

修饰键

xmodmap 也可用于覆盖修饰键，例如交换 Control 和 Super（即 Windows 键）。

冗余地打印当前修饰键表（完整示例）

$ xmodmap -pm

xmodmap:  up to 4 keys per modifier, (keycodes in parentheses):

shift       Shift_L (0x32),  Shift_R (0x3e)
lock        Caps_Lock (0x42)
control     Control_L (0x25),  Control_R (0x69)
mod1        Alt_L (0x40),  Meta_L (0xcd)
mod2        Num_Lock (0x94)
mod3      
mod4        Super_R (0x86),  Super_L (0xce),  Hyper_L (0xcf)
mod5        ISO_Level3_Shift (0x5c),  ISO_Level3_Shift (0x6c),  Mode_switch (0x85),  Mode_switch (0xcb)

查找按键符号列的修饰键

本文或本节是合并到 #键映射表的候选。

注意：本节的目的似乎不是 *查找* 任何内容。修饰键的含义应在 #键映射表中解释，因为它们是首先被提及的。（在 Talk:Xmodmap 中讨论）

ISO_Level3_Shift: 非 US 键盘上的 AltGr 键会调用修饰键 ISO_Level3_Shift。（在 US 键盘上，右 Alt Alt_R 的功能与左 Alt Alt_L 相同，这使得将布局设置为 US international 更加可取。请参阅 #键映射表。）
Mode_switch: Mode_switch 修饰键可能默认被映射到一个不在您键盘上的按键。

注意 xmodmap 和 X Keyboard Extension 之间对修饰键名称 ISO_Level3_Shift 和 Mode_switch 的使用方式不同。另请参阅 [2]。

重新分配修饰键到键盘上的按键

注意 xmodmap 区分 *大小写*。使用不正确的的大小写，例如 Mode_Switch 而非正确的 Mode_switch 会导致错误。

在分配之前，需要清除修饰键。这适用于您打算分配的修饰键以及您打算使用的按键上的修饰键。例如，如果您打算将 Caps_Lock 分配给您的 A 键，并将 B 分配给您的 NumLock 键，则需要先清除 Caps_Lock 和 Num_Lock 的修饰键，然后分配按键符号，最后添加回修饰键。

~/.Xmodmap

[...]
clear lock
clear mod2
keycode  38 = Caps_Lock
keycode  77 = Num_Lock
add lock = Caps_Lock
add mod2 = Num_Lock

! 是注释，所以下面的示例中只清除了 Control 和 Mod4 修饰键。然后，将 *按键符号* Control_L、Control_R、Super_L 和 Super_R 分配给相反的修饰键。将左右键都分配给同一个修饰键意味着这两个键被视为相同方式处理。

~/.Xmodmap

[...]
!clear Shift
!clear Lock
clear Control
!clear Mod1
!clear Mod2
!clear Mod3
clear Mod4
!clear Mod5
!add Shift   = Shift_L Shift_R
!add Lock    = Caps_Lock
add Control = Super_L Super_R
!add Mod1    = Alt_L Alt_R
!add Mod2    = Mode_switch
!add Mod3    =
add Mod4    = Control_L Control_R
!add Mod5    =

注意该示例假定 *按键符号* Control_L 和 Control_R 已分配给 Control 修饰键，而 Super_L 和 Super_R *按键符号* 已分配给 Mod4 修饰键。如果您收到以下错误消息 X Error of failed request: BadValue (integer parameter out of range for operation)，您将需要相应地进行调整。运行 xmodmap 会产生一个已分配给它们的修饰键和按键列表。

以下示例将 CapsLock 修改为 Control，并将 Shift+CapsLock 修改为 CapsLock

~/.Xmodmap

clear lock
clear control
add control = Caps_Lock Control_L Control_R
keycode 66 = Control_L Caps_Lock NoSymbol NoSymbol

组合键

本文或本节是合并到 Xorg/Keyboard configuration#Configuring compose key 的候选。

注意：与 Xorg/Keyboard_configuration#Configuring_compose_key 重复。（在 Talk:Xmodmap 中讨论）

一个组合键 (compose key) 用于创建键盘上可能无法直接访问的特殊字符和符号。这对于输入非英语语言的带重音字母特别有用。例如，连续按下 Compose、e、' 会产生 é。某些字符在按下 Compose 后需要按下 2 个以上的按键。通常，选择一个修饰键会被映射为 Compose。组合键可以在大多数桌面环境的 GUI 设置中进行设置，但如果使用了本文所述的自定义键映射表，这些选项将不起作用。要使用 Xmodmap 设置组合键，请使用 Multi_key 标识符。例如，将右 Alt 键 (AltGr) 映射为组合键

~/.Xmodmap

[...]
keycode 108 = Multi_key Alt_R Meta_R Alt_R Meta_R

键码数字可能因键盘型号而异。

反向滚动

本文或本节是合并到 Mouse buttons 的候选。

注意：xmodmap 不是唯一的实现方式。（在 Talk:Xmodmap 中讨论）

OS X Lion 中可用的自然滚动功能（模仿智能手机或平板电脑滚动）可以通过 xmodmap 复制。由于 synaptics 驱动程序使用按钮 4/5/6/7 进行向上/向下/向左/向右滚动，您只需在 ~/.Xmodmap 中交换声明按钮的顺序即可

~/.Xmodmap

pointer = 1 2 3 5 4 7 6 8 9 10 11 12

然后更新 xmodmap

$ xmodmap ~/.Xmodmap

交换鼠标按钮

本文或本节是合并到 Mouse buttons 的候选。

注意：xmodmap 不是唯一的实现方式。（在 Talk:Xmodmap 中讨论）

在 synaptics 驱动程序中，左、中、右鼠标按钮分别对应按钮 1、2 和 3。要交换左右鼠标按钮，同样只需在 ~/.Xmodmap 中颠倒列出它们的顺序即可

~/.Xmodmap

pointer = 3 2 1

这应该足以满足简单的鼠标设置。再次，更新 xmodmap

$ xmodmap ~/.Xmodmap

模板

西班牙语

~/.Xmodmap

keycode  24 = a A aacute Aacute ae AE ae
keycode  26 = e E eacute Eacute EuroSign cent EuroSign
keycode  30 = u U uacute Uacute downarrow uparrow downarrow
keycode  31 = i I iacute Iacute rightarrow idotless rightarrow
keycode  32 = o O oacute Oacute oslash Oslash oslash
keycode  57 = n N ntilde Ntilde n N n
keycode  58 = comma question comma questiondown dead_acute dead_doubleacute dead_acute
keycode  61 = exclam section exclamdown section dead_belowdot dead_abovedot dead_belowdot
!Maps the Mode key to the Alt key
keycode 64 = Mode_switch

世界语 (Esperanto)

接下来是一个示例，展示如何通过按 AltGr 和相关字母来输入世界语字母。例如，如果您键入 AltGr+C，您将得到字母 "Ĉ"。

~/.Xmodmap

keycode 54 = c C c C ccircumflex Ccircumflex
keycode 42 = g G g G gcircumflex Gcircumflex
keycode 43 = h H h H hcircumflex Hcircumflex
keycode 44 = j J j J jcircumflex Jcircumflex
keycode 39 = s S s S scircumflex Scircumflex
keycode 30 = u U u U ubreve Ubreve

将 CapsLock 更改为 Control

将 CapsLock 更改为 Control 的最简单示例。

~/.Xmodmap

clear lock
clear control
keycode 66 = Control_L
add control = Control_L Control_R

将 CapsLock 更改为 Control，并将 LeftControl 更改为 Hyper

笔记本电脑用户可能更喜欢将 CapsLock 设置为 Control。Left Control 键可以用作 Hyper 修饰键（用于 Emacs、Openbox 或 i3 的附加修饰键）。

~/.Xmodmap

clear      lock 
clear   control
clear      mod1
clear      mod2
clear      mod3
clear      mod4
clear      mod5
keycode      37 = Hyper_L
keycode      66 = Control_L
add     control = Control_L Control_R
add        mod1 = Alt_L Alt_R Meta_L
add        mod2 = Num_Lock
add        mod3 = Hyper_L
add        mod4 = Super_L Super_R
add        mod5 = Mode_switch ISO_Level3_Shift

将 Super_R 更改为 Hyper_R

希望在完整键盘布局上拥有 Hyper 键的用户可能希望将右 Super 键用作 Hyper。

~/.Xmodmap

remove  mod4 = Super_R
keycode  134 = Hyper_R
add     mod3 = Hyper_R

对于克罗地亚语布局，将每个数字键 N 与 Shift-N 相互交换，反之亦然

对于类似的布局，如克罗地亚语，也应该可以正常工作。

~/.Xmodmap

keycode 10 = exclam 1 1 exclam asciitilde dead_tilde asciitilde
keycode 11 = quotedbl 2 2 quotedbl dead_caron caron dead_caron
keycode 12 = numbersign 3 3 numbersign asciicircum dead_circumflex asciicircum
keycode 13 = dollar 4 4 dollar dead_breve breve dead_breve
keycode 14 = percent 5 5 percent degree dead_abovering degree
keycode 15 = ampersand 6 6 ampersand dead_ogonek ogonek dead_ogonek
keycode 16 = slash 7 7 slash grave dead_grave grave
keycode 17 = parenleft 8 8 parenleft dead_abovedot abovedot dead_abovedot
keycode 18 = parenright 9 9 parenright dead_acute apostrophe dead_acute
keycode 19 = equal 0 0 equal dead_doubleacute doubleacute dead_doubleacute

参见