It is recommended that you use gVim in either Windows or Linux and MacVim for Mac. You need version 7.3.885 or newer because there are dependencies.
Ps. I needed to "flat-out" the structure of the downloaded zip above. There is a vim73 dir inside it that I needed to move the files to the install root.
Mac: In MacVim with homebrew:
brew install macvim --with-cscope --with-lua --override-system-vim
Troubleshoot: Because of the large amount of submodules, if you ever have any trouble after pulling from the repository, it will be easier to just back up your old .vim folder and just git clone a new version.
Clone this repo into your home directory either as
.vim (linux/mac) or
vimfiles (Windows). Such as:
git clone git://github.com/carlosedp/vimfiles.git ~/.vim
cd into the repo and run this to get the submodules:
git submodule init git submodule update
Now just copy (or symlink) the
.vim/vimrc file as
or copy as
_vimrc (Windows) in your home directory. In Mac and Linux, the
easiest thing to do is:
ln -s ~/.vim/vimrc ~/.vimrc
On windows, create an environment var
VIM pointing to the install dir and put
_vimrc file in this dir. Clone the vimfiles repo into the same place like:
c:/apps/vim/_vimrc /vim73/... /vimfiles/...
If you already have a custom
.vimrc file, append the following lines to
load everything else along with your personal hacks:
source $VIM/vimfiles/vimrc "windows
To update all submodules, use the following command on vimfiles dir:
git submodule foreach git pull origin master
If you are using MacVim on MacOS Lion, disable the native fullscreen mode to allow "WriteRoom" mode:
defaults write org.vim.MacVim MMNativeFullScreen
Don't forget to install the font you plan to use from the
Fonts dir. You can check the one that is enabled(uncommented) on the
set guifont setting in the
You will need these dependencies figured out:
- Exuberant Ctags http://ctags.sourceforge.net/
In Ubuntu, for example, you will have to do:
apt-get install exuberant-ctags ncurses-term
In OS X, you can install ctags with homebrew
brew install ctags
On Windows you have to download Ctags and add ctags.exe in your PATH.
Mac OS X and most Linux distros come with Ruby already. If you're in Windows look for Luis Lavena's latest Ruby Installer on http://rubyforge.org/projects/rubyinstaller/
You can download Ack standalone from http://betterthangrep.com/ using their own instructions:
curl http://betterthangrep.com/ack-standalone > ~/bin/ack && chmod 0755 !#:3
On Windows, download the ack-standalone, and perl(git already ships with it) than, create a
ack.cmd on Windows path with the following content:
@"C:\Program Files\Git\bin\perl" C:\dev\ack-standalone.pl %* adjusting the paths for your needs.
Pandoc is used to transform Markdown files into another document types. I use to generate RTF versions of Markdown text.
You can download Pandoc from http://johnmacfarlane.net/pandoc/ and install into your platform path.
Visit the following sites to learn more about Vim:
There are many sites teaching Vim, if you know of any other that are easy to follow for newcomers, let me know.
- Original project and most of the heavy lifting: @scrooloose
- The cool plugins for Rails, Cucumber and more: @timpope
- All the other modules I use that can be seen on .gitmodules or bundle dir
- Hacks and some snippets: @carlosedp