2017-02-15 21:55:25 +08:00
---
title: "Documentation"
---
2017-02-10 00:52:19 +08:00
# SpaceVim Documentation
2017-02-08 23:09:16 +08:00
2017-05-09 23:20:36 +08:00
<!-- vim - markdown - toc GFM -->
2017-05-10 00:03:18 +08:00
* [Core Pillars ](#core-pillars )
2017-05-15 20:01:05 +08:00
* [Mnemonic ](#mnemonic )
* [Discoverable ](#discoverable )
* [Consistent ](#consistent )
* [Crowd-Configured ](#crowd-configured )
2017-05-10 00:03:18 +08:00
* [Highlighted features ](#highlighted-features )
* [Screenshots ](#screenshots )
2017-05-15 20:01:05 +08:00
* [welcome page ](#welcome-page )
* [working flow ](#working-flow )
2017-05-10 00:03:18 +08:00
* [Who can benefit from this? ](#who-can-benefit-from-this )
* [Update and Rollback ](#update-and-rollback )
2017-05-15 20:01:05 +08:00
* [Update SpaceVim itself ](#update-spacevim-itself )
* [Automatic Updates ](#automatic-updates )
* [Updating from the SpaceVim Buffer ](#updating-from-the-spacevim-buffer )
* [Updating Manually with git ](#updating-manually-with-git )
* [Update plugins ](#update-plugins )
2017-05-10 00:03:18 +08:00
* [Configuration layers ](#configuration-layers )
* [Custom Configuration ](#custom-configuration )
2017-05-15 20:01:05 +08:00
* [Automatic Generation ](#automatic-generation )
* [Alternative directory ](#alternative-directory )
2017-05-10 00:03:18 +08:00
* [Awesome ui ](#awesome-ui )
2017-05-15 20:01:05 +08:00
* [Colorschemes ](#colorschemes )
* [Font ](#font )
* [UI Toggles ](#ui-toggles )
* [Statusline && tabline ](#statusline--tabline )
2017-05-17 00:46:25 +08:00
* [statusline ](#statusline )
2017-05-10 00:03:18 +08:00
* [Manual ](#manual )
2017-05-15 20:01:05 +08:00
* [Completion ](#completion )
* [Unite/Denite ](#unitedenite )
* [Mappings within unite/denite buffer ](#mappings-within-unitedenite-buffer )
* [Discovering ](#discovering )
* [Mappings ](#mappings )
* [Mappings guide ](#mappings-guide )
* [Unide/Denite describe key bindings ](#unidedenite-describe-key-bindings )
* [Getting help ](#getting-help )
* [Available layers ](#available-layers )
* [Available plugins in SpaceVim ](#available-plugins-in-spacevim )
* [New packages from ELPA repositories ](#new-packages-from-elpa-repositories )
* [Toggles ](#toggles )
2017-05-15 21:39:20 +08:00
* [Navigating ](#navigating )
* [Auto-saving ](#auto-saving )
* [Searching ](#searching )
* [Editing ](#editing )
* [Multi-Encodings ](#multi-encodings )
2017-05-15 23:22:54 +08:00
* [Errors handling ](#errors-handling )
2017-05-09 23:20:36 +08:00
* [Features ](#features )
2017-05-15 20:01:05 +08:00
* [Awesome ui ](#awesome-ui-1 )
* [Mnemonic key bindings ](#mnemonic-key-bindings )
2017-05-10 00:03:18 +08:00
* [Language specific mode ](#language-specific-mode )
* [Key Mapping ](#key-mapping )
2017-05-15 20:01:05 +08:00
* [c/c++ support ](#cc-support )
* [go support ](#go-support )
* [python support ](#python-support )
2017-05-10 00:03:18 +08:00
* [Neovim centric - Dark powered mode of SpaceVim. ](#neovim-centric---dark-powered-mode-of-spacevim )
* [Modular configuration ](#modular-configuration )
* [Multiple leader mode ](#multiple-leader-mode )
2017-05-15 20:01:05 +08:00
* [Global origin vim leader ](#global-origin-vim-leader )
* [Local origin vim leader ](#local-origin-vim-leader )
* [Windows function leader ](#windows-function-leader )
* [Unite work flow leader ](#unite-work-flow-leader )
2017-05-10 00:03:18 +08:00
* [Unite centric work-flow ](#unite-centric-work-flow )
2017-05-15 20:01:05 +08:00
* [Plugin Highlights ](#plugin-highlights )
* [Non Lazy-Loaded Plugins ](#non-lazy-loaded-plugins )
* [Lazy-Loaded Plugins ](#lazy-loaded-plugins )
* [Language ](#language )
* [Commands ](#commands )
* [Commands ](#commands-1 )
* [Completion ](#completion-1 )
* [Unite ](#unite )
* [Operators & Text Objects ](#operators--text-objects )
* [Custom Key bindings ](#custom-key-bindings )
* [File Operations ](#file-operations )
* [Editor UI ](#editor-ui )
* [Window Management ](#window-management )
* [Native functions ](#native-functions )
* [Plugin: Unite ](#plugin-unite )
* [Plugin: VimFiler ](#plugin-vimfiler )
* [Plugin: neocomplete ](#plugin-neocomplete )
* [Plugin: NERD Commenter ](#plugin-nerd-commenter )
* [Plugin: Goyo and Limelight ](#plugin-goyo-and-limelight )
* [Plugin: ChooseWin ](#plugin-choosewin )
* [Plugin: Bookmarks ](#plugin-bookmarks )
* [Plugin: Gita ](#plugin-gita )
* [Plugin: vim-signify ](#plugin-vim-signify )
* [Misc Plugins ](#misc-plugins )
2017-05-09 23:20:36 +08:00
<!-- vim - markdown - toc -->
2017-02-08 23:09:16 +08:00
2017-04-30 12:14:08 +08:00
## Core Pillars
Four core pillars: Mnemonic, Discoverable, Consistent and “Crowd-Configured”.
If any of these core pillars is violated open an issue and we’
### Mnemonic
Key bindings are organized using mnemonic prefixes like b for buffer, p for project, s for search, h for help, etc…
### Discoverable
Innovative real-time display of available key bindings. Simple query system to quickly find available layers, packages, and more.
### Consistent
2017-05-09 23:20:36 +08:00
Similar functionalities have the same key binding everywhere thanks to a clearly defined set of conventions. Documentation is mandatory for any layer that ships with SpaceVim.
2017-04-30 12:14:08 +08:00
### Crowd-Configured
Community-driven configuration provides curated packages tuned by power users and bugs are fixed quickly.
2017-04-30 13:10:22 +08:00
## Highlighted features
- **Great documentation:** access documentation in Vim with
< kbd > :h SpaceVim< / kbd > .
- **Beautiful GUI:** you'll love the awesome UI and its useful features.
- **Mnemonic key bindings:** commands have mnemonic prefixes like
< kbd > [Window]< / kbd > for all the window and buffer commands or < kbd > [Unite]< / kbd > for the
unite work flow commands.
- **Lazy load plugins:** Lazy-load 90% of plugins with [dein.vim]
- **Batteries included:** discover hundreds of ready-to-use packages nicely
organised in configuration layers following a set of
[conventions ](http://spacevim.org/development/ ).
- **Neovim centric:** Dark powered mode of SpaceVim
## Screenshots
2017-04-30 14:49:09 +08:00
### welcome page
### working flow
Neovim on iTerm2 using the SpaceVim color scheme _base16-solarized-dark_
Depicts a common frontend development scenario with JavaScript (jQuery), SASS, and PHP buffers.
Non-code buffers show a Neovim terminal, a TagBar window, a Vimfiler window and a TernJS definition window.
to get more screenshots, see: [issue #415 ](https://github.com/SpaceVim/SpaceVim/issues/415 )
2017-04-30 13:10:22 +08:00
## Who can benefit from this?
- the **elementary** vim users.
- Vim users pursuing a beautiful appearance.
- Vim users wanting to lower the [risk of RSI ](http://en.wikipedia.org/wiki/Repetitive_strain_injury ).
- Vim users wanting to learn a different way to edit files.
- Vim users wanting a simple but deep configuration system.
## Update and Rollback
### Update SpaceVim itself
There are several methods of updating the core files of SpaceVim. It is recommended to update the packages first; see the next section.
#### Automatic Updates
NOTE: By default, this feature is disabled, It will slow down the startup of vim/neovim. If you like this feature, add `let g:spacevim_automatic_update = 1` to your custom configuration file.
2017-05-07 23:33:03 +08:00
SpaceVim will automatically check for a new version every startup. You must restart Vim after updating.
2017-04-30 13:10:22 +08:00
#### Updating from the SpaceVim Buffer
Use `:SPUpdate SpaceVim` in SpaceVim buffer, This command will open a buffer to show the process of updating.
#### Updating Manually with git
To update manually close Vim and update the git repository:
`git -C ~/.SpaceVim pull` .
### Update plugins
2017-04-30 14:22:28 +08:00
Use `:SPUpdate` command will update all the plugins and SpaceVim itself. after `:SPUpdate` , you can assign plugins need to be updated. Use < kbd > Tab</ kbd > to complete plugin names after `:SPUpdate` .
## Configuration layers
2017-05-07 23:33:03 +08:00
This section is an overview of layers. A more extensive introduction to writing configuration layers can be found in [SpaceVim's layers page ](http://spacevim.org/layers/ ) (recommended reading!).
2017-04-30 14:22:28 +08:00
## Custom Configuration
2017-05-07 23:33:03 +08:00
User configuration can be stored in your ~/.SpaceVim.d directory.
2017-04-30 14:22:28 +08:00
### Automatic Generation
The very first time SpaceVim starts up, it will ask you several questions and then create the `SpaceVim.d/init.vim` in your `HOME` directory.
2017-04-30 14:43:09 +08:00
### Alternative directory
2017-04-30 14:22:28 +08:00
2017-04-30 14:43:09 +08:00
`~/.SpaceVim.d/` will be added to `&runtimepath` of vim. read < kbd > :h rtp</ kbd > .
2017-04-30 14:22:28 +08:00
2017-04-30 14:43:09 +08:00
It is also possible to override the location of `~/.SpaceVim.d/` using the environment variable `SPACEVIMDIR` . Of course you can also use symlinks to change the location of this directory.
2017-04-30 14:22:28 +08:00
2017-04-30 14:43:09 +08:00
SpaceVim also support local config file for project, the init file is `.SpaceVim.d/init.vim`
in the root of your project. `.SpaceVim.d/` will also be added into runtimepath.
2017-04-30 14:22:28 +08:00
2017-04-30 14:43:09 +08:00
here is an example config file for SpaceVim:
2017-04-30 14:22:28 +08:00
2017-04-30 14:43:09 +08:00
```vim
" Here are some basic customizations, please refer to the ~/.SpaceVim.d/init.vim
" file for all possible options:
let g:spacevim_default_indent = 3
let g:spacevim_max_column = 80
" Change the default directory where all miscellaneous persistent files go.
" By default it is ~/.cache/vimfiles.
let g:spacevim_plugin_bundle_dir = '~/.cache/vimfiles'
2017-04-30 14:22:28 +08:00
2017-04-30 14:43:09 +08:00
" set SpaceVim colorscheme
let g:spacevim_colorscheme = 'jellybeans'
" Set plugin manager, you want to use, default is dein.vim
let g:spacevim_plugin_manager = 'dein' " neobundle or dein or vim-plug
" use space as `<Leader>`
let mapleader = "\<space>"
" Set windows shortcut leader [Window], default is `s`
let g:spacevim_windows_leader = 's'
" Set unite work flow shortcut leader [Unite], default is `f`
let g:spacevim_unite_leader = 'f'
2017-04-30 14:22:28 +08:00
2017-04-30 14:43:09 +08:00
" By default, language specific plugins are not loaded. This can be changed
" with the following, then the plugins for go development will be loaded.
call SpaceVim#layers#load('lang#go')
2017-04-30 14:22:28 +08:00
2017-04-30 14:43:09 +08:00
" loaded ui layer
call SpaceVim#layers#load('ui')
2017-04-30 14:22:28 +08:00
2017-04-30 14:43:09 +08:00
" If there is a particular plugin you don't like, you can define this
" variable to disable them entirely:
let g:spacevim_disabled_plugins=[
2017-05-10 00:03:18 +08:00
\ ['junegunn/fzf.vim'],
\ ]
2017-04-30 14:22:28 +08:00
2017-04-30 14:43:09 +08:00
" If you want to add some custom plugins, use these options:
let g:spacevim_custom_plugins = [
2017-05-10 00:03:18 +08:00
\ ['plasticboy/vim-markdown', {'on_ft' : 'markdown'}],
\ ['wsdjeg/GitHub.vim'],
\ ]
2017-04-30 14:22:28 +08:00
2017-04-30 14:43:09 +08:00
" set the guifont
let g:spacevim_guifont = 'DejaVu\ Sans\ Mono\ for\ Powerline\ 11'
```
2017-04-30 14:22:28 +08:00
2017-04-30 14:43:09 +08:00
Comprehensive documentation is available for each layer by < kbd > :h SpaceVim< / kbd > .
2017-04-30 14:22:28 +08:00
2017-04-30 15:34:09 +08:00
## Awesome ui
SpaceVim has a minimalistic and distraction free UI:
2017-04-30 15:53:59 +08:00
- custom airline with color feedback according to current check status
- custom icon in sign column and error feedbacks for checker.
2017-04-30 15:34:09 +08:00
### Colorschemes
The default colorscheme of SpaceVim is [gruvbox ](https://github.com/morhetz/gruvbox ). There are two variants of this colorscheme, a dark one and a light one. Some aspects of these colorscheme can be customized in the custom configuration file, read < kbd > :h gruvbox</ kbd > .
It is possible to define your default themes in your `~/.SpaceVim.d/init.vim` with the variable colorschemes. For instance, to specify [vim-one with dark colorscheme ](https://github.com/rakr/vim-one ):
```vim
let g:spacevim_colorscheme = 'one'
let g:spacevim_colorscheme_bg = 'dark'
```
2017-04-30 15:53:59 +08:00
Mappings | Description
------------- | ----------------------
< kbd > SPC T n< / kbd > | switch to next random colorscheme listed in colorscheme layer.
< kbd > SPC T s< / kbd > | select a theme using a unite buffer.
2017-04-30 15:34:09 +08:00
2017-04-30 15:53:59 +08:00
all the included colorscheme can be found in [colorscheme layer ](http://spacevim.org/layers/colorscheme/ ).
2017-04-30 15:34:09 +08:00
2017-04-30 15:53:59 +08:00
**NOTE**:
2017-04-30 15:34:09 +08:00
2017-04-30 15:53:59 +08:00
SpaceVim use true colors by default, so you should make sure your terminal support true colors. for more information see: [Colours in terminal ](https://gist.github.com/XVilka/8346728 )
2017-04-30 15:34:09 +08:00
2017-05-01 00:14:20 +08:00
### Font
The default font used by SpaceVim is DejaVu Sans Mono for Powerline. It is recommended to install it on your system if you wish to use it.
To change the default font set the variable `g:spacevim_guifont` in your `~/.SpaceVim.d/init.vim` file. By default its value is:
```vim
let g:spacevim_guifont = 'DejaVu\ Sans\ Mono\ for\ Powerline\ 11'
```
If the specified font is not found, the fallback one will be used (depends on your system). Also note that changing this value has no effect if you are running Vim/Neovim in terminal.
### UI Toggles
Some UI indicators can be toggled on and off (toggles start with t and T):
Key Binding | Description
----------- | -----------
SPC t 8 | highlight any character past the 80th column
SPC t f | display the fill column (by default the fill column is set to 80)
SPC t h h | toggle highlight of the current line
SPC t h i | toggle highlight indentation levels
SPC t h c | toggle highlight indentation current column
SPC t h s | toggle syntax highlighting
SPC t i | toggle indentation guide at point
SPC t n | toggle line numbers
2017-05-12 23:43:03 +08:00
SPC t b | toggle background
SPC t t | open tabs manager
2017-05-01 00:14:20 +08:00
SPC T ~ | display ~ in the fringe on empty lines
SPC T F | toggle frame fullscreen
SPC T f | toggle display of the fringe
SPC T m | toggle menu bar
SPC T t | toggle tool bar
2017-04-30 15:34:09 +08:00
2017-05-03 20:05:33 +08:00
### Statusline && tabline
The statusline and tabline is a heavily customized [airline ](https://github.com/vim-airline/vim-airline ) with the following capabilities:
- tabline index of each buffer or tab.
- vim mode (INSERT/NORMAL etc.)
- git info : diff/branch
- checker info: numbers of errors and warnings.
- trailing line number.
2017-05-17 00:46:25 +08:00
Key Binding | Description
----------- | -----------
`SPC [1-9]` | jump to the index of tabline.
#### statusline
The `core#statusline` layer provide a heavily customized powerline with the following capabilities:, It is inspired by spacemacs's mode-line.
- show the window number
- color code for current state
2017-05-19 00:09:15 +08:00
- show the number of search results
- toggle syntax checking info
2017-05-17 00:46:25 +08:00
- toggle battery info
- toggle minor mode lighters
Reminder of the color codes for the states:
2017-05-03 20:05:33 +08:00
2017-05-19 00:09:15 +08:00
Mode | Color
--- | ---
Normal | Orange
Insert | Green
Visual | Grey
all the colors based on the current colorscheme
Some elements can be dynamically toggled:
Key Binding | Description
----------- | -----------
`SPC t m b` | toggle the battery status (need to install acpi)
`SPC t m c` | toggle the org task clock (available in org layer)
`SPC t m m` | toggle the minor mode lighters
`SPC t m M` | toggle the major mode
`SPC t m n` | toggle the cat! (if colors layer is declared in your dotfile)
`SPC t m p` | toggle the point character position
`SPC t m t` | toggle the time
`SPC t m T` | toggle the mode line itself
`SPC t m v` | toggle the version control info
2017-05-19 13:19:03 +08:00
**Powerline font installation:**
2017-05-19 13:59:02 +08:00
By defalut SpaceVim use [DejaVu Sans Mono for Powerline ](https://github.com/powerline/fonts/tree/master/DejaVuSansMono ), to make statusline render correctly, you need to install the font. [powerline extra symbols ](https://github.com/ryanoasis/powerline-extra-symbols ) also should be installed.
2017-05-19 13:19:03 +08:00
**syntax checking integration:**
When syntax checking minor mode is enabled, a new element appears showing the number of errors, warnings.
syntax checking integration in statusline.
2017-05-22 22:02:36 +08:00
**Search index integration:**
2017-05-19 13:19:03 +08:00
2017-05-22 22:02:36 +08:00
Search index shows the number of occurrence when performing a search via `/` or `?` . SpaceVim integrates nicely the search status by displaying it temporarily when n or N are being pressed. See the 20/22 segment on the screenshot below.
2017-05-19 13:19:03 +08:00
2017-05-22 22:34:08 +08:00
2017-05-22 22:02:36 +08:00
_search index in statusline_
2017-05-19 13:19:03 +08:00
2017-05-19 00:09:15 +08:00
**Battery status integration:**
2017-05-19 13:19:03 +08:00
_acpi_ displays the percentage of total charge of the battery as well as the time remaining to charge or discharge completely the battery.
2017-05-19 00:09:15 +08:00
A color code is used for the battery status:
Battery State | Color
------------ | ----
Charging | Green
Discharging | Orange
Critical | Red
2017-05-03 20:05:33 +08:00
2017-05-19 13:40:42 +08:00
all the colors based on the current colorscheme
**Statusline separators:**
It is possible to easily customize the statusline separator by setting the `g:spacevim_statusline_separator` variable in your custon configration file and then redraw the statusline. For instance if you want to set back the separator to the well-known arrow separator add the following snippet to your configuration file:
```vim
let g:spacevim_statusline_separator = 'arrow'
```
here is an exhaustive set of screenshots for all the available separator:
Separator | Screenshot
--------- | ----------
2017-05-19 13:59:02 +08:00
`arrow` | 
2017-05-19 20:45:03 +08:00
`curve` | 
2017-05-19 20:54:34 +08:00
`slant` | 
2017-05-19 21:34:39 +08:00
`nil` | 
2017-05-22 22:02:36 +08:00
`fire` | 
2017-05-19 13:40:42 +08:00
2017-05-22 22:34:08 +08:00
**Minor Modes:**
The minor mode area can be toggled on and off with `SPC t m m`
Unicode symbols are displayed by default. Setting the variable `g:spacevim_statusline_unicode_symbols` to nil in your custom configuration file will display ASCII characters instead (may be useful in terminal if you cannot set an appropriate font).
The letters displayed in the statusline correspond to the key bindings used to toggle them.
Key Binding | Unicode | ASCII | Mode
----------- | ------- | ----- | ----
`SPC t 8` | ⑧ | 8 | toggle highlight of characters for long lines
`SPC t f` | ⓕ | f | fill-column-indicator mode
`SPC t s` | ⓢ | s | syntax checking (neomake)
`SPC t S` | Ⓢ | S | enabled in spell checking
`SPC t w` | ⓦ | w | whitespace mode
2017-05-19 13:40:42 +08:00
2017-05-03 22:51:29 +08:00
## Manual
2017-05-10 00:03:18 +08:00
### Completion
#### Unite/Denite
please checkout the documentation of unite and denite via `:h unite` and `:h denite` .
##### Mappings within unite/denite buffer
Mappings | Mode | description
-------- | ---- | -----------
`Ctrl` +`h/k/l/r` | Normal | Un-map
2017-05-10 00:15:25 +08:00
`Ctrl` +`l` | Normal | Redraw
2017-05-10 00:03:18 +08:00
`Tab` | Insert | Select next line
2017-05-10 00:15:25 +08:00
`Tab` | Normal | Select actions
2017-05-10 00:03:18 +08:00
`Shift` + `Tab` | Insert | Select previous line
2017-05-10 00:15:25 +08:00
`Space` | Normal | Toggle mark current candidate, up
`Enter` | Normal | Run default action
2017-05-10 00:03:18 +08:00
`Ctrl` +`v` | Normal | Open in a split
`Ctrl` +`s` | Normal | Open in a vertical split
`Ctrl` +`t` | Normal | Open in a new tab
2017-05-10 00:15:25 +08:00
`Ctrl` + `g` | Normal | Exit unite
`jk` | Insert | Leave Insert mode
2017-05-10 00:03:18 +08:00
`r` | Normal | Replace ('search' profile) or rename
`Ctrl` +`z` | Normal/insert | Toggle transpose window
`Ctrl` +`w` | Insert | Delete backward path
2017-05-03 22:51:29 +08:00
### Discovering
#### Mappings
##### Mappings guide
A guide buffer is displayed each time the prefix key is pressed in normal mode. It lists the available key bindings and their short description.
2017-05-07 23:33:03 +08:00
The prefix can be `[SPC]` , `[Window]` , `[denite]` , `<leader>` and `[unite]` .
2017-05-03 22:51:29 +08:00
The default key of these prefix is:
2017-05-07 23:33:03 +08:00
Prefix name | custom option and default value | description
----------- | -------------------------------------- | -----------
`[SPC]` | NONE / `<Space>` | default mapping prefix of SpaceVim
`[Window]` | `g:spacevim_windows_leader` / `s` | window mapping prefix of SpaceVim
`[denite]` | `g:spacevim_denite_leader` / `F` | denite mapping prefix of SpaceVim
`[unite]` | `g:spacevim_unite_leader` / `f` | unite mapping prefix of SpaceVim
`<leader>` | `mapleader` / ``\`` | default leader prefix of vim/neovim
By default the guide buffer will be displayed 1000ms after the key has been pressed. You can change the delay by setting `'timeoutlen'` option to your liking (the value is in milliseconds).
for example, after pressing `<Space>` in normal mode, you will see :
this guide show you all the available key bindings begin with `[SPC]` , you can type `b` for all the buffer mappings, `p` for project mappings, etc. after pressing `<C-h>` in guide buffer, you will get paging and help info in the statusline.
2017-05-10 00:03:18 +08:00
key | description
2017-05-07 23:33:03 +08:00
---- | -----
2017-05-10 00:03:18 +08:00
`u` | undo pressing
`n` | next page of guide buffer
`p` | previous page of guide buffer
2017-05-07 23:33:03 +08:00
2017-05-14 22:14:38 +08:00
to defined custom SPC mappings, use `SpaceVim#custom#SPC()` . here is an example:
```vim
call SpaceVim#custom#SPC('nnoremap', ['f', 't'], 'echom "hello world"', 'test custom SPC', 1)
```
2017-05-07 23:33:03 +08:00
##### Unide/Denite describe key bindings
It is possible to search for specific key bindings by pressing `?` in the root of guide buffer.
To narrow the list, just insert the mapping keys or description of what mapping you want, Unite/Denite will fuzzy find the mappings, to find buffer related mappings:
then use `<Tab>` or `<Up>` and `<Down>` to select the mapping, press `<Enter>` will execute that command.
#### Getting help
Denite/Unite is powerful tool to unite all interfaces. it was meant to be like [Helm ](https://github.com/emacs-helm/helm ) for Vim. These mappings is for getting help info about functions, variables etc:
Mappings | Description
-------- | ------------
SPC h SPC | discover SpaceVim documentation, layers and packages using unite
SPC h i | get help with the symbol at point
SPC h k | show top-level bindings with which-key
SPC h m | search available man pages
Reporting an issue:
Mappings | Description
-------- | ------------
SPC h I | Open SpaceVim GitHub issue page with pre-filled information
#### Available layers
2017-05-09 21:55:01 +08:00
All layers can be easily discovered via `:SPLayer -l` accessible with `SPC h l` .
2017-05-09 23:20:36 +08:00
##### Available plugins in SpaceVim
2017-05-09 21:55:01 +08:00
2017-05-09 23:20:36 +08:00
All plugins can be easily discovered via `<leader> l p` .
2017-05-07 23:33:03 +08:00
##### New packages from ELPA repositories
2017-05-09 23:20:36 +08:00
#### Toggles
2017-05-07 23:33:03 +08:00
2017-05-15 21:39:20 +08:00
### Navigating
### Auto-saving
### Searching
### Editing
#### Multi-Encodings
SpaceVim use utf-8 as default encoding. there are four options for these case:
2017-05-15 22:20:58 +08:00
- fileencodings (fencs): ucs-bom,utf-8,default,latin1
- fileencoding (fenc): utf-8
- encoding (enc): utf-8
- termencoding (tenc): utf-8 (only supported in vim)
to fix messy display: `SPC e a` is the mapping for auto detect the file encoding. after detecting file encoding, you can run the command below to fix the encoding:
```vim
set enc=utf-8
write
```
2017-05-15 23:22:54 +08:00
### Errors handling
2017-05-15 21:39:20 +08:00
2017-05-15 23:22:54 +08:00
SpaceVim uses [neomake ](https://github.com/neomake/neomake ) to gives error feedback on the fly. The checks are only performed at save time by default.
2017-05-15 21:39:20 +08:00
2017-05-15 23:22:54 +08:00
Errors management mappings (start with e):
2017-05-03 22:51:29 +08:00
2017-05-15 23:22:54 +08:00
Mappings | Description
-------- | -----------
`SPC t s` | toggle syntax checker
`SPC e c` | clear all errors
`SPC e h` | describe a syntax checker
`SPC e l` | toggle the display of the list of errors/warnings
`SPC e n` | go to the next error
`SPC e p` | go to the previous error
`SPC e v` | verify syntax checker setup (useful to debug 3rd party tools configuration)
`SPC e .` | error transient state
The next/previous error mappings and the error transient state can be used to browse errors from syntax checkers as well as errors from location list buffers, and indeed anything that supports vim's location list. This includes for example search results that have been saved to a location list buffer.
Custom sign symbol:
Symbol | Description | Custom option
------ | ----------- | -------------
`✖` | Error | `g:spacevim_error_symbol`
`➤` | warning | `g:spacevim_warning_symbol`
2017-05-03 22:51:29 +08:00
2017-05-10 00:03:18 +08:00
## Features
2017-02-08 23:09:16 +08:00
2017-05-10 00:03:18 +08:00
### Awesome ui
2017-02-08 23:09:16 +08:00
- outline + filemanager + checker
2017-05-15 21:39:20 +08:00
2017-02-08 23:09:16 +08:00
2017-05-10 00:03:18 +08:00
### Mnemonic key bindings
2017-04-22 23:22:33 +08:00
Key bindings are organized using mnemonic prefixes like b for buffer, p for project, s for search, h for help, etc…
2017-04-29 16:43:11 +08:00
**SPC mapping root** : SPC means `<Space>` on the keyboard.
2017-04-26 21:53:37 +08:00
2017-04-26 21:50:39 +08:00
Key | Description
------------- | ----------------------
2017-04-29 15:37:39 +08:00
< kbd > SPC !< / kbd > | shell cmd
2017-04-26 21:50:39 +08:00
< kbd > SPC a< / kbd > | +applications
< kbd > SPC b< / kbd > | +buffers
2017-04-29 15:37:39 +08:00
< kbd > SPC 1...9< / kbd > | windows 1...9
2017-04-26 21:50:39 +08:00
2017-02-10 21:37:20 +08:00
## Language specific mode
2017-02-08 23:09:16 +08:00
2017-03-16 23:42:51 +08:00
## Key Mapping
< iframe width = '853' height = '480' src = 'https://embed.coggle.it/diagram/WMlKuKS0uwABF2j1/a35e36df1d64e7b4f5fd7f956bf97a16b194cadb92d82d83e25aaf489349b0d8' frameborder = '0' allowfullscreen > < / iframe >
2017-02-10 21:37:20 +08:00
### c/c++ support
2017-02-08 23:09:16 +08:00
1. code completion: autocompletion and fuzzy match.
2017-02-10 21:37:20 +08:00
2017-02-08 23:09:16 +08:00
2. syntax check: Asynchronous linting and make framework.
2017-02-10 21:37:20 +08:00
### go support
2017-02-08 23:09:16 +08:00
1. code completion:
2017-02-10 21:37:20 +08:00
2017-02-08 23:09:16 +08:00
2. syntax check:
2017-02-10 21:37:20 +08:00
### python support
2017-02-08 23:09:16 +08:00
1. code completion:
2017-02-10 21:37:20 +08:00
2017-02-08 23:09:16 +08:00
2. syntax check:
2017-02-10 21:37:20 +08:00
2017-02-08 23:09:16 +08:00
2017-02-10 21:37:20 +08:00
## Neovim centric - Dark powered mode of SpaceVim.
2017-02-08 23:09:16 +08:00
By default, SpaceVim use these dark powered plugins:
1. [deoplete.nvim ](https://github.com/Shougo/deoplete.nvim ) - Dark powered asynchronous completion framework for neovim
2. [dein.vim ](https://github.com/Shougo/dein.vim ) - Dark powered Vim/Neovim plugin manager
TODO:
1. [defx.nvim ](https://github.com/Shougo/defx.nvim ) - Dark powered file explorer
2. [deoppet.nvim ](https://github.com/Shougo/deoppet.nvim ) - Dark powered snippet plugin
3. [denite.nvim ](https://github.com/Shougo/denite.nvim ) - Dark powered asynchronous unite all interfaces for Neovim/Vim8
2017-02-10 21:37:20 +08:00
## Modular configuration
2017-02-08 23:09:16 +08:00
2017-02-10 21:37:20 +08:00
## Multiple leader mode
2017-02-08 23:09:16 +08:00
2017-05-09 23:20:36 +08:00
### Global origin vim leader
2017-02-08 23:09:16 +08:00
2017-02-10 21:37:20 +08:00
Vim's origin global leader can be used in all modes.
2017-02-08 23:09:16 +08:00
2017-05-09 23:20:36 +08:00
### Local origin vim leader
2017-02-08 23:09:16 +08:00
2017-02-10 21:37:20 +08:00
Vim's origin local leader can be used in all the mode.
2017-02-08 23:09:16 +08:00
2017-05-09 23:20:36 +08:00
### Windows function leader
2017-02-08 23:09:16 +08:00
Windows function leader can only be used in normal mode.
For the list of mappings see the [link ](#window-management )
2017-02-10 21:37:20 +08:00
2017-05-09 23:20:36 +08:00
### Unite work flow leader
2017-02-10 21:37:20 +08:00
2017-02-08 23:09:16 +08:00
Unite work flow leader can only be used in normal mode. Unite leader need unite groups.
2017-02-10 21:37:20 +08:00
## Unite centric work-flow
2017-03-16 23:42:51 +08:00
2017-02-08 23:09:16 +08:00
- List all the plugins has been installed, fuzzy find what you want, default action is open the github website of current plugin. default key is `<leader>lp`
2017-05-10 00:03:18 +08:00
2017-02-08 23:09:16 +08:00
- List all the mappings and description: `f<space>`
2017-05-10 00:03:18 +08:00
2017-02-08 23:09:16 +08:00
- List all the starred repos in github.com, fuzzy find and open the website of the repo. default key is `<leader>ls`
2017-05-10 00:03:18 +08:00
2017-02-08 23:09:16 +08:00
#### Plugin Highlights
- Package management with caching enabled and lazy loading
- Project-aware tabs and label
- Vimfiler as file-manager + SSH connections
- Go completion via vim-go and gocode
- Javascript completion via Tern
- PHP completion, indent, folds, syntax
- Python jedi completion, pep8 convention
- Languages: Ansible, css3, csv, json, less, markdown, mustache
- Helpers: Undo tree, bookmarks, git, tmux navigation,
hex editor, sessions, and much more.
_Note_ that 90% of the plugins are ** [lazy-loaded]**.
[lazy-loaded]: ./config/plugins.vim
#### Non Lazy-Loaded Plugins
Name | Description
-------------- | ----------------------
[dein.vim] | Dark powered Vim/Neovim plugin manager
[vimproc] | Interactive command execution
[colorschemes] | Awesome color-schemes
[file-line] | Allow opening a file in a given line
[neomru] | MRU source for Unite
[cursorword] | Underlines word under cursor
[gitbranch] | Lightweight git branch detection
[gitgutter] | Shows git diffs in the gutter
[tinyline] | Tiny great looking statusline
[tagabana] | Central location for all tags
[bookmarks] | Bookmarks, works independently from vim marks
[tmux-navigator] | Seamless navigation between tmux panes and vim splits
#### Lazy-Loaded Plugins
##### Language
Name | Description
-------------- | ----------------------
[html5] | HTML5 omnicomplete and syntax
[mustache] | Mustache and handlebars syntax
[markdown] | Markdown syntax highlighting
[ansible-yaml] | Additional support for Ansible
[jinja] | Jinja support in vim
[less] | Syntax for LESS
[css3-syntax] | CSS3 syntax support to vim's built-in `syntax/css.vim`
[csv] | Handling column separated data
[pep8-indent] | Nicer Python indentation
[logstash] | Highlights logstash configuration files
[tmux] | vim plugin for tmux.conf
[json] | Better JSON support
[toml] | Syntax for TOML
[i3] | i3 window manager config syntax
[Dockerfile] | syntax and snippets for Dockerfile
[go] | Go development
[jedi-vim] | Python jedi autocompletion library
[ruby] | Ruby configuration files
[portfile] | Macports portfile configuration files
[javascript] | Enhanced Javascript syntax
[javascript-indent] | Javascript indent script
[tern] | Provides Tern-based JavaScript editing support
[php] | Up-to-date PHP syntax file
[phpfold] | PHP folding
[phpcomplete] | Improved PHP omnicompletion
[phpindent] | PHP official indenting
[phpspec] | PhpSpec integration
##### Commands
Name | Description
-------------- | ----------------------
[vimfiler] | Powerful file explorer
[NERD Commenter] | Comment tool - no comment necessary
[vinarise] | Hex editor
[syntastic] | Syntax checking hacks
[gita] | An awesome git handling plugin
[gista] | Manipulate gists in Vim
[undotree] | Ultimate undo history visualizer
[incsearch] | Improved incremental searching
[expand-region] | Visually select increasingly larger regions of text
[open-browser] | Open URI with your favorite browser
[prettyprint] | Pretty-print vim variables
[quickrun] | Run commands quickly
[ref] | Integrated reference viewer
[dictionary] | Dictionary.app interface
[vimwiki] | Personal Wiki for Vim
[thesaurus] | Look up words in an online thesaurus
##### Commands
Name | Description
-------------- | ----------------------
[goyo] | Distraction-free writing
[limelight] | Hyperfocus-writing
[matchit] | Intelligent pair matching
[indentline] | Display vertical indention lines
[choosewin] | Choose window to use, like tmux's 'display-pane'
##### Completion
Name | Description
-------------- | ----------------------
[delimitmate] | Insert mode auto-completion for quotes, parenthesis, brackets
[echodoc] | Print objects' documentation in echo area
[deoplete] | Neovim: Dark powered asynchronous completion framework
[neocomplete] | Next generation completion framework
[neosnippet] | Contains neocomplete snippets source
##### Unite
Name | Description
-------------- | ----------------------
[unite] | Unite and create user interfaces
[unite-colorscheme] | Browse colorschemes
[unite-filetype] | Select file type
[unite-history] | Browse history of command/search
[unite-build] | Build with Unite interface
[unite-outline] | File "outline" source for unite
[unite-tag] | Tags source for Unite
[unite-quickfix] | Quickfix source for Unite
[neossh] | SSH interface for plugins
[unite-pull-request] | GitHub pull-request source for Unite
[junkfile] | Create temporary files for memo and testing
[unite-issue] | Issue manager for JIRA and GitHub
##### Operators & Text Objects
Name | Description
-------------- | ----------------------
[operator-user] | Define your own operator easily
[operator-replace] | Operator to replace text with register content
[operator-surround] | Operator to enclose text objects
[textobj-user] | Create your own text objects
[textobj-multiblock] | Handle multiple brackets objects
#### Custom Key bindings
Key | Mode | Action
----- |:----:| ------------------
`<leader>` +`y` | visual | Copy selection to X11 clipboard ("+y)
`Ctrl` +`c` | Normal | Copy full path of current buffer to X11 clipboard
`<leader>` +`Ctrl`+`c` | Normal | Copy github.com url of current buffer to X11 clipboard(if it is a github repo)
`<leader>` +`Ctrl`+`l` | Normal/visual | Copy github.com url of current lines to X11 clipboard(if it is a github repo)
`<leader>` +`p` | Normal/visual | Paste selection from X11 clipboard ("+p)
`Ctrl` +`f` | Normal | Smart page forward (C-f/C-d)
`Ctrl` +`b` | Normal | Smart page backwards (C-b/C-u)
`Ctrl` +`e` | Normal | Smart scroll down (3C-e/j)
`Ctrl` +`y` | Normal | Smart scroll up (3C-y/k)
`Ctrl` +`q` | Normal | `Ctrl` +`w`
`Ctrl` +`x` | Normal | Switch buffer and placement
`Up,Down` | Normal | Smart up and down
`}` | Normal | After paragraph motion go to first non-blank char (}^)
`<` | Visual/Normal | Indent to left and re-select
`>` | Visual/Normal | Indent to right and re-select
`Tab` | Visual | Indent to right and re-select
`Shift` +`Tab` | Visual | Indent to left and re-select
`gp` | Normal | Select last paste
`Q` /`gQ` | Normal | Disable EX-mode (< Nop > )
`Ctrl` +`a` | Command | Navigation in command line
`Ctrl` +`b` | Command | Move cursor backward in command line
`Ctrl` +`f` | Command | Move cursor forward in command line
##### File Operations
Key | Mode | Action
----- |:----:| ------------------
`<leader>` +`cd` | Normal | Switch to the directory of the open buffer
`<leader>` +`w` | Normal/visual | Write (:w)
`Ctrl` +`s` | Normal/visual/Command | Write (:w)
`:w!!` | Command | Write as root (%!sudo tee > /dev/null %)
##### Editor UI
Key | Mode | Action
----- |:----:| ------------------
`F2` | _All_ | Toggle tagbar
`F3` | _All_ | Toggle Vimfiler
2017-02-27 22:41:18 +08:00
`<leader>` + num | Normal | Jump to the buffer whit the num index
`<Alt>` + num | Normal | Jump to the buffer whit the num index, this only works in neovim
`<Alt>` + `h` /`< Left > ` | Normal | Jump to left buffer in the tabline, this only works in neovim
`<Alt>` + `l` /`< Right > ` | Normal | Jump to Right buffer in the tabline, this only works in neovim
2017-02-08 23:09:16 +08:00
`<leader>` +`ts` | Normal | Toggle spell-checker (:setlocal spell!)
`<leader>` +`tn` | Normal | Toggle line numbers (:setlocal nonumber!)
`<leader>` +`tl` | Normal | Toggle hidden characters (:setlocal nolist!)
`<leader>` +`th` | Normal | Toggle highlighted search (:set hlsearch!)
`<leader>` +`tw` | Normal | Toggle wrap (:setlocal wrap! breakindent!)
`g0` | Normal | Go to first tab (:tabfirst)
`g$` | Normal | Go to last tab (:tablast)
`gr` | Normal | Go to previous tab (:tabprevious)
`Ctrl` +`< Dow > ` | Normal | Move to split below (< C-w > j)
`Ctrl` +`< Up > ` | Normal | Move to upper split (< C-w > k)
`Ctrl` +`< Left > ` | Normal | Move to left split (< C-w > h)
`Ctrl` +`< Right > ` | Normal | Move to right split (< C-w > l)
`*` | Visual | Search selection forwards
`#` | Visual | Search selection backwards
`,` +`Space` | Normal | Remove all spaces at EOL
`Ctrl` +`r` | Visual | Replace selection
`<leader>` +`lj` | Normal | Next on location list
`<leader>` +`lk` | Normal | Previous on location list
`<leader>` +`S` | Normal/visual | Source selection
##### Window Management
Key | Mode | Action
----- |:----:| ------------------
`q` | Normal | Smart buffer close
`s` +`p` | Normal | Split nicely
`s` +`v` | Normal | :split
`s` +`g` | Normal | :vsplit
`s` +`t` | Normal | Open new tab (:tabnew)
`s` +`o` | Normal | Close other windows (:only)
`s` +`x` | Normal | Remove buffer, leave blank window
`s` +`q` | Normal | Closes current buffer (:close)
2017-03-10 20:36:26 +08:00
`s` +`Q` | Normal | Removes current buffer, left buffer in the tabline will be displayed, if there is no buffer on the left, the right buffer will be displayed, if this is the last buffer in the tabline, then an empty buffer will be displayed.
2017-02-08 23:09:16 +08:00
`Tab` | Normal | Next window or tab
`Shift` +`Tab` | Normal | Previous window or tab
`<leader>` +`sv` | Normal | Split with previous buffer
`<leader>` +`sg` | Normal | Vertical split with previous buffer
2017-02-27 22:41:18 +08:00
SpaceVim has mapped normal < kbd > q< / kbd > as smart buffer close, the normal func of < kbd > q< / kbd >
can be get by < kbd > `< leader > ` q r< / kbd >
##### Native functions
Key | Mode | Action
----- |:----:| ------------------
`<leader>` + `qr` | Normal | Same as native `q`
`<leader>` + `qr/` | Normal | Same as native `q/` , open cmdwin
`<leader>` + `qr?` | Normal | Same as native `q?` , open cmdwin
`<leader>` + `qr:` | Normal | Same as native `q:` , open cmdwin
2017-02-08 23:09:16 +08:00
##### Plugin: Unite
Key | Mode | Action
----- |:----:| ------------------
`[unite]` | Normal | unite leader, default is `f` , `:h g:spacevim_unite_leader`
`[unite]` +`r` | Normal | Resumes Unite window
`[unite]` +`f` | Normal | Opens Unite file recursive search
`[unite]` +`i` | Normal | Opens Unite git file search
`[unite]` +`g` | Normal | Opens Unite grep with ag (the_silver_searcher)
`[unite]` +`u` | Normal | Opens Unite source
`[unite]` +`t` | Normal | Opens Unite tag
`[unite]` +`T` | Normal | Opens Unite tag/include
`[unite]` +`l` | Normal | Opens Unite location list
`[unite]` +`q` | Normal | Opens Unite quick fix
`[unite]` +`e` | Normal | Opens Unite register
`[unite]` +`j` | Normal | Opens Unite jump, change
`[unite]` +`h` | Normal | Opens Unite history/yank
`[unite]` +`s` | Normal | Opens Unite session
`[unite]` +`n` | Normal | Opens Unite session/new
`[unite]` +`o` | Normal | Opens Unite outline
`[unite]` +`c` | Normal | Opens Unite buffer bookmark file in current directory
`[unite]` +`b` | Normal | Opens Unite buffer bookmark file in buffer directory
`[unite]` +`ma` | Normal | Opens Unite mapping
`[unite]` +`< space > ` | Normal | Opens Unite menu:CustomKeyMaps
`[unite]` +`me` | Normal | Opens Unite output messages
`<leader>` +`bl` | Normal | Opens Unite buffers, mru, bookmark
`<leader>` +`ta` | Normal | Opens Unite tab
`<leader>` +`ugf` | Normal | Opens Unite file with word at cursor
`<leader>` +`ugt` | Normal/visual | Opens Unite tag with word at cursor
##### Plugin: VimFiler
Key | Mode | Action
----- |:----:| ------------------
`<F3>` | Normal | Toggle file explorer
| **Within _VimFiler_ buffers** |||
`Ctrl` +`j` | Normal | Un-map
`Ctrl` +`l` | Normal | Un-map
`E` | Normal | Un-map
`sv` | Normal | Split edit
`sg` | Normal | Vertical split edit
`p` | Normal | Preview
`i` | Normal | Switch to directory history
`v` | Normal | Quick look
`gx` | Normal | Execute with vimfiler associated
`'` | Normal | Toggle mark current line
`V` | Normal | Clear all marks
`Ctrl` +`r` | Normal | Redraw
##### Plugin: neocomplete
Key | Mode | Action
----- |:----:| ------------------
`Enter` | Insert | Smart snippet expansion
`Ctrl` +`space` | Insert | Autocomplete with Unite
`Tab` | Insert/select | Smart tab movement or completion
`Ctrl` +`j/k/f/b` | Insert | Movement in popup
`Ctrl` +`g` | Insert | Undo completion
`Ctrl` +`l` | Insert | Complete common string
`Ctrl` +`o` | Insert | Expand snippet
`Ctrl` +`y` | Insert | Close pop-up
`Ctrl` +`e` | Insert | Close pop-up
`Ctrl` +`l` | Insert | Complete common string
`Ctrl` +`d` | Insert | Scroll down
`Ctrl` +`u` | Insert | Scroll up
##### Plugin: NERD Commenter
Key | Mode | Action
----- |:----:| ------------------
`<leader>` +`cc` | Normal/visual | Comment out the current line or text selected in visual mode.
`<leader>` +`cn` | Normal/visual | Same as cc but forces nesting.
`<leader>` +`cu` | Normal/visual | Uncomments the selected line(s).
`<leader>` +`cs` | Normal/visual | Comments out the selected lines with a pretty block formatted layout.
`<leader>` +`cy` | Normal/visual | Same as cc except that the commented line(s) are yanked first.
##### Plugin: Goyo and Limelight
Key | Mode | Action
----- |:----:| ------------------
`<leader>` +`G` | Normal | Toggle distraction-free writing
##### Plugin: ChooseWin
Key | Mode | Action
----- |:----:| ------------------
`-` | Normal | Choose a window to edit
`<leader>` +`-` | Normal | Switch editing window with selected
##### Plugin: Bookmarks
Key | Mode | Action
----- |:----:| ------------------
`m` +`a` | Normal | Show list of all bookmarks
`m` +`m` | Normal | Toggle bookmark in current line
`m` +`n` | Normal | Jump to next bookmark
`m` +`p` | Normal | Jump to previous bookmark
`m` +`i` | Normal | Annotate bookmark
2017-02-27 22:41:18 +08:00
As SpaceVim use above bookmarks mappings, so you can not use `a` , `m` , `n` , `p` or `i` registers to mark current position, but other registers should works will. if you really need to use these registers, you can add `nnoremap <leader>m m` to your custom configuration, then you use use `a` registers via `\ma`
2017-02-08 23:09:16 +08:00
##### Plugin: Gita
Key | Mode | Action
----- |:----:| ------------------
`<leader>` +`gs` | Normal | Git status
`<leader>` +`gd` | Normal | Git diff
`<leader>` +`gc` | Normal | Git commit
`<leader>` +`gb` | Normal | Git blame
`<leader>` +`gp` | Normal | Git push
##### Plugin: vim-signify
Key | Mode | Action
----- |:----:| ------------------
`<leader>` +`hj` / `]c` | Normal | Jump to next hunk
`<leader>` +`hk` / `[c` | Normal | Jump to previous hunk
`<leader>` +`hJ` / `]C` | Normal | Jump to last hunk
`<leader>` +`hK` / `[C` | Normal | Jump to first hunk
##### Misc Plugins
Key | Mode | Action
----- |:----:| ------------------
`<leader>` +`gu` | Normal | Open undo tree
`<leader>` +`i` | Normal | Toggle indentation lines
`<leader>` +`j` | Normal | Start smalls
`<leader>` +`r` | Normal | Quickrun
`<leader>` +`?` | Normal | Dictionary
`<leader>` +`W` | Normal | Wiki
`<leader>` +`K` | Normal | Thesaurus
<!-- plublic links -->
[dein.vim]: https://github.com/Shougo/dein.vim
[vimproc]: https://github.com/Shougo/vimproc.vim
[colorschemes]: https://github.com/rafi/awesome-vim-colorschemes
[file-line]: https://github.com/bogado/file-line
[neomru]: https://github.com/Shougo/neomru.vim
[cursorword]: https://github.com/itchyny/vim-cursorword
[gitbranch]: https://github.com/itchyny/vim-gitbranch
[gitgutter]: https://github.com/airblade/vim-gitgutter
[bookmarks]: https://github.com/MattesGroeger/vim-bookmarks
[tmux-navigator]: https://github.com/christoomey/vim-tmux-navigator
[tinyline]: https://github.com/rafi/vim-tinyline
[tagabana]: https://github.com/rafi/vim-tagabana
[html5]: https://github.com/othree/html5.vim
[mustache]: https://github.com/mustache/vim-mustache-handlebars
[markdown]: https://github.com/rcmdnk/vim-markdown
[ansible-yaml]: https://github.com/chase/vim-ansible-yaml
[jinja]: https://github.com/mitsuhiko/vim-jinja
[less]: https://github.com/groenewege/vim-less
[css3-syntax]: https://github.com/hail2u/vim-css3-syntax
[csv]: https://github.com/chrisbra/csv.vim
[pep8-indent]: https://github.com/hynek/vim-python-pep8-indent
[logstash]: https://github.com/robbles/logstash.vim
[tmux]: https://github.com/tmux-plugins/vim-tmux
[json]: https://github.com/elzr/vim-json
[toml]: https://github.com/cespare/vim-toml
[i3]: https://github.com/PotatoesMaster/i3-vim-syntax
[Dockerfile]: https://github.com/ekalinin/Dockerfile.vim
[go]: https://github.com/fatih/vim-go
[jedi-vim]: https://github.com/davidhalter/jedi-vim
[ruby]: https://github.com/vim-ruby/vim-ruby
[portfile]: https://github.com/jstrater/mpvim
[javascript]: https://github.com/jelera/vim-javascript-syntax
[javascript-indent]: https://github.com/jiangmiao/simple-javascript-indenter
[tern]: https://github.com/marijnh/tern_for_vim
[php]: https://github.com/StanAngeloff/php.vim
[phpfold]: https://github.com/rayburgemeestre/phpfolding.vim
[phpcomplete]: https://github.com/shawncplus/phpcomplete.vim
[phpindent]: https://github.com/2072/PHP-Indenting-for-VIm
[phpspec]: https://github.com/rafi/vim-phpspec
[vimfiler]: https://github.com/Shougo/vimfiler.vim
[tinycomment]: https://github.com/rafi/vim-tinycomment
[vinarise]: https://github.com/Shougo/vinarise.vim
[syntastic]: https://github.com/scrooloose/syntastic
[gita]: https://github.com/lambdalisue/vim-gita
[gista]: https://github.com/lambdalisue/vim-gista
[undotree]: https://github.com/mbbill/undotree
[incsearch]: https://github.com/haya14busa/incsearch.vim
[expand-region]: https://github.com/terryma/vim-expand-region
[open-browser]: https://github.com/tyru/open-browser.vim
[prettyprint]: https://github.com/thinca/vim-prettyprint
[quickrun]: https://github.com/thinca/vim-quickrun
[ref]: https://github.com/thinca/vim-ref
[dictionary]: https://github.com/itchyny/dictionary.vim
[vimwiki]: https://github.com/vimwiki/vimwiki
[thesaurus]: https://github.com/beloglazov/vim-online-thesaurus
[goyo]: https://github.com/junegunn/goyo.vim
[limelight]: https://github.com/junegunn/limelight.vim
[matchit]: http://www.vim.org/scripts/script.php?script_id=39
[indentline]: https://github.com/Yggdroot/indentLine
[choosewin]: https://github.com/t9md/vim-choosewin
[delimitmate]: https://github.com/Raimondi/delimitMate
[echodoc]: https://github.com/Shougo/echodoc.vim
[deoplete]: https://github.com/Shougo/deoplete.nvim
[neocomplete]: https://github.com/Shougo/neocomplete.vim
[neosnippet]: https://github.com/Shougo/neosnippet.vim
[unite]: https://github.com/Shougo/unite.vim
[unite-colorscheme]: https://github.com/ujihisa/unite-colorscheme
[unite-filetype]: https://github.com/osyo-manga/unite-filetype
[unite-history]: https://github.com/thinca/vim-unite-history
[unite-build]: https://github.com/Shougo/unite-build
[unite-outline]: https://github.com/h1mesuke/unite-outline
[unite-tag]: https://github.com/tsukkee/unite-tag
[unite-quickfix]: https://github.com/osyo-manga/unite-quickfix
[neossh]: https://github.com/Shougo/neossh.vim
[unite-pull-request]: https://github.com/joker1007/unite-pull-request
[junkfile]: https://github.com/Shougo/junkfile.vim
[unite-issue]: https://github.com/rafi/vim-unite-issue
[operator-user]: https://github.com/kana/vim-operator-user
[operator-replace]: https://github.com/kana/vim-operator-replace
[operator-surround]: https://github.com/rhysd/vim-operator-surround
[textobj-user]: https://github.com/kana/vim-textobj-user
[textobj-multiblock]: https://github.com/osyo-manga/vim-textobj-multiblock
