README.md

Rafael Bodill's Neo/vim Config

Lean mean Neo/vim machine, 30-45ms startup time.

Best with Neovim or Vim 8 with +python3 extensions enabled.

(一个强大的 neovim 配置，支持 js/python/php/golang 等)

Features

• Fast startup time
• Robust, yet light-weight
• Lazy-load 95% of plugins with Shougo/dein.vim
• Custom side-menu (try it out! Leader+l)
• Modular configuration
• Denite (Unite's successor) centric work-flow
• Extensive Deoplete and Neocomplete setup
• Lightweight simple status/tabline
• Easy customizable theme
• Premium color-schemes
• Central location for tags

Screenshot

Install

1. Let's clone this repo! Clone to ~/.config/nvim, we'll also symlink it for Vim:

• Note: If your system sets $XDG_CONFIG_HOME, use that instead of ~/.config in the code above. Nvim follows the XDG base-directories convention.

2. Almost done! You'll need a YAML interpreter, if you have Ruby installed - you can skip this step. Otherwise, either install yaml2json, or use Python:

3. If you are a first-time Neovim user, you need the python-neovim packages. Don't worry, run the script provided:

4. Run make test to test your nvim/vim version and compatibility.

5. Run make to install all plugins.

Enjoy!

Recommended Linters

• Node.js based linters:

• Python based linters:

• Shell lint: shellcheck.net
• HTML Tidy: html-tidy.org

Recommended Tools

• ag (The Silver Searcher): ggreer/the_silver_searcher
• z (jump around): rupa/z
• Universal ctags: ctags.io
• Fuzzy file finders: fzf, fzy, or peco
• Tern: npm -g install tern

Upgrade

Run make update

User Custom Config

If you want to add your own configuration, create the config/local.vim file and add your personal settings there. This file is ignored by .gitignore.

Structure

• config/ - Configuration
  • plugins/ - Plugin configurations
  • plugins.yaml - Plugins!
  • local.plugins.yaml - Custom user plugins
  • vimrc - Initialization
  • init.vim - runtimepath initialization
  • general.vim - General configuration
  • local.vim - Custom user settings
  • neovim.vim - Neovim specific setup
  • mappings.vim - Key-mappings
  • theme.vim - Color-scheme and theme setup
  • filetype.vim - Language behavior
  • terminal.vim - Terminal configuration
• ftplugin/ - Language specific custom settings
• plugin/ - Customized small plugins
• snippets/ - Personal code snippets
• themes/ - Themes! Combination of styles and color-scheme
• filetype.vim - Custom filetype detection

Plugin Highlights

• Package management with caching enabled and lazy loading
• Project-aware tabs and label
• NERDTree as file-manager + Git status icons
• Go completion via vim-go and gocode
• Javascript completion via Tern
• Python Jedi completion, PEP8 convention
• Languages: PHP, Ansible, css3, csv, json, less, markdown, mustache
• Helpers: Undo tree, bookmarks, git, tmux navigation, hex editor, sessions, and much more.

Note that 95% of the plugins are lazy-loaded.

Non Lazy-Loaded Plugins

Name Description Shougo/dein.vim Dark powered Vim/Neovim plugin manager rafi/awesome-colorschemes Awesome color-schemes rafi/vim-badge Bite-size badges for the tab & status lines itchyny/vim-gitbranch Lightweight git branch detection itchyny/vim-parenmatch Efficient alternative to the standard matchparen plugin thinca/vim-localrc Enable configuration file of each directory christoomey/tmux-navigator Seamless navigation between tmux panes and vim splits junegunn/vim-peekaboo See the contents of registers tpope/vim-sleuth Heuristically set buffer indent options itchyny/cursorword Underlines word under cursor

Lazy-Loaded Plugins

Language

Name Description othree/html5.vim HTML5 omnicomplete and syntax mustache/vim-mustache-handlebars Mustache and handlebars syntax pearofducks/ansible-vim Improved YAML support for Ansible groenewege/vim-less Syntax for LESS hail2u/vim-css3-syntax CSS3 syntax support to vim's built-in syntax/css.vim othree/csscomplete.vim Updated built-in CSS complete with latest standards cakebaker/scss-syntax.vim Syntax file for scss (Sassy CSS) ap/vim-css-color Preview colors in source-code while editing plasticboy/vim-markdown Markdown syntax highlighting rhysd/vim-gfm-syntax GitHub Flavored Markdown syntax highlight extension pangloss/vim-javascript Enhanced Javascript syntax othree/jspc.vim JavaScript Parameter Complete MaxMEllon/vim-jsx-pretty React JSX syntax pretty highlighting heavenshell/vim-jsdoc Generate JSDoc to your JavaScript code moll/vim-node Superb development with Node.js elzr/vim-json Better JSON support fatih/vim-go Go development tbastos/vim-lua Improved Lua 5.3 syntax and indentation support vim-python/python-syntax Enhanced version of the original Python syntax Vimjas/vim-python-pep8-indent A nicer Python indentation style python_match.vim Extend the % motion for Python files tmhedberg/SimpylFold No-BS Python code folding raimon49/requirements.txt.vim Python requirements file format StanAngeloff/php.vim Up-to-date PHP syntax file (5.3 – 7.1 support) shawncplus/phpcomplete.vim PHP completion osyo-manga/vim-monster Ruby code completion toyamarinyon/vim-swift Swift support vim-jp/syntax-vim-ex Improved Vim syntax highlighting chrisbra/csv.vim Handling column separated data tmux-plugins/vim-tmux vim plugin for tmux.conf cespare/vim-toml Syntax for TOML mboughaba/i3config.vim i3 window manager config syntax dag/vim-fish Fish shell edit support ekalinin/Dockerfile.vim syntax and snippets for Dockerfile jstrater/mpvim Macports portfile configuration files tpope/vim-git Git runtime files robbles/logstash.vim Highlights logstash configuration files andreshazard/vim-logreview Bueatify log viewing exu/pgsql.vim PostgreSQL syntax othree/nginx-contrib-vim Fork official vim nginx IN3D/vim-raml Syntax and language settings for RAML

Commands

Name Description scrooloose/nerdtree Tree explorer plugin Xuyuanp/nerdtree-git-plugin NERDTree plugin for showing git status chemzqm/vim-easygit Git wrapper focus on simplity and usability tpope/vim-commentary Code commenting helper t9md/vim-choosewin Choose window to use, like tmux's 'display-pane' Shougo/vinarise.vim Hex editor kana/vim-niceblock Make blockwise Visual mode more useful guns/xterm-color-table.vim Display 256 xterm colors with their RGB equivalents mbbill/undotree Ultimate undo history visualizer metakirby5/codi.vim The interactive scratchpad for hackers Shougo/vimproc.vim Interactive command execution reedes/vim-wordy Uncover usage problems in your writing brooth/far.vim Fast find and replace plugin（批量在多个文件中替换字符、支持预览） jreybert/vimagit Ease your git work-flow within Vim tweekmonster/helpful.vim Display vim version numbers in docs lambdalisue/gina.vim Asynchronously control git repositories mzlogin/vim-markdown-toc Generate table of contents for Markdown files easymotion/vim-easymotion Vim motions on speed majutsushi/tagbar Displays tags in a window, ordered by scope beloglazov/vim-online-thesaurus Look up words in an online thesaurus

Interface

Name Description haya14busa/vim-asterisk Improved * motions rhysd/accelerated-jk Up/down movement acceleration haya14busa/vim-edgemotion Jump to the edge of block t9md/vim-quickhl Quickly highlight words rafi/vim-sidemenu Small side-menu useful for terminal users Shougo/tabpagebuffer.vim Tabpage buffer interface airblade/vim-gitgutter Show git changes at Vim gutter and un/stages hunks nathanaelkane/vim-indent-guides Visually display indent levels in code MattesGroeger/vim-bookmarks Bookmarks, works independently from vim marks rhysd/committia.vim Pleasant editing on Git commit messages benekastah/neomake Asynchronous linting and make framework [junegunn/goyo] Distraction-free writing [junegunn/limelight] Hyperfocus-writing itchyny/calendar.vim Calendar application vimwiki/vimwiki Personal Wiki for Vim

Completion

Name Description Shougo/deoplete.nvim Neovim: Dark powered asynchronous completion framework Shougo/neocomplete Next generation completion framework Shougo/neosnippet.vim Contains neocomplete snippets source Raimondi/delimitMate Auto-completion for quotes, parens, brackets ludovicchabant/vim-gutentags Manages your tag files mattn/emmet-vim Provides support for expanding abbreviations alá emmet Shougo/echodoc.vim Print objects' documentation in echo area Shougo/neosnippet-snippets Standard snippets repository for neosnippet davidhalter/jedi-vim Python jedi autocompletion library zchee/deoplete-go deoplete.nvim source for Go zchee/deoplete-jedi deoplete.nvim source for Python carlitux/deoplete-ternjs deoplete.nvim source for javascript wellle/tmux-complete.vim Completion of words in adjacent tmux panes ternjs/tern_for_vim Provides Tern-based JavaScript editing support

Denite

Name Description Shougo/denite.nvim Dark powered asynchronous unite all interfaces nixprime/cpsm File matcher, specialized for paths chemzqm/unite-location Denite location & quickfix lists chemzqm/denite-git gitlog, gitstatus and gitchanged sources rafi/vim-denite-z Filter and browse Z (jump around) data file rafi/vim-denite-session Browse and open sessions rafi/vim-denite-mpc Denite source for browsing your MPD music library

Operators & Text Objects

Name Description kana/vim-operator-user Define your own custom operators kana/vim-operator-replace Operator to replace text with register content rhysd/vim-operator-surround Operator to enclose text objects haya14busa/vim-operator-flashy Highlight yanked area kana/vim-textobj-user Create your own text objects terryma/vim-expand-region Visually select increasingly larger regions of text AndrewRadev/sideways.vim Match function arguments AndrewRadev/splitjoin.vim Transition code between multi-line and single-line AndrewRadev/linediff.vim Perform diffs on blocks of code glts/vim-textobj-comment Text objects for comments AndrewRadev/dsf.vim Delete surrounding function call osyo-manga/vim-textobj-multiblock Handle bracket objects kana/vim-textobj-function Text objects for functions

Custom Key-mappings

Note that,

• Leader key is set as Space
• Local-leader is set as ; and used for Denite & NERDTree

Key Mode Action Space All Leader ; All Local Leader Arrows Normal Resize splits (* Enable g:elite_mode in .vault.vim) Backspace Normal Match bracket (%) K Normal Open Zeal or Dash on some file types (except Python+Vim script) Y Normal Yank to the end of line (y$) <Return> Normal Toggle fold (za) S+<Return> Normal Focus the current fold by closing all others (zMza) S+<Return> Insert Start new line from any cursor position (<C-o>o) hjkl Normal Smart cursor movements (g/hjkl) 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 Remap to Ctrl+w Ctrl+x Normal Rotate window placement ! Normal Shortcut for :! } 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 gh Normal Show highlight group that matches current cursor gp Normal Select last paste Q Normal Start/stop macro recording gQ Normal Play macro 'q' mj/mk Normal/Visual Move lines down/up cp Normal Duplicate paragraph cn/cN Normal/Visual Change current word in a repeatable manner s Visual Replace within selected area 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 Ctrl+r Visual Replace selection with step-by-step confirmation ,+Space Normal Remove all spaces at EOL <leader>+<leader> Normal Enter visual line-mode <leader>+a Normal Align paragraph <leader>+os Normal Load last session <leader>+se Normal Save current workspace as last session <leader>+d Normal/Visual Duplicate line or selection <leader>+S Normal/Visual Source selection <leader>+ml Normal Append modeline

