Emacs config
This is my new new simplified Emacs config based on straight.el and use-package.
Install
The following shell script will clone this repository and symlink the
elisp files into a new, empty ~/.emacs.d directory. You may want to
fork this repository and claim this config as your own. If you do,
simply update the REMOTE and REPO variables for your own forked
version:
[email protected]:EnigmaCurry/emacs.git
REPO=${HOME}/git/vendor/enigmacurry/emacs
BRANCH=straight
(set -e
test -d ~/.emacs.d && (echo "~/.emacs.d already exists. Aborting install." && exit 1)
test -d ${REPO} || git clone -b ${BRANCH} ${REMOTE} ${REPO}
mkdir ~/.emacs.d && ls -1 ${REPO}/*.el | xargs -iXX ln -s XX ~/.emacs.d
mkdir ~/.emacs.d/straight && ln -s ${REPO}/straight-versions ~/.emacs.d/straight/versions
)
You will treat your entire ~/.emacs.d directory as ephemeral (ie.
not a git repository). All of your saved configuration should go here
instead, saved in this repository (cloned locally to
~/git/vendor/enigmacurry/emacs). The main emacs configuration,
init.el and early-init.el, are both
symlinked into the freshly created ~/.emacs.d directory. The
straight-versions directory is also symlinked to
~/.emacs.d/straight/versions, which keeps your package lock file
(default.el) versioned inside of git,
so as to maintain exactly reproducible installs.
You can install the optional ec script as an alias to control
emacsclient and start/connect to your emacs sever. Add the
directory to your PATH (~/.bashrc):
PATH=$PATH:/home/ryan/git/vendor/enigmacurry/emacs
If you use dmenu with i3, you can add your PATH directly to the dmenu launcher keybinding:
# excerpt from ~/.config/i3/config
bindsym $mod+d exec --no-startup-id env PATH=$PATH:$HOME/git/vendor/enigmacurry/emacs dmenu_run
Upgrade
From time to time, you should review the versions of your dependencies in your lockfile (default.el).
To upgrade a single package, run M-x straight-pull-package
To upgrade a single package and all of its dependencies, run M-x straight-pull-package-and-deps
To upgrade all packages, run M-x straight-pull-all
After you're done upgrading packages, add the new versions to the lockfile:
## Write new upgraded versions to the lockfile:
M-x straight-freeeze-versions
If you maintain multiple installations, you will also need to run the
following on each other machine after you git pull:
## Update the installed versions according to the lockfile
M-x straight-thaw-versions
Credits and other useful links
Some code samples taken from:
My older emacs configs
Here's my old spacemacs config branch
Here's my old old literate config branch
If you want to see my old old old config from the late 2000s, see the ancient-history branch