this is a Clojure-friendly emacs config
If you're new to emacs, check out this introductory tutorial!
WARNING
This project uses an outdated version of CIDER, the package that provides much of the functionality for Clojure development. If you run into issues, try upgrading (instructions below).
Why not just update this package to use the latest CIDER, you ask? This project uses CIDER 0.8.1 so that Clojure for the Brave and True readers are less likely to get confused as they use Emacs for the first time.
Installing
- Close Emacs.
- Delete
~/.emacs
or~/.emacs.d
if they exist. (Windows users, your emacs files will probably live inC:\Users\your_user_name\AppData\Roaming\
. So, for example, you would deleteC:\Users\jason\AppData\Roaming\.emacs.d
.) This is where Emacs looks for configuration files, and deleting these files and directories will ensure that you start with a clean slate. - Download the Emacs
configuration zip file
and unzip it. Its contents should be a folder,
emacs-for-clojure-book1
. Runmv path/to/emacs-for-clojure-book1 ~/.emacs.d
. - Create the file
~/.lein/profiles.clj
(Windows users, this is probablyC:\Users\your_user_name\.lein\profiles.clj
) and add this line to it:
{:user {:plugins [[cider/cider-nrepl "0.8.1"]]}}
Then open Emacs.
Upgrading
Before upgrading, ensure that your .emacs.d
directory is under
version control so that you can always revert to a known good state.
To upgrade:
-
Edit
.emacs.d/init.el
, adding these lines after line 12:(add-to-list 'package-archives '("melpa-stable" . "http://stable.melpa.org/packages/") t) (add-to-list 'package-pinned-packages '(cider . "melpa-stable") t)
-
Close Emacs.
-
Run
rm -Rf .emacs.d/elpa/cider-*
-
Open Emacs. You'll probably see some errors and your theme won't load. That's ok.
-
In Emacs, run
M-x package-refresh contents
. -
In Emacs, run
M-x package-install cider
. -
Close and re-open Emacs.
-
Open
.lein/profiles.clj
and remove[cider/cider-nrepl "0.8.1"]
from it.
That should install the latest version. Enjoy!
Organization
I've tried to separate everything logically and document the purpose
of every line. init.el
acts as a kind of table of
contents. It's a good idea to eventually go through init.el
and the
files under the customizations
directory so that you know exactly
what's going on.
Supporting CSS, HTML, JS, etc.
Emacs has decent support for CSS, HTML, JS, and many other file types out of the box, but if you want better support, then have a look at my personal emacs config's init.el. It's meant to read as a table of contents. The emacs.d as a whole adds the following:
- Customizes js-mode and html editing
- Sets indentation level to 2 spaces for JS
- enables subword-mode so that M-f and M-b break on capitalization changes
- Uses
tagedit
to give you paredit-like functionality when editing html - adds support for coffee mode
- Uses enh-ruby-mode for ruby editing. enh-ruby-mode is a little nicer than the built-in ruby-mode, in my opinion.
- Associates many filenames and extensions with enh-ruby-mode (.rb, .rake, Rakefile, etc)
- Adds keybindings for running specs
- Adds support for YAML and SCSS using the yaml-mode and scss-mode packages
In general, if you want to add support for a language then you should be able to find good instructions for it through Google. Most of the time, you'll just need to install the "x-lang-mode" package for it.