This is Mudphone's RUNA fork of the Emacs Starter Kit (by Technomancy). See README_orig.markdown for the basics. Or, checkout the original project page.
Clone or fork this project.
Forking is easier, as it will automatically create a github project for you (and you'll show up in the network graph).
Create a .emacs.d link to this project.
For example, if you forked and cloned the project as:
$ cd ~/work/emacs $ git clone git://github.com/YOUR_GITHUB/emacs-starter-kit.git
If you already have a .emacs.d directory, you should rename it (unless you don't want it any more).
Then, you can create your link like so:
$ cd ~/. $ ln -s ~/work/emacs/emacs-starter-kit .emacs.d
Update ELPA Packages
Start Emacs... you'll see a lot of compiling of default starter kit packages.
M-x package-list-packages i - next to each package you want x - install selected packages
I recommend installing one package at a time, as opposed to all of them at once. This way, you'll know who's to blame if something goes wrong.
It is also a good idea (IMHO) to close an re-open Emacs between each package install. This may seem drastic, but in my experience it helps to find problems with package installs early. I'm open to suggestions if this is insane.
At times, packages don't install cleanly. I have not investigated why this is the case. When this happens it's relatively painless to retry the install. If you're really stuck, you can also delete the package (manually) from the ELPA directory (and install again). Note, the in-Emacs package delete feature doesn't seem to work at all.
Additionally, I recommend installing the packages below in the order listed.
Recommended non-default packages:
Automatically installed by the above modes:
Note: It is not required to install paredit here. (It's installed by the starter kit.)
You must refresh all submodules:
$ cd ~/.emacs.d $ git submodule init $ git submodule update
Create links for:
vendor/mudphone/user.el --> ~/.emacs.d/$USER.el vendor/mudphone/user/ --> ~/.emacs.d/$USER
If you work for RUNA, or want to use slime outside of swank-clojure-project, create this link too:
vendor/swank-clojure/ --> ~/.swank-clojure
RSpec-Mode: vendor/rspec-mode (submodule) allows for single spec or whole file spec running
(define-key map (kbd "\C-c s") 'run-specs) (define-key map (kbd "\C-c f") 'run-focused-spec)
I create a symlink to my custom configs from .emacs.d/$USER.el
I create a symlink to my custom load dir from .emacs.d/$USER
customized RUNA keyword syntax highlighting
maximizes emacs frame on start-up
several Textmate feature emulations
(define-key map [(meta return)] 'textmate-next-line) (define-key map [(control tab)] 'textmate-shift-right) (define-key map [(control shift tab)] 'textmate-shift-left) (define-key map [(control meta \;)] 'comment-or-uncomment-region-or-line) (define-key map [(meta t)] 'textmate-goto-file)