File Operations

Key Mode Action <leader>+cd Normal Switch to the directory of opened buffer (:lcd %:p:h) <leader>+w Normal/visual Write (:w) <leader>+y / <leader>+Y Normal Copy (relative / absolute) file-path to clipboard Ctrl+s All Write (:w) W!! Command Write as root

Editor UI

Key Mode Action <leader>+ti Normal Toggle indentation lines <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+j Normal Move to split below (<C-w>j) Ctrl+k Normal Move to upper split (<C-w>k) Ctrl+h Normal Move to left split (<C-w>h) Ctrl+l Normal Move to right split (<C-w>l) * Visual Search selection forwards # Visual Search selection backwards <leader>+j Normal Next on location list <leader>+k Normal Previous on location list <leader>+b Normal Toggle colorscheme background dark/light s+- Normal Lower colorscheme contrast (Support solarized8) s+= Normal Raise colorscheme contrast (Support solarized8)

Window Management

Key Mode Action q Normal Quit window (and Vim, if last window) Tab Normal Next window in tab Shift+Tab Normal Previous window in tab Ctrl+Tab Normal Next tab Ctrl+Shift+Tab Normal Previous tab \+\ Normal Jump to last tab s+v Normal Horizontal split (:split) s+g Normal Vertical split (: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) s+Q Normal Removes current buffer (:bdelete) <leader>+sv Normal Split with previous buffer <leader>+sg Normal Vertical split with previous buffer

