Skip to content
jtratner's dotfiles, feat. vim and zsh -- borrowing heavily from awesome dotfiles makers like @holman, sontek and natw
VimL Ruby Shell Python
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


the dotfiles of jtratner

From their start standing on the shoulders of dotfile giants like sontek, jtratner's dotfiles have begun to slowly evolve in their own right.

Using these dotfiles

Super-quick Install

Get a working set of files by entering the following on a command line.

git clone .dotfiles
cd .dotfiles

Installing on Windows

If you are using Windows, you can use the vim files by copying into your home folder (where $HOME is your directory, where you have folders for My Documents, etc). You can get my either via git clone or by downloading them as a zip file on github.

  • vimrc.symlink should be copied to $HOME/_vimrc (note the '_' !)
  • vim.symlink should be copied to $HOME/vimfiles

Installation Notes

(see tl;dr above) Running sets up the dotfiles and updates submodules + will back up your files to .bak. If, for some reason, you don't want to update your submodules, you can comment out the lines that start with git

Some things need dependencies

I've tried to document dependencies below, but a quick list here for reference. NONE of these are necessary to use my dotfiles, they just enable additional features.

Plugin Dependencies
Syntastic Requires 'compilers' for whatever files you want to check (for example, to check .rst files you need docutils)
Ack Requires an installation of ack (well worth it!)

My dotvim

The vimrc.symlink file is pretty well documented. You could also go read sontek's description of his dotfiles for more in-depth info on many of these plugins. I'm just going to mention the changes I've made since 'forking'(ish) sontek's dotfiles. More info will come over time

New bundles

  • syntastic - makes it real easy to check the syntax on any filetype (just have to have the parser installed. I have docutils (rst), pyflakes, pep8 (for python) installed at the moment, to name a few).
  • VOom - simple but very useful vim application. Creates a two-pane outline window that allows you to browse the structure of your files (or classes/functions in python ,etc). For example if you run :Voom on this file, you'll see a neat directory tree that you can use to navigate the file. Also has a useful in-file grep.
  • tComment - handy for easily commenting/uncommenting sections
  • snipmate - (updated to garbas' new version + added the snippet repository)
  • Powerline - better vim status bar. NOTE: You have to install a patched font to use it. Luckily, there are some included in fonts/fonts.symlink/ that'll be installed automatically. Yay!
  • Ctrl-P - like Command-T but on steroids + no ruby required. Just type <ctrl-P> and your

reStructuredText/autounderline Functions

  • :Underline <arg> and :Title <arg> where <arg> is a character or number. (title creates an under and overline)
some vim text

":Un -

some vim text

New shortcuts

Mapping Mnemonic Settings
<leader> en 'edit normal' tw=78; fo+=t, colorcolumn+=0
<leader> ec 'edit comment' tw=72; fo+=t, colorcolumn+=0
<leader> ed 'edit done' restore defaults (or tw=80,fo-=t, colorcolumn=0)
<leader> p 'paste' paste from clipboard
<leader> y 'yank' yank to clipboard
<S-C-V> (normal paste) paste from clipboard
<S-C-C> 'copy' yank to clipboard
Q 'quick form'? format the current paragraph
Command Settings
:SetFont use to quickly change font in gvim
<F3> toggle VoOM
:DiffSaved Show diffs between current file and saved file

Setting up dotfiles, vim and IPython

Getting Vim


Easiest way: sudo apt-get build-dep vim-gnome (if you're using unity)

  • Mac : You can download MacVim or use homebrew
  • Windows : The vim.symlink files will be helpful, but note that it has to be under vimfiles, not .vim

Getting the dotfiles

Option 1: Clone the dotfiles

  1. Install git. (e.g. sudo apt-get install git)
  2. Pick a directory, then clone these dotfiles with (it'll automatically add it to a folder called 'dotfiles' unless you specify a different folder after the clone e.g. git clone mydotfilecollection/jtratner):
git clone

Option 2: Fork the dotfiles yourself

  1. Get an account on github, follow their instructions and come back after a bit. Fork the dotfiles yourself. (click on the fork button ;))
  2. Initiate a git repository, then add your fork of dotfiles on github as a remote. Finally, download your files.
mkdir dotfiles
cd dotfiles
git init
git remote add origin*username_/_yourrepository*.git
git pull origin master

Install the dotfiles

  1. Go into the dotfiles directory, run ./ in the command line. BOOM! You are halfway done.

Python Dependencies

Install rope, nose and ack (optional virtualenv)

  1. Rope and nose you can get through easy_install or pip (I prefer pip)
pip install rope nose
  1. Ack you have to get as a package (e.g. apt-get install ack or through homebrew)
  2. virtualenv - highly useful, you probably want it. (I list it last because the previous items need to be installed system-wide)
pip install virtualenv virtualenvwrapper
Something went wrong with that request. Please try again.