vim-mode-plus

vim-mode improved.

• vim-mode-plus
• What's new in v0.58.0
• Important
• Thanks
• Issue report
• Whats this?
• FAQ
  • Why fork? why not directly contribute to official vim-mode?
  • In visual-block mode, some motion make editor slow, freeze.
  • ex-mode?
  • Want to suppress autocomplete-plus's auto suggestion except insert-mode.
• Wiki
• Keymap
• Helper packages
• References
  • Vim official
  • Other
• Commit emoji convention

What's new in v0.58.0

In v0.58.0, introduce preset-occurrence and persistent-selection. In v0.55.0, introduce occurrence-modifier

These features are very powerfull especially for power user, read folloiwng document to learn how to use.

• Advanced Topic Tutorial
• Occurrence Modifier
• CHANGELOG.md

Important

• vim-mode-plus is replacement of vim-mode, you must disable vim-mode first to use vim-mode-plus.
• You don't need following packages since it's built-in to vim-mode-plus.
  • vim-surround
  • vim-mode-visual-block
• Scope for CSS selector and keymap is different from vim-mode, not compatible.
• Internal code base is very different. Thus, issue, PRs should be directly sent to vim-mode-plus. DONT report vim-mode-plus's issue or PRs to official vim-mode.

Thanks

My work is greatly owing to former achievement done by original vim-mode developers and many of its contributors.
As you can see in commit history, this project is originally started by forking official vim-mode.
The great design to achieve Vim operation by composing operator with target(motion, text-object) on top of operationStack is still lives in vim-mode-plus now.
I don't think I can find this idea by myself from nothing.
Sincerely, I feel I couldn't do anything without original vim-mode.

Issue report

• Read ISSUE_TEMPLATE

Whats this?

Fork of vim-mode. Started at 2015.8.1.

• Many bug fixes.
• Refactoring: Rewritten almost every lines of codes.
• Highlight search
• visual-blockwise built-in
• Incremental search by incrementalSearch setting(disabled by default).
• Cursor visible in all visual-mode(characterwise, blockwise, linewise).
• Stay same cursor position after operate(e.g y, gU) by stayOnYank, stayOnOperate setting.(disabled by default)
• Lots of new motion like move-up-to-edge, move-down-to-edge.(No keymap by default)
• Surround built-in. Powerful AnyPair family(change-surround-any-pair operator, inner-any-pair text-object) to detect pair automatically.
• Set cursor position to start of change on undo or redo by enabling setCursorToStartOfChangeOnUndoRedo(enabled by default. Atom's default is end of change).
• Allow super granular keymap only effective when specific operation is pending like yank-pending, delete-pending. #215
• And more...

FAQ

Search Q&A label on issues.

Why fork? why not directly contribute to official vim-mode?

• Changes are too big.
• I felt many features are too experimental to merge to official vim-mode.

In visual-block mode, some motion make editor slow, freeze.

Not freezing, its just VERY slow.
You can workaround by disabling some keymap. See #214.

ex-mode?

• Very immature package vim-mode-plus-ex-mode is exists.
• My thought for ex-mode is here #52.

Want to suppress autocomplete-plus's auto suggestion except insert-mode.

Set suppressActivationForEditorClasses autocomplete-plus's config to following value.

vim-mode-plus.normal-mode, vim-mode-plus.visual-mode, vim-mode-plus.operator-pending-mode, vim-mode-plus.insert-mode.replace

If you want to directly edit config.cson, here it is.

"autocomplete-plus":
  suppressActivationForEditorClasses: [
    "vim-mode-plus.normal-mode"
    "vim-mode-plus.visual-mode"
    "vim-mode-plus.operator-pending-mode"
    "vim-mode-plus.insert-mode.replace"
  ]

Wiki

• Home

Keymap

vim-mode-plus have many advanced, experimental feature but most of it have no default keymap.
If you want to use full power of vim-mode-plus, see and experiment each keymap, command in following links.

• Commands summary of vmp's commands with keymap.
• default keymaps
• my dotfiles

Helper packages

• ListOfVimModePlusPlugins

Below is list of my packages which provide more vim-like experience.
Why I don't builtin these feature? Because it take more time and some feature is useful for non-vim user.

• cursor-history provides c-i, c-o to go/back cursor position history.
• open-this provides gf to open file under cursor.
• clip-history Not exist in pure Vim, provides clip-board history you can pop yanked text until you get result you want.
• choose-pane Not exist in pure Vim, provide keyboard navigation of between panes/panels by choosing it by label.
• paner provides ctrl-w H, J, K, L, x to move pane.

References

Vim official

• motion
• operator
• text-object
• change
• marks
• scroll
• search-commands

Other

• operator, the true power of Vim by kana.
  True power of Vim is Operator and TextOjbect.

• List of text-object as vim plugin
  vim-mode-plus builtin textobj for function, fold, entire, comment, indent, line, and any-pair(super set of many pair text-obj)

Commit emoji convention

• 📝 Add comment or doc
• 🎁 New feature.
• 🐛 Bug fix
• 💣 Breaking compatibility.
• ✅ Write test.
• 🔥 Remove something.
• 🍺 I'm happy like reduced code complexity.