From their start standing on the shoulders of dotfile giants like sontek, jtratner's dotfiles have begun to slowly evolve in their own right.
What's In Here
Get a working set of files by entering the following on a command line.
git clone https://github.com/jtratner/dotfiles.git .dotfiles cd .dotfiles ./install.sh
Installing on Windows
If you are using Windows, you can use the vim files by copying into your home
$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.symlinkshould be copied to
$HOME/_vimrc(note the '_' !)
vim.symlinkshould be copied to
(see tl;dr above) Running
install.sh 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
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.
|Syntastic||Requires 'compilers' for whatever files you want to check (for example, to check
|Ack||Requires an installation of
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
- syntastic - makes it real easy to check the syntax on any filetype (just
have to have the parser installed. I have
pep8(for python) installed at the moment, to name a few).
:Hammer, converts your current lightweight-markup file to HTML.
- vim-ipython - hands down the best tool to help you code in python lets you connect to ipython, which is a fabulous suite for
- 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
:Voomon 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-Tbut on steroids + no ruby required. Just type
<arg>is a character or number. (title creates an under and overline)
some vim text ":Un - some vim text -------------
|<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|
|:SetFont||use to quickly change font in gvim|
|:DiffSaved||Show diffs between current file and saved file|
sudo apt-get build-dep vim-gnome (if you're
- Mac : I think you can get MacVim which should have everything
- Windows : The
vim.symlinkfiles will be helpful, but note that it has to be under
Compiling Vim (Medium!)
- Handling dependencies - there are a ton and, unfortunately, vim doesn't
always tell you that you've managed to get all the ones you want. I used to
have an install script_, but it really varies a ton by platform.
- Ubuntu (and Linux generally) there's a raft of libraries, but the most
important to grab are:
xorg-dev python-dev ruby ruby-devas well as a raft of ncurses libraries.
- Mac Check out homebrew
- Ubuntu (and Linux generally) there's a raft of libraries, but the most important to grab are:
- The easiest way to setup vim and be sure that you have the features you want is to grab the tarball from the vim homepage, and configure it with
./configure --enable-pythoninterp --enable-rubyinterp --enable-gui --with-features=huge --prefix=$HOME/path/to/directory `
- Go to your directory where you installed vim and check that you got the right version with
- If you did it correctly, you'll get a huge amount of input with
-. Most important thing is to check that you had the following:
+ruby(if you want Command-T)
+xterm-clipboard(if on Linux w/ X11) or another
+clipboardentry -- you need this to be able to copy/paste from the clipboard.
Option 1: Clone the dotfiles
- Install git. (e.g.
sudo apt-get install git)
- 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
git clone https://github.com/jtratner/dotfiles.git mydotfilecollection/jtratner):
git clone https://github.com/jtratner/dotfiles.git
Option 2: Fork the dotfiles yourself
- Get an account on github, follow their instructions and come back after a bit. Fork the dotfiles yourself. (click on the fork button ;))
- 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 email@example.com:*username_/_yourrepository*.git git pull origin master
- Go into the dotfiles directory, run
./install.shin the command line. BOOM! You are halfway done.
Install rope, nose and ack (optional virtualenv)
- Rope and nose you can get through
pip(I prefer pip)
pip install rope nose
- Ack you have to get as a package (e.g.
apt-get install ackor through homebrew)
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 virtualenvwrapper.sh
Installing IPython (+ dependencies)
Preface This ought to work:
It never works for me. You can install IPython with
just have to get the dependencies first. Before you do, you might also check out
the IPython website and its guide to installation
- Getting python dependencies (you may already have some or all of these) Note
that matplotlib, scipy, and numpy are only required if you want to run pylab; however I highly suggest that you get them because they are very useful and pretty darn cool
pip install nose tornado pygments pyzmq pexpect distribute matplotlib scipy numpy
- Getting Qt This can be more or less of an ordeal, depending on your system.
Do yourself a favor: try to find a precompiled binary first it will be far easier. Seriously. Otherwise, you'll probably need to get
Qtonline. (TODO: write instructions for this. For now, Google search is your friend.)
Install IPython Okay, actually this is pretty easy now! Yay!
pip install ipython
- Check that it's working Run IPython's testing suite. Read the output to
make sure you aren't missing any libraries.
If it fails,
You have a working setup!
Now you should be able to just run your file and have everything work. Whee!
|||The easiest way is to download and install a precompiled version. On Ubuntu, |
|||I set up a different home directory and then symlink it to my local bin, that way I can still use the default system editor as needed (say if xwindows|