oh-my-fish/plugins/vi-mode/README.md
2014-01-10 03:56:35 -02:00

1.7 KiB

vi-mode

Basic vi key bindings emulation for fish.

Install

Add vi-mode to your list of fish plugins in your config.fish.

Example:

set fish_plugins autojump vi-mode

Configuration

Default mode

The default vi mode can be set by defining the variable vi_mode_default in
your config.fish.
If used, this variable must be set before loading oh-my-fish.
Its default value is vi_mode_insert.

To set normal mode as default:

set vi_mode_default vi_mode_normal

Mode indicator

The mode indicator is stored in the variable vi_mode.

See the oh-my-fish theme simplevi for an example of integration of the
indicator into the prompt.

User key bindings

User additional key bindings can be defined with the function
vi_mode_user_key_bindings. If used, this function must be defined before
loading oh-my-fish.

Example:

function vi_mode_user_key_bindings
    bind \el  suppress-autosuggestion
end

Not implemented

  • bind 2 vi-arg-digit
  • bind y yank-direction
  • bind g magic :-P
  • bind ^a increment next number
  • bind ^x decrement next number
  • bind /?nN search (jk kind of does this)
  • registers (maybe try to make sensible integration into X, like an
    explicit yank with y goes to an X selection, while an implicit
    delete with x etc. doesn't. "* and "+ should natually go to the
    appropriate X selection if possible)
  • etc.

Author

This mode has been created by Ian Munsie, the original file can
be found here.
It has been adapted for oh-my-fish by Sylvain Benner.