The installation process will only work IFF ~/.vim is empty AND ~/.vimrc does not exist. If this is not the case, then be sure to back up your existing Vim configuration files. This may be done by executing the following:
$ mv ~/.vimrc ~/.vimrc_old
$ mv ~/.vim ~/.vim_old
Execute the following commands in order to install to your ~/.vim file:
# Install the git repository
$ git clone --recursive [email protected]:wrideout/dotvim.git ~/.vim
# Initialize and pull down the requisite submodules
$ cd ~/.vim
$ git submodule init
$ git submodule update
# Create symlinks
$ ln -s ~/.vim/vimrc ~/.vimrc
The use of the '--recursive' flag during the cloning process tells git that it should fetch the submodules needed to run this vim setup. Once installation is complete, ~/.vim may be treated as a regular git repository, and therefore updated as such. All submodules in the repository may be updated by executing the following command:
$ git submodule foreach git pull origin master
The plugins used by this setup are as follows:
- Abolish
- BufTabline
- ConqueShell
- Cscope_maps
- DelimitMate
- Fugitive
- FZF
- Genutils (dependency for SelectBuf)
- IndexedSearch
- Matchit
- NERD_commenter
- NERD_tree
- Pathogen
- Repeat
- Scratch
- SelectBuf
- Signify
- Supertab
- Surround
- Syntastic
- Tabular
- Tagbar
- Unimpaired
- VCSCommand
- Vim-Multiple-Cursors
Note that the cscope application must be installed, as the cscope-maps plugin and several mappings rely on it.
FZF as utilized within this configuration is not a Vim plugin per-se, but rather an outside script that is called by a keybinding. FZF must be installed in the system environment to be able to be called from this configuration.
The following colorschemes are provided:
The pathogen system is used to manage the above plugins. To add a new plugin to this setup, execute the following command, substituting information where needed:
$ git submodule add git://github.com/path/to/plugin/repo bundle/plugin_name
Once that is done, pathogen will automatically crawl, find, and load the plugins
in the directories under ~/.vim/bundle
. The help documentaion can be
refreshed to reflect any new plugins by running the following command:
:Helptags
Note that this is a wrapper, supplied by the pathogen plugin.
#WARNING This particular vimrc contains new mappings for the keyboard arrow keys. If you absolutely can't live without arrow keys, just comment the new mappings out in vimrc.
#Issues and Bugs Any issues or bugs that are found may be addressed via the Issues page of this repository.