mirror of
https://github.com/helix-editor/helix.git
synced 2025-01-19 13:37:06 +04:00
707457c632
* Rewrite and refactor all documentation * Rewrite and refactor the guides * update runtime directory instructions for windows * Update the Ubuntu 3rd party repo section with 22.10 * Merge from upstream * Rewrite and refactor all documentation * Apply suggestions from code review Apply the suggestions that can be committed from the GitHub web interface. Co-authored-by: Michael Davis <mcarsondavis@gmail.com> * Add Windows themes folder Co-authored-by: digidoor <37601466+digidoor@users.noreply.github.com> * Apply the rest of the suggestions from the code review * Revert "Apply the rest of the suggestions from the code review" This reverts commit498be1b7a1. * Revert "Merge branch 'rewrite-and-refactor-all-documentation' of github.com:David-Else/helix into rewrite-and-refactor-all-documentation" This reverts commit7c8404248f, reversing changes made tod932969cfc. * Apply code review suggestions * Changes after re-reading all documents * Missed a full stop * Code review suggestions and remove macOS and Windows specific sections * Add OpenBSD to heading * Add back macOS and Windows sections and further simplify and improve * Change wording to nightly * Remove README installation section and turn into a link * Simplify building from source and follow code review suggestions * Code review revisions * Fix copy paste mistake * Apply the latest code review suggestions * More small code review items * Change minor modes for code review * Fix link and typos * Add note that you need a c++ compiler to install the tree-sitter grammars * Add pacman example * Make sure all headings are lower case * Revert to the original passage adding a reference to Windows that was missing * Update book/src/guides/adding_languages.md Fix grammar typo Co-authored-by: Michael Davis <mcarsondavis@gmail.com> * Update book/src/install.md Fix tree sitter typo Co-authored-by: Michael Davis <mcarsondavis@gmail.com> * Remove TOC links to main heading --------- Co-authored-by: CptPotato <3957610+CptPotato@users.noreply.github.com> Co-authored-by: Michael Davis <mcarsondavis@gmail.com> Co-authored-by: digidoor <37601466+digidoor@users.noreply.github.com>
80 lines
2.8 KiB
Markdown
80 lines
2.8 KiB
Markdown
# Key remapping
|
|
|
|
Helix currently supports one-way key remapping through a simple TOML configuration
|
|
file. (More powerful solutions such as rebinding via commands will be
|
|
available in the future).
|
|
|
|
To remap keys, create a `config.toml` file in your `helix` configuration
|
|
directory (default `~/.config/helix` on Linux systems) with a structure like
|
|
this:
|
|
|
|
```toml
|
|
# At most one section each of 'keys.normal', 'keys.insert' and 'keys.select'
|
|
[keys.normal]
|
|
C-s = ":w" # Maps Ctrl-s to the typable command :w which is an alias for :write (save file)
|
|
C-o = ":open ~/.config/helix/config.toml" # Maps Ctrl-o to opening of the helix config file
|
|
a = "move_char_left" # Maps the 'a' key to the move_char_left command
|
|
w = "move_line_up" # Maps the 'w' key move_line_up
|
|
"C-S-esc" = "extend_line" # Maps Ctrl-Shift-Escape to extend_line
|
|
g = { a = "code_action" } # Maps `ga` to show possible code actions
|
|
"ret" = ["open_below", "normal_mode"] # Maps the enter key to open_below then re-enter normal mode
|
|
|
|
[keys.insert]
|
|
"A-x" = "normal_mode" # Maps Alt-X to enter normal mode
|
|
j = { k = "normal_mode" } # Maps `jk` to exit insert mode
|
|
```
|
|
|
|
## Minor modes
|
|
|
|
Minor modes are accessed by pressing a key (usually from normal mode), giving access to dedicated bindings. Bindings
|
|
can be modified or added by nesting definitions.
|
|
|
|
```toml
|
|
[keys.insert.j]
|
|
k = "normal_mode" # Maps `jk` to exit insert mode
|
|
|
|
[keys.normal.g]
|
|
a = "code_action" # Maps `ga` to show possible code actions
|
|
|
|
# invert `j` and `k` in view mode
|
|
[keys.normal.z]
|
|
j = "scroll_up"
|
|
k = "scroll_down"
|
|
|
|
# create a new minor mode bound to `+`
|
|
[keys.normal."+"]
|
|
m = ":run-shell-command make"
|
|
c = ":run-shell-command cargo build"
|
|
t = ":run-shell-command cargo test"
|
|
```
|
|
|
|
## Special keys and modifiers
|
|
|
|
Ctrl, Shift and Alt modifiers are encoded respectively with the prefixes
|
|
`C-`, `S-` and `A-`. Special keys are encoded as follows:
|
|
|
|
| Key name | Representation |
|
|
| --- | --- |
|
|
| Backspace | `"backspace"` |
|
|
| Space | `"space"` |
|
|
| Return/Enter | `"ret"` |
|
|
| \- | `"minus"` |
|
|
| Left | `"left"` |
|
|
| Right | `"right"` |
|
|
| Up | `"up"` |
|
|
| Down | `"down"` |
|
|
| Home | `"home"` |
|
|
| End | `"end"` |
|
|
| Page Up | `"pageup"` |
|
|
| Page Down | `"pagedown"` |
|
|
| Tab | `"tab"` |
|
|
| Delete | `"del"` |
|
|
| Insert | `"ins"` |
|
|
| Null | `"null"` |
|
|
| Escape | `"esc"` |
|
|
|
|
Keys can be disabled by binding them to the `no_op` command.
|
|
|
|
A list of commands is available in the [Keymap](https://docs.helix-editor.com/keymap.html) documentation
|
|
and in the source code at [`helix-term/src/commands.rs`](https://github.com/helix-editor/helix/blob/master/helix-term/src/commands.rs) at the invocation of `static_commands!` macro and the `TypableCommandList`.
|