chris
/
dotfiles
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
I showed you my source code, pls respond
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
69 Commits
1 Branch
0 Tags
34 MiB
 
 
 
Tree: 0e099491cf
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '0e099491cf'
${ noResults }
dotfiles/posts/immutable-emacs.org

3.0 KiB
Raw Blame History

Immutable Emacs

You can easily create an Immutable and 100% Reproducible custom Emacs configuration with very little effort. My inspiration for this came from the Emacs From Scratch series by System Crafters.

Getting started

Emacs created lots of files relative to user-emacs-directory, which are not part of this configuration and do not belong in the same directory.

  • Disable lockfiles

  • Disable backup files

To acheive this functionality, before anything else happens we change this directory to ~/.cache/emacs, while keeping the old value of user-emacs-directory in our own variable.

(defvar dotfiles/home user-emacs-directory)
(defvar dotfiles/cache "~/.cache/emacs")

(setq create-lockfiles nil
      make-backup-files nil
      user-emacs-directory dotfiles/cache)

Package management

Straight is a 100% functional package manager for Emacs, with integration for use-package, a common way to download / configure / install Emacs packages.

  • Use the development branch

  • Integrate with use-package

Apply the configurations prior to bootstrapping the package manager, by setting (writing) to the variables that straight will ultimately read from.

(setq straight-repository-branch "develop"
      straight-use-package-by-default t)

Bootstrap the package manager, downloading, installing, or configuring depending on the state of the configuration. All packages are downloaded and built from source, and can be pinned to specific git commit hashes.

(defvar bootstrap-version)
(let ((bootstrap-file
       (expand-file-name "straight/repos/straight.el/bootstrap.el" user-emacs-directory))
      (bootstrap-version 5))
  (unless (file-exists-p bootstrap-file)
    (with-current-buffer
        (url-retrieve-synchronously
         "https://raw.githubusercontent.com/raxod502/straight.el/develop/install.el"
         'silent 'inhibit-cookies)
      (goto-char (point-max))
      (eval-print-last-sexp)))
  (load bootstrap-file nil 'nomessage))

Complete the integration with use-package by installing it with straight-use-package:

(straight-use-package 'use-package)

A E S T H E T I C S

If you've ever looked at default Emacs, you know that it's one of the ugliest GUI applications out of the box. Including a few packages, cherry picked from Doom can bring Emacs out of the eightes!

(use-package all-the-icons)
(use-package doom-modeline :init (doom-modeline-mode 1))
(use-package doom-themes :init (load-theme 'doom-one t))

Conclusion

Now that the stateful and immutable files are seperated, and the default look has been improved slightly you're left with a clean, immutable, and reproducible Emacs configuration to continue hacking on.

Enjoy it!