| core | ||
| modules | ||
| .gitignore | ||
| init.example.el | ||
| LICENSE | ||
| Makefile | ||
| README.md | ||
This is an Emacs configuration for a stubborn, melodramatic and shell-dwelling vimmer disappointed with the text-editor status quo.
Doom tries to look and act like modern editors (whatever that means to me on any given day), emulate vim as best it can and strive to surpass it in any way possible. I've designed it to fit my needs as a software developer, indie game developer, scientist and doom enthusiast.
It was tailored for MacOS 10.11+ and Arch Linux 4.7+, and exclusively for Emacs 25.1+. I use vim everywhere else.
Installation
git clone https://github.com/hlissner/.emacs.d ~/.emacs.d
cd ~/.emacs.d
cp init.example.el init.el # maybe edit init.el
make install
make compile # optional, may take a while
Run make each time you change init.el (and recompile, if necessary).
Running make is the equivalent of doing:
make install # or (doom/packages-install)
make autoloads # or (doom/reload-autoloads)
Deciphering my emacs.d
To get a picture of what's in here, check out:
- init.example.el: what my loadout looks like.
- modules/README.md: a primer into module structure and how the module system works.
- modules/private/hlissner/+bindings.el: my custom keybinds.
- modules/private/hlissner/+commands.el: my custom ex commands.
- modules/ui: the modules that makes my Emacs look the way it does, including my theme, modeline, dashboard and more.
- Find screenshots in the screenshots branch.
Highlights
- A popup management system using shackle for temporary or disposable buffers.
- Workspaces, tab emulation & session persistence with persp-mode.
- Project and workspace-restricted buffer navigation and functions.
- A vim-centric environment with evil-mode
- 2-character motions (ala vim-seek/vim-sneak) with evil-snipe
- Sublime Text-esque multiple cursors with evil-multiedit
- Repeat (most) motions with SPC and shift+SPC (backwards)
- Global C-x omnicompletion
- Fast search utilities:
- Project and buffer navigation with ivy
- File browser sidebar with neotree
- Project search (& replace) with counsel-ag (and wgrep)
- Interactive buffer search with swiper
- REPLs & inline/live code evaluation (using quickrun and repl-toggle) for many languages including Ruby, Python, PHP, JS, Elisp, Haskell and Lua.
- Minimalistic diffs in the fringe with git-gutter-fringe.
- A do-what-I-mean jump-to-definition implementation that tries its darnest to find the definition of what you're looking at. It tries major-mode commands, xref (experimental Emacs library) dumb-jump, ctags (WIP), then counsel-ag.
- Snippets and file-templates with yasnippet.
- A smarter, perdier, Atom-inspired mode-line that includes:
- evil-search/iedit/evil-substitute mode-line integration
- Macro-recording indicator
- Python/ruby version in mode-line (for rbenv/pyenv)
Contributing or troubleshooting
My config wasn't intended for public use, but I'm happy to help you use or crib from my config and I welcome contributions of any kind; documentation, bug fixes or even elisp tips.