Vim for Light Table
A thin wrapper around CodeMirror's vim mode that integrates it into Light Table.
For additional Vim-like functionality, see the guide for Vim Users.
Vim plugin using the Plugin Manager.
Vim keybindings only take effect on new files. Existing files will need to be reopened.
To map keys to normal mode, place them in a keymap under a
:editor.keys.vim.normal tag. These tags differ
in what key combos are available, how keys are referred to and what they can map
:editor.keys.vim.normal is for standard LightTable keybindings that support
standard modifier-key combos e.g. ctrl-Y and map to LightTable command(s). Do
not use this tag to map individual keys, remap keys to other keys or bind to
non-standard key combos e.g.
:editor.keys.vim.normal.cm is a tag that bypasses LightTable's normal keyhandling and
interacts directly with the Vim CodeMirror plugin.
This allows for the following more powerful but non-standard behavior:
- Key combinations are not limited to modifier keys e.g.
- Keys can be mapped to a string of keys or the standard LightTable command(s)
- An individual key can be a keybinding
- Special keys and modifier keys are referred to differently than in standard LightTable keybindings.
<C-x>. See the Vim CodeMirror keymap for more examples.
Some examples of these two tags:
;; Map a standard key combo to a command [:editor.keys.vim.normal "alt-q" :lt.plugins.reflow/reflow] ;; Map an individual key to a LightTable command [:editor.keys.vim.normal.cm ":" :vim.ex] ;; Remap a key to a sequence of keys [:editor.keys.vim.normal.cm "j" "gj"]
For a thorough example of
:editor.keys.vim.normal.cm, see this config.
To map keys to visual mode, place them in a keymap under a
:editor.keys.vim.visual tag. These have the
same behavior as their respective normal tags:
supports powerful but non-standard keybindings while
supports standard LightTable keybindings.
Our current vim mode version does not support mapping to other modes at this time.
vim.js with the following where
$VERSION is a version number tag:
curl https://raw.githubusercontent.com/codemirror/CodeMirror/$VERSION/keymap/vim.js > vim.js
vim.js is currently on CodeMirror version 4.6.0.
Copyright (C) 2013 Kodowa Inc.
Distributed under the MIT license, see license.md for the full text.