stow/oh-my-zsh/.oh-my-zsh/plugins/colemak/README.md

   1 # Colemak plugin
   2
   3 This plugin remaps keys in `zsh`'s [`vi`-style navigation mode](http://zsh.sourceforge.net/Doc/Release/Zsh-Line-Editor.html#Keymaps)
   4 for a [Colemak](https://colemak.com/) keyboard layout, to match the QWERTY position:
   5
   6 ![Colemak layout on a US keyboard](https://colemak.com/wiki/images/6/6c/Colemak2.png)
   7
   8 To use it, add it to the plugins array in your `~/.zshrc` file:
   9
  10 ```
  11 plugins=(... colemak)
  12 ```
  13
  14 You will also need to enable `vi` mode, so add another line to `~/.zshrc`:
  15 ```
  16 bindkey -v
  17 ```
  18
  19 Restart your shell and hit the `<ESC>` key to activate `vicmd` (navigation) mode,
  20 and start navigating `zsh` with your new keybindings!
  21
  22 ## Key bindings for vicmd
  23
  24 | Old        | New        | Binding                   | Description                                        |
  25 |------------|------------|---------------------------|----------------------------------------------------|
  26 | `CTRL`+`j` | `CTRL`+`n` | accept-line               | Insert new line                                    |
  27 | `j`        | `n`        | down-line-or-history      | Move one line down or command history forwards     |
  28 | `k`        | `e`        | up-line-or-history        | Move one line up or command history backwards      |
  29 | `l`        | `i`        | vi-forward-char           | Move one character to the right                    |
  30 | `n`        | `k`        | vi-repeat-search          | Repeat command search forwards                     |
  31 | `N`        | `K`        | vi-rev-repeat-search      | Repeat command search backwards                    |
  32 | `i`        | `u`        | vi-insert                 | Enter insert mode                                  |
  33 | `I`        | `U`        | vi-insert-bol             | Move to first non-blank char and enter insert mode |
  34 | `<none>`   | `l`        | vi-undo-change            | Undo change                                        |
  35 | `J`        | `N`        | vi-join                   | Join the current line with the next one            |
  36 | `e`        | `j`        | vi-forward-word-end       | Move to the end of the next word                   |
  37 | `E`        | `J`        | vi-forward-blank-word-end | Move to end of the current or next word            |
  38
  39 ## Key bindings for less
  40
  41 | Keyboard shortcut | `less` key binding |
  42 |-------------------|--------------------|
  43 | `n`               | forw-line          |
  44 | `e`               | back-line          |
  45 | `k`               | repeat-search      |
  46 | `ESC`+`k`         | repeat-search-all  |
  47 | `K`               | reverse-search     |
  48 | `ESC`+`K`         | reverse-search-all |