Plugin: Denite

Key Mode Action ;+r Normal Resumes last Denite window ;+f Normal File search ;+b Normal Buffers and MRU ;+d Normal Directories ;+l Normal Location list ;+q Normal Quick fix ;+n Normal Dein plugin list ;+g Normal Grep search ;+j Normal Jump points(在搜索结果中上下移动，normal 模式下) ;+o Normal Outline tags ;+s Normal Sessions ;+t Normal Tag under cursor ;+p Normal Jump to previous position ;+h Normal Help ;+v Normal/Visual Register ;+z Normal Z (jump around) ;+; Normal Command history ;+/ Normal Buffer lines ;+* Normal Match line <leader>+gl Normal Git log (all) <leader>+gs Normal Git status <leader>+gc Normal Git branches <leader>+gf Normal Grep word under cursor <leader>+gg Normal/Visual Grep word under cursor Within Denite mode

Escape Normal/Insert Toggle modes jj Insert Leave Insert mode Ctrl+y Insert Redraw r Normal Redraw st Normal Open in a new tab sg Normal Open in a vertical split sv Normal Open in a split ' Normal Toggle mark current candidate

Plugin: NERDTree

Key Mode Action ;+e Normal Toggle file explorer ;+a Normal Toggle file explorer on current file Within NERDTree buffers

