malaney / vimrc

malaney's vimrc

Malaney's vimrc (Fork of vgod's vimrc https://github.com/vgod/vimrc)

Author: Malaney J. Hill [email protected]

This vimrc compiles some of the best ideas I've seen in vimrc's across the net including Tobias Schlitt's VIM integration for PHP and other's. It relies heavily on Tim Pope's Pathogen plugin to facilitate inclusion of all plugins within their own sub-directories within the "~/.vim/bundle" sub-directory.

HOW TO INSTALL

0. Backup your original ~/.vim and ~/.vimrc $ mv ~/.vim ~/.vimbkup && mv ~/.vimrc ~/vimrc.bak && ~/.gvimrc ~/gvimrc.bak

1. Check out from github

    $ git clone git://github.com/malaney/vimrc.git ~/.vim
    $ cd ~/.vim
    $ sh install-vimrc.sh
   

2. (Optional, if you want Command-T) Compile the Command-T plugin

    $ cd .vim/bundle/command-t/ruby/command-t
    $ ruby extconf.rb
    $ make
   

WORKING WITH PLUGIN BUNDLES

To add a bundle - git submodule add <git/repo/url> bundle/ - git submodule update --init - git commit To remove a bundle - Remove from .gitmodules - git rm --cached bundle/ - git commit To upgrade bundle - cd bundle/ - git pull

UPGRADE PLUGIN BUNDLES

All plugins (except vim-latex) were checked out as git submodules, which can be upgraded with git pull. For example, to upgrade Command-T

 $ cd ~/.vim/bundle/command-t
 $ git pull

HOW TO USE

see the "USEFUL SHORTCUTS" section in vimrc to learn my shortcuts.

PLUGINS

• Pathogen: Pathogen let us install a plugin as a bundle in ~/.vim/bundle seprately.

• Nerd Tree: A tree explorer plugin for navigating the filesystem.

  Useful commands:

  • :Bookmark [name] - bookmark any directory as name
  • :NERDTree [name] - open the bookmark [name] in Nerd Tree

• AutoClose: Inserts matching bracket, paren, brace or quote.

• vim-surround: deal with pairs of surroundings.

• matchit: extended % matching for HTML, LaTeX, and many other languages.

• xmledit: XML/HTML tags will be completed automatically.

• Command-T: open and navigate between files with cmd-t.

• SuperTab: Do all your insert-mode completion with Tab.

• snipMate: TextMate-style snippets for Vim

  :help snipMate to see more info.

• YankRing: Maintains a history of previous yanks, changes and deletes

  :help yankring to see more info.

• VisIncr: Produce increasing/decreasing columns of numbers, dates, or daynames.

• Cute Error Marker: showing error and warning icons on line.

  Note: MacVim users need to enable "Use experimental renderer" to see graphical icons.

• vim-latex: Latex support.

• OmniCppComplete: C/C++ omni-completion with ctags database.

• JavaComplete: Java Omni-completion.

• VCSCommand: Extremely useful vim front-end to git/svn/hg/bzr/cvs

• PDV--phpDocumentor-for-Vim: Auto-generates doc blocks for PHP code

• Vim-Fuguitive: A Git wrapper for vim

Language specific supports

• Latex: Read :help latex-suite.txt
• Restructured Text: ctrl-u 1~5 inserts Part/Chapter/Section headers
• HTML, Javascript, Python, CSS, C, C++, Java: use TAB to do omni-completion.
• HTML/XML: End tags are automatically completed after typing a begin tag. (Typing > twice pushes the end tag to a new line.)

Other good references

• http://amix.dk/vim/vimrc.html
• http://spf13.com/post/perfect-vimrc-vim-config-file