git.r.bdr.sh - rbdr/dotfiles/blob - atom/packages/vim-mode/README.md

   1 ## Vim Mode package [![Build Status](https://travis-ci.org/atom/vim-mode.svg?branch=master)](https://travis-ci.org/atom/vim-mode)
   2
   3 Provides vim modal control for Atom, ideally blending the best of vim
   4 and Atom.
   5
   6 ### Installing
   7
   8 Use the Atom package manager, which can be found in the Settings view or
   9 run `apm install vim-mode` from the command line.
  10
  11 ### Current Status
  12
  13 Sizable portions of Vim's normal mode work as you'd expect, including
  14 many complex combinations. Even so, this package is far from finished (Vim
  15 wasn't built in a day).
  16
  17 If you want the vim ex line (for `:w`, `:s`, etc.), you can try [ex-mode](https://atom.io/packages/ex-mode)
  18 which works in conjuction with this plugin.
  19
  20 Currently, vim-mode has some issues with international keyboard layouts.
  21
  22 If there's a feature of Vim you're missing, it might just be that you use it
  23 more often than other developers. Adding a feature can be quick and easy. Check
  24 out the [closed pull requests](https://github.com/atom/vim-mode/pulls?direction=desc&page=1&sort=created&state=closed)
  25 to see examples of community contributions. We're looking forward to yours, too.
  26
  27 ### Documentation
  28
  29 * [Overview](https://github.com/atom/vim-mode/blob/master/docs/overview.md)
  30 * [Motions and Text Objects](https://github.com/atom/vim-mode/blob/master/docs/motions.md)
  31 * [Operators](https://github.com/atom/vim-mode/blob/master/docs/operators.md)
  32 * [Windows](https://github.com/atom/vim-mode/blob/master/docs/windows.md)
  33 * [Scrolling](https://github.com/atom/vim-mode/blob/master/docs/scrolling.md)
  34
  35 ### Development
  36
  37 * Create a branch with your feature/fix.
  38 * Add a spec (take inspiration from the ones that are already there).
  39 * If you're adding a command be sure to update the appropriate file in
  40   `docs/`
  41 * Create a PR.
  42
  43 When in doubt, open a PR earlier rather than later so that you can receive
  44 feedback from the community. We want to get your fix or feature included as much
  45 as you do.
  46
  47 See [the contribution guide](https://github.com/atom/vim-mode/blob/master/CONTRIBUTING.md).