Vim script
Latest commit 06eae7a Feb 25, 2015 @jez Add README
Permalink
Failed to load latest commit information.
README.md Add README Nov 12, 2016
vimrc.vim Add all the extra plugins that I use Nov 12, 2016

README.md

Vim as an IDE

This repository is the result of a tech talk that I gave at Carnegie Mellon University on February 25, 2015. Its central motivation is this: students who have been instructed or told to use Vim to complete programming assignments while ssh'ed are missing out on the vast power that lies within Vim.

There are two fronts to having an amazing Vim experience:

  1. knowing how to manipulate text using Vim's built in keyboard shortcuts
  2. having plugins that make Vim behave like users would expect from a modern text editor.

In my experience as a TA and fellow student, learning the former requires the latter and vice versa, leading to a vicious cycle of Vim peril. With this in mind, this repository aims to cure the latter, so that the vicious cycle can end.

How to use this repository

This repository contains a sample vimrc that walks you through the changes at each step so that you can gain an understanding of what's going on (rather than just copying someone's vimrc!).

Each commit in this repository corresponds to a step from the actual workshop. Use the list of all commits to browse the steps. You'll see a (sometimes lengthy) explanation of what happened, and then the diff(erence) of exactly what changed from step-to-step.

This is what you should do:

  • start at the first commit
  • read the commit message and GitHub comments
  • copy the changes
  • repeat

It's that simple. Depending on how fast you read and how in-depth you want to go, you could easily have a fully-configured* Vim setup in about an hour.

Once you've done this, the hard part is learning to use what you just installed! I went back through and added some usage information and links to references on the GitHub comments, so be sure to check them out.

Table of Contents

Even though you can install this file outright, you should really look through the steps for more information about what's going on.

Note: every time you add a new Plugin ... line, you'll have to run

vim +PluginInstall +qall

As you're following along these steps, if you want to check whether what you see matches up with what my setup looks like after a given step, jump over to this post.

Update (2016-11-12)

I've taken a pass through to update some of the more outdated commits. Unfortunately, this means some links have become broken. You can still find links to these steps by going to the branch original. If you find outdated links anywhere here, please let me know.

Installation Instructions

If you just want to use this file as your vimrc, no questions asked,

  1. Move your ~/.vimrc file and ~/.vim folder somewhere else for now.
  2. Download Vundle
  3. Change your terminal colorscheme to solarized
  4. Install a patched font
  5. Download the file vimrc.vim and rename it to ~/.vimrc
  6. Run vim +PluginInstall +qall
  7. ???
  8. Profit!

Now that I'm a plugin master, I want to...

In order to teach people plugins, I had to sacrifice teaching people how to tap into the power of editing in Vim, which comes from using the keyboard over the mouse. Please, take a little time to learn how to actually use Vim!

* When I say fully-configured, I mean actually usable. It can be argued that Vim is never fully-configured: everyone's preferences are different, and circumstances change. Configuring your text editor is really a continuous process!