A modular vim configuration
This is my personal vim configuration that is partly inspired by SpaceVim. It is compatible to vim, gvim (8.0+) and neovim (0.2+). The configuration is split up into multiple files such that personal customization is separated from boilerplate code.
The install script that is shipped with this configuration also checks for the following requirements:
- python3 support for vim/gvim
- neovim python3 module
Under a Debian-like Linux system you can install these by the following commands
sudo apt-get install aspell aspell-de python3-pip pip3 install neovim
Note that vim-tiny in Debian does not support python3, but vim-nox, vim-gtk3 or neovim does. You also want to make sure that you have curl and git installed.
Clone & install
If you already have a vim configuration in place then you may first move your
~/.vim directory first
mv ~/.vim ~/.vim-old
Assuming that there is no
~/.vim anymore, simply clone this repository into
~/.vim and invoke
git clone https://git.sthu.org/repos/vimconf.git ~/.vim ~/.vim/install.sh
This install script creates backups of existing configuration files (e.g.,
~/.vimrc) and then creates symlinks to configuration files in
Specialization for local machines
I personally would like to have the same vim configuration on all my user accounts. Still, on certain machines I would like to personalize and specialize the configuration. The following files are sourced if existent:
Example files are shipped with the repository.
Terminal color settings
For consistent background colors you may change the background colors of your terminal program to the gruvbox black #1c1c1c. Otherwise regions of your terminal may appear in a saturated black (#000) rather than the gruvbox black.
This vim configuration uses the well designed and popular gruvbox colorscheme. In case you use mutt as mail client and vim for composing mails then you may find my mutt gruvbox colorscheme interesting.
Conditional plugin loading makes vim to fire up in 0.2 seconds on my machines.
C and Python programming with NERDTree on the left with NERDtree git plugin and Tagbar on the right. Neomake shows an flake8 error on the cursorline at line 18 of utils/echorec.py. The tags file is automatically generated by gutentags and the current working directory of vim is automatically changed to the git root by rooter. A git diff indicated by plus, minus, and changed signs provided by signfiy. Indent detection by detectindent.
A :Termdebug session in gvim (and likewise for neovim) together with gdb pimped by gdb dashboard. A wrapper script in this repository detects gdb dashboard and disables the redundant source window. A breakpoint is set on line 343 and the debugger is currently holding at line 352.
A GDB session in gvim via conque-gdb, which I consider being superseded by termdebug now. A breakpoint is set in vim, the current execution line is highlighted and variable under the vim cursor is print.
On the left we see markdown with vim-liquid plugin and on the right CSS resp. SASS with scss-syntax and vim-css-color. Spell checking is enabled and the language is automatically detected via vim-DetectSpellLang.
Put this line in your shell configuration file (e.g., ~/.profile) in order to make vim the manpager.
export MANPAGER="view -c MANPAGER -"