README

This is meant to be a drop-in replacement for my ~/.emacs.d dir, so emacs will pick up my custom settings right off the bat. Emacs 24+ required, at a minimum, maybe 25.2+, I'm not quite sure. I'm using the current snapshot which is 27+.

So to try it out (and blow away your own custom settings):

NOTE THE RECURSIVE FLAG

rm -rf ~/.emacs.d
git clone --recursive git@github.com:nixjdm/emacs.d.git ~/.emacs.d

What's in here

This will automatically load package repositories and use them to ensure the packages listed in the init.el are installed. It will install them in the elpa/ dir if they aren't already there. A few submodules are included for things not in (m)elpa / marmalade.

There is also:

• Several themes and a theme cycler installed. Use C-c C-t / M-x cycle-themes to switch themes. They are in a loop and repeat. The theme cycler is a fork of this package. Note, C-c C-t may be repurposed by other modes like elpy, so in that case switch modes, or call M-x cycle-themes.
• Elpy is preconfigured for easy use if you follow the below system install instructions.
• Web-Mode, json-mode, and less-css-mode (for web-development)
• Blacken (opinionated formater for Python)
• flymd (Markdown renderer for browsers)
• markdown-mode
• smooth-scrolling

Elpy Install

Check M-x elpy-config. Install these packages in the appropriate env, or change the path emacs is looking in.

pip install -U jedi flake8 autopep8 black rope yapf

If you are on a Debian based distro, you may need something like this:

sudo apt-get install python3-distutils python-distutils-extra

Noteworthy Key-bindings and functions

Unprefixed lines are functions runable with M-x.

• C-c C-t (cycle-themes) - Note: clobbered by elpy-test in Elpy mode.
• blacken-buffer
• cycle-themes
• flymd-flyit - Render markdown into a browser
• sort-lines-nocase

Elpy

• C-c C-o (elpy-occur-definitions)
• M-. (elpy-goto-definition)
• M-* (pop-tag-mark)
• elpy-config

Contributions

PRs and Issues welcome! You can even get me to add in themes (mostly dark ones). However, this is meant to be my quick install, so I win any bike shedding arguements. Please feel free to fork or use whatever snippet that you want.