Aquastart - An Aquamacs Emacs Starter Kit
This kit tries to provide a nice base for Aquamacs. It is intended mostly for beginner to intermediate users, but hopefully offers a framework to be built up for any user.
Aquamacs is already heavily customized, this just offers some nice defaults.
This starter kit requires the use of the Emacs 24 branch of Aquamacs. See the Installation section for more details.
- Where possible use the original Aquamacs configuration files (customization.el and Preferences.el) so as not to duplicate effort or add complexity.
- Use Emacs 24 built-in package.el where possible to install additional libraries.
- Focus mostly on tools for web developers and system administrators.
- In contrast to Aquamacs defaults, use new windows (frames in Emacs speak) sparingly.
- Use Emacs 24 new themes interface, as opposed to the old color-theme libraries.
You will need the "aquamacs24" branch of the Aquamacs source. I'll assume you already know build software on a Mac, and have the appropriate tools to do so (Xcode, etc).
$ git clone --depth 3 git://github.com/davidswelt/aquamacs-emacs.git ... lot of stuff downloaded ... $ cd aquamacs-emacs $ git checkout aquamacs24 ... more stuff downloaded ... $ ./build-aquamacs ... build build build ... $ mv nexstep/Aquamacs.app /Applications
You should now have a working copy of Aquamacs (using Emacs 24). Start her up and make sure she works. This will also create the default initialization and customization files, which we'll use later.
Now install the starter kik:
$ cd ~/Library/Preferences/Aquamacs Emacs/ $ git clone http://github.com/nedludd/aquastart.git
Add the following to
;; Aquastart -- Aquamacs Emacs Starter Kit ;; http://github.com/nedudd/aquastart.git ;; Set the base directory for Aquastart (setq aquastart-dir (concat (file-name-directory (or (buffer-file-name) load-file-name)) "aquastart/")) ;; set up our various directories to load (add-to-list 'load-path aquastart-dir) (require 'init)
Now restart Aquamacs.
Aquamacs follows OS/X convention and stores all its preferences and
~/Library/Preferences/Aquamacs Emacs. I find this
a pain to type all the time, so I link it to a directory in my home
directory, the more Unix'y way (you don't have to do this if you don't
$ ln -s ~/Library/Preferences/Aquamacs\ Emacs ~/.aquamacs
(Let's call this base configuration directory "the aquamacs directory" or "aquamacs-dir" from now on. The base directory for the starter kit -- the one you cloned and added to "Preferences.el" we'll call "the aquastart directory" or "aquastart-dir").
Anything you customize using the Emacs customize interface (.i.e. "M-x customize-group") will be saved in "customization.el" in the aquamacs directory.
If you want to add your own tweaks and configurations, here's the convention (thanks to Phil Hagelburg):
In your aquastart-dir:
- Put your personalizations in a file called $USER.el (where "$USER" of course is your real username).
- Any ".el" files in a directory called $USER will be loaded automatically.
- If you share your config between hosts, you can use a file called $HOST.el for host specific configuration (where $HOST is your hostname).
Use the emacs "package.el" to install any packages/libraries you need. If what you want is not in the Marmalade Repo (which the place to be these days if you're an Emacs package), you can put it in your $USER directory, or better yet, upload it to Marmalade so everyone can enjoy it.
Adding a package to Marmalade is quite easy. In fact there is a handy tool included for doing just that. If it's a single file package just load it into a buffer and do:
The file should have the standard package headers, although only "Version: " is required. It should have the following in the top lines of the file:
;; package-name.el -- package description ;; Author: Author's name ;; Maintainer: Maintainer's name ;; Version: version number ;; Keywords: some descriptive tags, separated by comma's ;; Commentary: documentation of the package
You do not need to be the author or maintainer of the package to upload it to Marmalade. You will need a login there though, so head to http://marmalade-repo.org and get one.