h/j/k/l Normal Movement + collapse/expand + file open w Normal Toggle window size N Normal Create new file or directory yy Normal Yank selected item to clipboard st Normal Open file in new tab sv Normal Open file in a horizontal split sg Normal Open file in a vertical split & Normal Jump to project root gh Normal Jump to user's home directory gd Normal Open split diff on selected file gf Normal Search in selected directory for files gr Normal Grep in selected directory

Plugin: Deoplete / Emmet / Neocomplete

Key Mode Action Enter Insert Select completion or expand snippet Tab Insert/select Smart tab movement or completion Ctrl+j/k/f/b/d/u Insert Movement in completion pop-up Ctrl+<Return> Insert Expand Emmet sequence Ctrl+o Insert Expand snippet Ctrl+g Insert Refresh candidates Ctrl+l Insert Complete common string Ctrl+e Insert Cancel selection and close pop-up Ctrl+y Insert Close pop-up

Plugin: Commentary

Key Mode Action <leader>+v Normal/visual Toggle single-line comments <leader>+V Normal/visual Toggle comment block

Plugin: Edge Motion

Key Mode Action g+j Normal/Visual Jump to edge downwards g+k Normal/Visual Jump to edge upwards

Plugin: QuickHL

Key Mode Action <leader>+, Normal/Visual Toggle highlighted word

