Sane, Lightweight and Aesthetic Vim
Vim script Shell
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.vimrc
license.md
readme.md
setup.sh

readme.md

Sane, Lightweight and Aesthetic Vim

Here is my personal Vim/NeoVim setup, which has been written (and documented) from the ground-up, tried-and-tested for several years by myself and several colleagues. It's built on the premise that regular Vim is awesome, and any additions in this configuration should be made to "enhance" the original Vim experience (not replace it). Therefore, you'll find that none of the bindings have been overwritten, and only a selected few packages have been included (and if you don't like some of them, feel free to remove them, which only requires a couple of lines to be changed). Most importantly, the configuration will and more sane defaults to Vim (outdated things carried over from Vi), or tasks that are better done with other tools (e.g. Git).

I hope you will find this configuration useful as well. Please enjoy, and happy hacking!

Installation

The shell script snipplet below will download this repository to ~/.vim_temp and then execute the setup script. This script creates all the necessary folders in your home folder and fetches the required Vundle package manager. Afterwards, the target .vimrc is moved there too (make sure you backup you existing configuration in case you don't like my configuration). Finally, it will automatically open vim and start downloading the required packages for you (go fetch some coffee or maybe fika).

git clone https://github.com/CaffeineViking/vimrc.git ~/.vim_temp && \
cd ~/.vim_temp && ./setup.sh && rm -rf ~/.vim_temp && cd ~

If the script doesn't work (maybe you are running Windows or MacOS) you can just follow the steps below:

  1. Remove (backup) your existing .vimrc and related folders from your home directory.
  2. Download this repository, just copy over the .vimrc to your home directory.
  3. Create two folders, .vim_bundle and .vim_undoes in your home directory.
  4. Fetch the source from the Vundle repository. Put it in .vim_bundle/Vundle.vim.
  5. Probably install the Hack font too, which has support for powerline.
  6. Run vim and call :PluginInstall.
  7. Done! Please enjoy.

Features

  • Vundle: an awesome package manager.
  • NERDTree: fast filesystem browser, see everything!
  • TagBar: painless navigation of tags (functions, classes etc...).
  • Fugitive: easily one of the best Git integrators for Vim.
  • Vim-Surround: enables one to manipulate e.g. (){}<> directly.
  • GUndo: graphical visualization of the Vim undo tree and diffs for them.
  • VimCompletesMe: simple and lightweight built-in auto-completions.
  • LightLine: minimal and lightweight statusline/tabline.
  • Tabular: automatically tabulates (boring) stuff for you.
  • Vim-Repeat: extends vim's '.' operator usage.
  • Vim-Commentary: comment stuff out with gc.
  • MatchIt: operator '%' matches more stuff.
  • Ack: searches directory absurdingly fast.
  • GruvBox: very, extremely, pretty colors.
  • No overwritten vim bindings, all key mappings are bound to the leader key.
  • Sane defaults for vim: indents, no swap files, persistent undo tree etc...

Bindings

  • Global leader key: <space>
  • Disable Highlight: <ctrl>l
  • Tabulate it baby!: <leader>a
  • Opens Ack search: <leader>f
  • Toggle NERDTree: <leader>d
  • Toggle TagBar: <leader>s
  • Toggle GUndo: <leader>g

Screenshot

preview