doomemacs/modules/input/layout/README.org
Gerry Agbobada 911d7cb82c
Add support for bépo layout in a dedicated module
Evil is loaded too early to be able to wait for the
config.el file of a user to set the CR-rotation style variable.
2020-08-18 11:49:25 +02:00

2.6 KiB

input/layout

Description

This module provides barebones support for using Doom with evil-mode with non-qwerty layouts.

Maintainers

  • @gagbo (Author)

Module Flags

  • +bepo Enables modifications for the BÉPO layout (customized with version 1.1 in mind)

Plugins

None

Prerequisites

This module should only be active if evil is enabled. It uses a general.el utility function, and the hooks provided by evil-collection to make the necessary changes.

Features

Bépo

Support for the bépo layout includes:

  • Setting Avy keys to the correct home row keys
  • Changing navigation keys to ctsr
  • Bind <> functions to «» keys when possible
  • Bind [] functions to () keys when possible
  • Bind é key to w functions when possible
  • Bind è key to useful functions when possible
  • Bind `~ functions to $# keys when possible

A nice addition in the future might be to have all the normal mode bindings that start with g start with , instead to avoid the curl on these common bindings. This is not implemented for the time being.

Configuration

Bépo

doom-bepo-cr-rotation-style controls whether:

  • qwerty-c functions are mapped on bépo-l key, and qwerty-r functions on bépo-h key ('ergodis), or
  • qwerty-c functions are mapped on bépo-h key, and qwerty-r functions on bépo-l key ('strict)

'strict would be the logical choice but the c functions are used more often than the r ones so Ergodis advises to actually put all the c functions on the key that does not need a curl.

Troubleshooting

How to deactivate the new bindings and go back to the old ones ?

If you are learning a new layout you might want to go back to tho old one to "get work done". Sadly the only way is to comment out the module, run doom sync and restart emacs.

Restoring the session SPC q l by default helps to lower the impact of the restart.