Plugin: Expand-Region

Key Mode Action v Visual/select Expand selection V Visual/select Reduce selection

Plugin: Easymotion

Key Mode Action s+s Normal Jump to two characters from input s+d Normal Jump to a character from input s+f Normal Jump over-windows s+h Normal Jump backwards in-line s+l Normal Jump forwards in-line s+j Normal Jump downwards s+k Normal Jump upwards s+/ Normal/operator Jump to free-search s+n Normal Smart next occurrence s+p Normal Smart previous occurrence

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

Plugin: Easygit

Key Mode Action <leader>+ga Normal Git add current file <leader>+gS Normal Git status <leader>+gd Normal Git diff <leader>+gD Normal Close diff <leader>+gc Normal Git commit <leader>+gb Normal Git blame <leader>+gB Normal Open in browser <leader>+gp Normal Git push

Plugin: GitGutter

Key Mode Action <leader>+hj Normal Jump to next hunk <leader>+hk Normal Jump to previous hunk <leader>+hs Normal Stage hunk <leader>+hr Normal Revert hunk <leader>+hp Normal Preview hunk

Plugin: Linediff

Key Mode Action ,+df Visual Mark lines and open diff if 2nd region ,+da Visual Mark lines for diff ,+ds Normal Shows the diff between all the marked areas ,+dr Normal Removes the signs denoting the diff'ed regions

Misc Plugins

Key Mode Action m+g Normal Open Magit <leader>+l Normal Open sidemenu <leader>+o Normal Open tag-bar <leader>+G Normal Toggle distraction-free writing <leader>+gu Normal Open undo tree <leader>+W Normal Wiki <leader>+K Normal Thesaurus <leader>+? Normal Dictionary (macOS only)

Credits & Contribution

Big thanks to the dark knight Shougo.

Tmux & Theme

https://github.com/icymind/NeoSolarized

You may need the same hack to make vim work well in tmux. Put these lines into your .vimrc:

The '^[' represent the escape char. You should press Ctrl-v + Esc to input actual escape. If the ^[ is two characters (^ and [), it's wrong. If it is one character, it's okay. When you delete the character with backspace, you will find that ^[ is deleted at once. Please also check :help c_CTRL-V (and :help i_CTRL-V). check issue and issue for more information.

neovim works perfect without this config. If you encounter a color issue using tmux, make sure that:

• you are using the latest version of tmux (v2.2)

• your $TERM variable is set to "xterm-256color"

• add the line below to your .tmux.conf file:

  set-option -ga terminal-overrides ",xterm-256color:Tc"

See this article for more details on tmux.

解决 mac tmux 下 neovim 无法复制到剪贴板的问题

# https://github.com/tmux/tmux/issues/543
brew install reattach-to-user-namespace
# then edit your .tmux.conf
set -g default-shell $SHELL
set -g default-command "reattach-to-user-namespace -l ${SHELL}"
# In .vimrc or ~/.config/nvim/init.vim (I use Neovim):
set clipboard=unnamed
# reload tmux config
tmux source-file ~/.tmux.conf

解决 vim gutter 使用 emoji 文本渲染问题

See this Vim text rendering off by one issue

如果你使用了 Iterm2 + neovim，并且在 gutter 栏使用了 emoji 表情，比如 vim-gitgutter, vim-ale 等插件的提示是 emoji。 请勾选 Iterm2->Profiles->Text->Use Unicode versoin 9 widths

See this issue https://stackoverflow.com/questions/43107435/emoji-display-issue-in-vim-with-tmux/52142277#52142277