# Introduction The main goal with this vim configuration is to keep things lightweight, fast and easy to use. I use it everyday both at work and at home and it works great for me. It supports both Vim & NeoVim on Mac OS X, Linux & Windows. I constantly review and modifiy this configuration and I'm always open to suggestions and/or contributions.

Thanks for stopping by and hopefully you find something of use.

Requirements

Mac OS X:

• MacVim: MacVim must be compiled with python & lua support. Using brew, MacVim comes with python by default. We must inform brew to build the formula with lua support:

  brew install macvim --with-lua

• NeoVim: NeoVim ships with python & lua support by default. It can easily be installed with brew using the following command:

  brew install neovim

Windows:

• Vim for Windows: Download the version compiled with both Python and Lua.

Manual Installation

1. Check out the current source from github:

   • Mac OS X, Linux & Windows:

     git clone https://github.com/nicholasc/vim-config.git $HOME/.vim

2. Create symlinks for vimrc:

   • Mac OS X & Linux:

     ln -s $HOME/.vim/vimrc $HOME/.vimrc

   • Windows:

     cmd /c mklink $HOME/.vimrc $HOME/.vim/.vimrc

3. Clone Plug repository inside the bundle folder:

   On Windows, follow these steps (neocomplete fallback) before continuing.

   Vim:

   curl -fLo ~/.vim/autoload/plug.vim --create-dirs \ https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim

   NeoVim:

   curl -fLo ~/.config/nvim/autoload/plug.vim --create-dirs \ https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim

4. Open vim, discard errors and install the plugins using the following command:

    :PlugInstall
   

5. Install VimProc' dependencies using the following command:

    :VimProcInstall
   

Plugins

Here is a list of all the available plugin with this config:

Utilities

• vim-sensible: Think of sensible.vim as one step above 'nocompatible' mode: a universal set of defaults that (hopefully) everyone can agree on.
• vim-fugitive: a Git wrapper so awesome, it should be illegal.
• vim-gitgutter : A Vim plugin which shows a git diff in the gutter (sign column) and stages/reverts hunks.
• neocomplete: Next generation completion framework after neocomplcache.
• deoplete: Dark powered asynchronous completion framework for neovim.
• fzf: A command-line fuzzy finder written in Go.
• ctrlp: Active fork of kien/ctrlp.vim—Fuzzy file, buffer, mru, tag, etc finder.
• nerdcommenter: Vim plugin for intensely orgasmic commenting.
• vimproc: Interactive command execution in Vim.
• supertab: Supertab is a vim plugin which allows you to use for all your insert completion needs.
• syntastic: Syntax checking hacks for vim.
• vim-airline: Lean & mean status/tabline for vim that's light as air.
• vim-easymotion: EasyMotion provides a much simpler way to use some motions in vim.
• vim-trailing-whitespace: Highlights trailing whitespace in red and provides :FixWhitespace to fix it.
• vim-devicons: adds font icons (glyphs ★♨☢) to programming languages, libraries, and web developer filetypes for: NERDTree, powerline, vim-airline, ctrlp, unite, lightline.vim, vim-startify, vimfiler, and flagship.
• ferret: Enhanced multi-file search for Vim.
• vim-bufonly: Delete all the buffers except the current buffer.
• splitjoin: A vim plugin that simplifies the transition between multiline and single-line code.
• vim-surround: surround.vim: quoting/parenthesizing made simple.
• delimitmate: Vim plugin, provides insert mode auto-completion for quotes, parens, brackets, etc.
• taboo: Few utilities for pretty tabs.

Color schemes

• gruvbox: Retro groove color scheme for Vim.

Syntax highlighting

• php: Up-to-date PHP syntax file (5.3, 5.4 & 5.5 support; basic 5.6 support).
• html5: HTML5 omnicomplete and syntax.
• vim-javascript: Vastly improved Javascript indentation and syntax support in Vim.
• vim-json: A better JSON for Vim: distinct highlighting of keywords vs values, JSON-specific (non-JS) warnings, quote concealing. Pathogen-friendly.
• vim-markdown: Markdown Vim Mode.
• vim-less: LessCSS Syntax support in Vim.