gergap's Vim Configuration

                                       /\        ____   ____.__
   ____   ___________  _________  _____)/ ______ \   \ /   /|__| _____
  / ___\_/ __ \_  __ \/ ___\__  \ \____ \/  ___/  \   Y   / |  |/     \
 / /_/  >  ___/|  | \/ /_/  > __ \|  |_> >___ \    \     /  |  |  Y Y  \
 \___  / \___  >__|  \___  (____  /   __/____  >    \___/   |__|__|_|  /
/_____/      \/     /_____/     \/|__|       \/                      \/

With vim you can really do everything. I'm using it for C/C++ development, writing BASH scripts, and for all kinds of administration tasks. TMux and SSH are your best friends ;-)

I'm using vim on Gentoo Linux running in Konsole (KDE's awesome terminal application). My config may work on other systems too, but I've not tested it. Anyway my .vimrc may contain some nice features that you can integrate into yours.

You can use my config as-is, or better read my .vimrc, understand it, and as Bruce Lee would say: "Absorb what is useful, discard what is not."

And this is what my config looks like:

Important shortctus

F2: Saves file. Works in normal mode and insert mode.
F3: Enables spellcheck.
S-F3: Disables spellcheck.
F4: Switches between header and corresponding source file.
S-F4: Like F4, but opens the counterpart in a vertical split.
F5: Creates/updates ctags file in the current directory.
F6: Creates doxygen comment for the current function.
F7: Builds using :make
S-F7: Clean build using :make clean all
F10: Removes trailing whitespaces of the complete file.
F12: Goto definition
S-F12: Opens definition in vertical split view.
M-Down: Next typo (spellchecking)
M-Up: Previous typo (spellchecking)

Special keys in vimdiff mode

M-Down: jump next difference
M-Up: jump to previous difference
M-Left: diffget
M-Right: diffput

Plugins

My config makes use of some great vim plugins for coders. Just call the install_plugins.sh script to install 'em all.

YouCompletMe: Smart completion support including semantic C/C++ completion using clang
UltiSnips: Awesome snippts support. This is a must have!
SuperTabs: Use to complete various things (vim , clang_complete, ...)
vim-fugitve: Git support
vim-airline: Powerline based on vim-script (no python)
Autoclose: Closes corresponding brackets ("()", "[]", "{}") without getting annoyed.
NerdTree: File tree for accessing files interactively
CtrlP: Fuzzy file open support
TagList: List functions, variable and macros of the current file.

Requirements

vim, for obvious reasons ;-) (you will need to build vim with python support for some plugins)
git

Now some optional parts:

clang - for clang_complete plugin (See https://github.com/Rip-Rip/clang_complete/wiki)
python - for some plugins like clang_complete
powerline fonts - for vim-airline to display nice symbols (See https://github.com/Lokaltog/powerline-fonts)

Installation

cd ~
# clone this repository
git clone git@github.com:gergap/vim.git
# now merge my config with yours or continue to replace your config completely.
# The following steps are what I'm doing to install it on various machines.
# Note: backup any existing vim configuration before you remove your .vim folder and .vimrc file.
rm -rf .vim .vimrc
# symlink your new config
ln -s vim .vim
ln -s .vim/.vimrc
# install used plugins
cd vim/.vim
./install_plugins.sh
# Now enjoy the best editor on earth - vim :-)

Known Issues

S-F4 mapping does not work. I believe this is intercepted by KDE or Konsole, It may work in other terminals.