Need help with dotemacs?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

bling
247 Stars 41 Forks MIT License 939 Commits 0 Opened issues

Description

emacs configuration for vim users

Services available

!
?

Need anything else?

Contributors list

# 5,942
Vim
viml
statusl...
tabline
926 commits
# 151,345
google-...
Raspber...
google-...
osx
1 commit

dotemacs

This is my personal KISS Emacs config.

intro

There are many emacs configs, what makes this one different?

kiss

This is a keep it simple stupid config. It is built with 3 simple building blocks; small enough that it is white magic instead of black magic.

simple building block 1

(defun require-package (package)
  "Ensures that PACKAGE is installed."
  (unless (or (package-installed-p package)
              (require package nil 'noerror))
    (unless (assoc package package-archive-contents)
      (package-refresh-contents))
    (package-install package)))

The code here is self-explanatory. This is how you declare what packages you want to install and use. This was taken from Purcell's config.

simple building block 2

with-eval-after-load
lets you defer execution of code until after a feature has been loaded. This is used extensively throughout the config, so wrapping macro has been written for ease of use. This is what keeps the config loading fast.

Another useful feature is that it can also be used to run code if a package has been installed by using

-autoloads
; e.g.
(after 'magit
  ;; execute after magit has been loaded
  )
(after "magit-autoloads"
  ;; execute if magit is installed/available
  )
(after [evil magit]
  ;; execute after evil and magit have been loaded
  )

This was taken from milkypostman.

simple building block 3

At the bottom of the

init.el
is the following gem:
(cl-loop for file in (reverse (directory-files-recursively config-directory "\\.el$"))
  do (load file)))

Basically, it recursively finds anything in

config/
and loads it. If you want to add additional configuration for a new language, simply create
new-language.el
in
config/
and it will automatically be loaded. Files are loaded in reverse order so that any functions defined will be available in child nodes.

other building blocks

bindings in one place

Another decision is to keep all keybindings in one place:

/bindings/**/*.el
. Because of this, things like use-package aren't particularly useful here because it doesn't add much value over
(require-package)
and
after
.

Keybindings are the single most differentiating factor between configs. By defining them in one place, if you want to use/fork this config, you can simply change the bindings to your liking and still use all the other preconfigured packages as is. If you're not an Evil user, delete

config-evil.el
and you will get a pure Emacs experience.

lazy installation of major mode packages

By combining

after
,
require-package
, and
auto-mode-alist
, packages are installed only when necessary. If you never open a Javascript file, none of those packages will be installed.

install

git clone https://github.com/bling/dotemacs.git ~/.emacs.d

disclaimer

here be dragons.

license

MIT

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.