An Emacs Starter Kit for the Social Sciences

An Emacs Starter Kit for the Social Sciences

To accompany the Choosing Your Workflow Applications paper, here is the Emacs Starter Kit for the Social Sciences. It is a version of Phil Hagelberg's emacs starter kit by way of Eric Schulte's Org-Mode implementation. I've made some further tweaks and added some tools of particular use to social scientists. The starter-kit includes up-to-date versions of Emacs Speaks Statistics, AucTeX, Magit, Markdown mode, Yasnippet, and assorted other useful bits and pieces. It should work immediately on MacOS with the current version of Emacs.

Solarized (Light) Theme. Some other themes are also included.

What's the motivation for the starter kit? Emacs is a very powerful editor but it is less useful out-of-the-box than it might be, in part because many convenient settings and modes are not activated by default. The starter kit is a drop-in set of nice default settings. The idea is for you to be able to download GNU Emacs, put the starter kit into ~/.emacs.d/, and get to work. If you already use Emacs and have a .emacs file or ~/.emacs.d directory, the starter kit is designed to replace them, while leaving a place for you to easily append your own customizations.

The starter kit is designed to be used with the current version of GNU Emacs. It will probably not work with Aquamacs without modification. More detailed commentary and documentation is provided inside the kit's .org files.

Installation Instructions (MacOS)

Before you Begin

If you want to use the tools that the starter-kit works with—LaTeX, R, Git, Pandoc, and all the rest—then you will need to install them on your Mac. The ground floor is Apple's own suite of Developer Tools, which allow you to compile software yourself and include things like Git. The most straightforward way to get these tools is to open the Terminal app (which can be found in the Applications folder, inside a folder named "Utilities"). At the command prompt ($), type the following, and hit enter:

$ xcode-select --install

A dialog box will appear asking whether you want to install the tools. Choose “Install” and wait for the process to complete.

If you have used Emacs before and already have a .emacs file or .emacs.d directory, back them up and then delete them. See below for details on how to add customizations to the kit.

Getting the Starter Kit

You have two choices. You can download a .zip file of the kit. This will give you a static snapshot of the most recent version. But if you want to keep up with changes to the kit, you should clone the source code using git rather than simply copying a static version of it. You should be using version control on your plain-text documents anyway, so I recommend this second option.


0.1 Get Emacs. Download Emacs here. Alternatively, if you are comfortable with Homebrew, compile and install it from there.

0.2 Install a Modern TeX Distribution and the Skim PDF reader. If you are using MacOS, download MacTeX here and install it.

0.3 Install R and Pandoc. These are not strictly required for the installation to work, and you can skip this step if you like. But you will probably be using them anyway, if you're not already. If you're doing statistical work you will probably want to use R or Stata. R is free and you can download it here. Pandoc is a very useful utility that lets you convert easily between many different forms of plain-text markup (such as Markdown, HTML, LaTeX, and others). Get Pandoc here.

0.4 Note your user name or the name of your computer. If you don't know either, open the Terminal application and do

$ whoami

for your user name and

$ hostname

for the system name. You will need to know your login name to activate the final customization file properly. You can use the system name as well (or instead).


1. If you downloaded a .zip file of the kit, you must uncompress it, move the resulting folder to the top level of your home director and rename it .emacs.d. Assuming the downloaded zip file is in your ~/Downloads folder, open a Terminal window and do this:

$ cd ~/Downloads
$ unzip
$ mv emacs-starter-kit-master ~/.emacs.d

Alternatively, if you are using git (the preferred method), then clone the starter kit from github. Open a Terminal window and do this:

$ git clone git:// ~/.emacs.d

2. Inside the file, change the paths to any BibTeX databases as described at the top of that file.

3. Rename the starter kit's file to that of or, based on the information you noted in 0.4 above. This is where you can add in any of your own further customizations to Emacs.

4. Launch Emacs.

When you first start Emacs after installing the starter-kit, it will try to download packages from the official GNU ELPA repository. Each package will be fetched, compiled by Emacs, and stored in the ~/.emacs.d directory. This process is sometimes prone to hiccups as packages are fetched from the server, so please be patient with it. If it doesn't get everything first time around, quit and relaunch Emacs, and it will try again.

5. (Optional.) Once Emacs is up and running, do M-x starter-kit-compile to byte-compile the starter-kit's files, for slightly faster loading.