keyboard-layout layer

• Support alternative keyboard layouts within Spacemacs
• Remap navigation commands to the homerow of your chosen layout
• Remap missing commands automatically to elsewhere in the layout

This layer can be customized with two variables:

• kl-enabled-configurations
• kl-disabled-configurations

The first one is used to set the list of configurations to activate, and the second one to prevent loading certain configurations. If the kl-enabled-configurations variable is nil, (default: nil), then all configurations are loaded. Otherwise, only the listed configurations are loaded. Any configuration listed in kl-disabled-configurations will never be loaded, whether it is in the enabled list or not (default: nil).

(setq-default dotspacemacs-configuration-layers '(
  (keyboard-layout :variables
                   kl-layout 'dvorak
                   kl-disabled-configurations '(org magit))))

It is possible to override or add key bindings, by defining functions named kl/pre-config-<NAME> and kl/post-config-<NAME> in dotspacemacs/user-init. They are called just before and after the actual configuration of the key bindings in this layer. You don't have to think about when to apply the configuration by yourself. <NAME> is the name of the configuration you want to customize, they are listed under the Configuration section.

Example:

(defun kl/post-config-company ()
  "Company delete backward."
  (kl/set-in-state company-active-map (kbd "C-w") 'evil-delete-backward-word))

Note: If you define some of these functions in your own layer, then make sure that the keyboard-layout layer is placed after it in the dotspacemacs-configuration-layers list.

Bepo is a keyboard layout that's optimized for the French language.

The mapping correction is the one proposed for vim on the official Bepo wiki.

• The bepo layout: matches Vims movements keys:
  • c → h
  • t → j
  • s → k
  • r → l
• The lost keys are remapped as follows:
  • h → r
  • j → t
  • k → s
  • l → c

Some Bepo keys are not used in the traditional mapping, mainly because they are not on the en-us keyboard layout. They are used as aliases for other shortcuts:

• Map the unused é key as an alias for w, it's more useful in vim mode:
  • é → w
  • É → W
• Map indentation to direct-access keys:
  • » → >
  • « → <

Some default configurations are also not optimal for vim, so the following defaults are changed:

• Change the evil-escape combination to something that's faster to type, while being nearly nonexistent in French or English words:
  • fd → gq
• In avy, the keys that select words/lines are remapped to the 8 characters under the home row fingers:
  • a u i e t s r n

Note: There's one difference from the wiki version: w is not remapped to C-w. This avoids having to change its meaning in other modes. Spacemacs already provides SPC w for working with windows.

Dvorak is a keyboard layout, that's optimized for the English language. It rearranges the keys, to require less finger movements away from the home row.

The most common Dvorak layout is called Dvorak Simplified Keyboard (referred to as just Dvorak keyboard or Dvorak layout). It comes pre-installed on most operating systems.

Dvorak Simplified Keyboard (US layout):

Programmer Dvorak:

There's also a sub-layout called Programmer Dvorak. It reorders the number and symbol keys, to make it easier to type common programming symbols, without having to hold down the shift key. The keys that differ from the Dvorak Simplified Keyboard are shown in blue.

This Spacemacs Keyboard Layout layer has two Dvorak movement key variants:

The dvp variant: matches Vims movement keys:

• d → h
• h → j
• t → k
• n → l

The lost keys are remapped as follows:

• j → d
• k → t
• l → n

The dvorak variant: uses the home row, which is shifted 1 key to the right of Vims movement keys.

• h doesn't need to be remapped, it's already under the index finger.
• t → j
• n → k
• s → l

The lost keys are remapped as follows:

• j → t
• k → n
• l → s

Colemak is a modern alternative to the QWERTY and Dvorak layouts. It is designed for efficient and ergonomic touch typing in English. More info can be found on the Colemak website.

This layer offers four flavors of Colemak bindings:

• colemak-hnei remaps HJKL to HNEI, keeping the same key location; useful for people used to the HJKL scheme on a Qwerty keyboard.
• colemak-neio-literal remaps HJKL to NEIO, shifted one key to the right for easier access. It has easier access to new line mode (o).
• colemak-neio-inverted remaps HJKL to NEIO, shifted one key to the right for easier access. It has easier access to insert mode (i) (L, instead of K).
• colemak-jkhl remaps HJKL to JKHL, switching the direction of the keys without disturbing any other binding.

Note: for technical reasons (see GH-7178), when using colemak-jkhl, the kl/pre-config-evil and kl/post-config-evil hooks will be run twice.

Workman is an English-optimized keyboard layout that's designed to, among other things, reduce finger travel-distance, and balance the load equally between hands. It is meant to function particularly well in conjunction with ortholinear ('matrix' or 'grid') keyboards, such as the one depicted in the diagram below. More information can be found in the Workman section, of the wikipedia keyboard layout page.

As recommended in this blog post: Workman layout for Vim, this layout substitutes the following keys with these mnemonics:

• (y)ank -> (h)aul
• Search (n)ext -> (j)ump
• (e)nd word -> brea(k) of word
• (o)pen new line -> (l)ine
• The lost keys are remapped as follows:
  • h → y
  • j → n
  • k → e
  • l → o

Neo is a ergonomic keyboard that is optimized for German. More information can be found on the website.

The Neo layout has six layers, here is only the first: