17 Implementing user mode

Coleman McFarland edited this page 2022-10-08 20:21:59 -04:00

Kakoune provides a simple way to bind keys to a personal namespace, the user mode which is triggered by the <space> by default.

map global user e ':echo foo<ret>'

---

If the user keymode is not big enough, you can implement your own, triggered by the key you want. Good candidates can be <a-g> or <a-v> since g and v already work quite the same.

Start by declaring a new mode:

declare-user-mode cmd

add some bindings on it:

map global cmd w ':write<esc>'
map global cmd e ':e<space>'

and finally bind a key to trigger this custom mode:

map global normal <a-,> ':enter-user-mode<space>cmd<ret>'

Wiki Home Page

Onboarding

• Why Kakoune?
• Migrating from Vim
• Migrating from Vim popular plugins

Keys

• Normal mode commands
• Avoid the escape key
• Implementing user mode (Leader key)
• Kakoune explain
• Kakoune TV

Editing

• Indentation & Tabulation
• Wrapping
• Selections
• Selections Combinations
• Regex
• Undo tree

User Interface

• Highlighters
• Line flags
• Status line
• Info boxes
• Kakoune Ink

Integration with OS and other tools

• Languages
• IDE
• Bar
• Kak daemon helper : 1 session per project
• Registers & Clipboard
• macOS tips
• Windows tips
• Fuzzy finders
• JSON-RPC UI
• bc
• Qalculate!
• wc
• Shell Scripting
• Manipulating dates with Chronic
• Integrating Other CLI apps

Plugins

• Installing Plugins
• Writing Plugins
• Documenting Plugins
• Plugin Managers