Emacs configuration

Table of Contents

Currently tailored for GNU Emacs 29.0.50.

1. Useful resources

2. Early init file

Since we're using straight.el as our package manager, we add the following to early-init.el to prevent package.el from loading packages, prior to our init file loading.

;;; early-init.el --- Early Init File -*- lexical-binding: t; no-byte-compile: t -*-

(setq package-enable-at-startup nil)

Disable GUI elements before we have a chance to peek.

(menu-bar-mode -1) ;; disables menubar
(tool-bar-mode -1) ;; disables toolbar
(scroll-bar-mode -1) ;; disables scrollbar

(setq inhibit-splash-screen t) ;; no thanks
(setq use-file-dialog nil) ;; don't use system file dialog

(setq tab-bar-new-button-show nil) ;; don't show new tab button
(setq tab-bar-close-button-show nil) ;; don't show tab close button
(setq tab-line-close-button-show nil) ;; don't show tab close button
;;; early-init.el ends here

3. Package management

3.1. init.el header

;;; init.el --- Personal configuration file -*- lexical-binding: t; no-byte-compile: t; -*-
;; NOTE: init.el is now generated from readme.org.  Please edit that file instead

3.2. straight.el

Some rules/conventions:

  • When packages don't require installation, use :straight (:type built-in).
  • Prefer multiple setq expressions to one.
  • Prefer :init to :custom.

Quick how-to for straight:

  • The lockfile is under version control at default.el.
  • Create a lockfile by running straight-freeze-versions.
  • Whenever I want to roll back to versions pinned in the lockfile run straight-thaw-versions.
  • Upgrade packages via straight-pull-all.

3.2.1. Bootstrap straight.el

(setq straight-use-package-by-default t) ;; have use-package use straight.el by default.

(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)
         'silent 'inhibit-cookies)
      (goto-char (point-max))
  (load bootstrap-file nil 'nomessage))

(straight-use-package 'use-package) ;; install use-package via straight

4. Emacs

4.1. Variables

(defvar patrl/library-path "~/Dropbox (MIT)/library/"
  "Directory .pdf collection lives.")

(defvar patrl/notes-path "~/notes/"

(defvar patrl/journal-path (concat patrl/notes-path "daily/")
  "Journal entries.")

(defvar patrl/global-bib-file "~/repos/bibliography/master.bib"

(defvar patrl/org-path "~/Dropbox (MIT)/org/"
  "Org path.")

4.2. Defaults

(use-package emacs
  (setq user-full-name "Patrick D. Elliott") ;; my details
  (setq user-mail-address "patrick.d.elliott@gmail.com")

  (defalias 'yes-or-no-p 'y-or-n-p) ;; life is too short

  (setq indent-tabs-mode nil) ;; no tabs

  (setq make-backup-files nil) ;; keep everything under vc 
  (setq auto-save-default nil)

  ;; keep backup and save files in a dedicated directory
  (setq backup-directory-alist
        `((".*" . ,(concat user-emacs-directory "backups")))
        `((".*" ,(concat user-emacs-directory "backups") t)))

  (setq create-lockfiles nil) ;; no need to create lockfiles

  (set-charset-priority 'unicode) ;; utf8 in every nook and cranny
  (setq locale-coding-system 'utf-8
        coding-system-for-read 'utf-8
        coding-system-for-write 'utf-8)
  (set-terminal-coding-system 'utf-8)
  (set-keyboard-coding-system 'utf-8)
  (set-selection-coding-system 'utf-8)
  (prefer-coding-system 'utf-8)
  (setq default-process-coding-system '(utf-8-unix . utf-8-unix))

  (global-set-key (kbd "<escape>") 'keyboard-escape-quit) ;; escape quits everything

  ;; Don't persist a custom file
  (setq custom-file (make-temp-file "")) ; use a temp file as a placeholder
  (setq custom-safe-themes t)            ; mark all themes as safe, since we can't persist now
  (setq enable-local-variables :all)     ; fix =defvar= warnings

  (setq delete-by-moving-to-trash t) ;; use trash-cli rather than rm when deleting files.

  ;; less noise when compiling elisp
  (setq byte-compile-warnings '(not free-vars unresolved noruntime lexical make-local))
  (setq native-comp-async-report-warnings-errors nil)
  (setq load-prefer-newer t)

  ;; FIXME currently using tempel in org-mode triggers this warning
  ;; (setq warning-suppress-types (append warning-suppress-types '((org-element-cache))))

  (show-paren-mode t)

  ;; Hide commands in M-x which don't work in the current mode
  (setq read-extended-command-predicate #'command-completion-default-include-p))

4.3. Electric

(use-package electric
  :straight (:type built-in)
  (electric-pair-mode +1) ;; automatically insert closing parens 
  (setq electric-pair-preserve-balance nil)) ;; more annoying than useful

5. Keybindings

Mnemonic keybindings with SPC as the leader key, inspired by spacemacs and doom emacs.

The local leader , is used for mode-specific bindings.

5.1. General

(use-package general
  ;; integrate general with evil

  ;; set up 'SPC' as the global leader key
  (general-create-definer patrl/leader-keys
    :states '(normal insert visual emacs)
    :keymaps 'override
    :prefix "SPC" ;; set leader
    :global-prefix "M-SPC" ;; access leader in insert mode

  ;; set up ',' as the local leader key
  (general-create-definer patrl/local-leader-keys
    :states '(normal insert visual emacs)
    :keymaps 'override
    :prefix "," ;; set local leader
    :global-prefix "M-," ;; access local leader in insert mode

   :states 'insert
   "C-g" 'evil-normal-state ;; don't stretch for ESC

  ;; unbind some annoying default bindings
    "C-x C-r"   ;; unbind find file read only
    "C-x C-z"   ;; unbind suspend frame
    "C-x C-d"   ;; unbind list directory
    "<mouse-2>" ;; pasting with mouse wheel click

    "SPC" '(execute-extended-command :wk "execute command") ;; an alternative to 'M-x'
    "TAB" '(:keymap tab-prefix-map :wk "tab") ;; remap tab bindings

  ;; help
  ;; namespace mostly used by 'helpful'
    "h" '(:ignore t :wk "help")

  ;; file
    "f" '(:ignore t :wk "file")
    "ff" '(find-file :wk "find file") ;; gets overridden by consult
    "fs" '(save-buffer :wk "save file")

  ;; buffer 
  ;; see 'bufler' and 'popper'
    "b" '(:ignore t :wk "buffer")
    "bb" '(switch-to-buffer :wk "switch buffer") ;; gets overridden by consult
    "bk" '(kill-this-buffer :wk "kill this buffer")
    "br" '(revert-buffer :wk "reload buffer")

  ;; bookmark
    "B" '(:ignore t :wk "bookmark")
    "Bs" '(bookmark-set :wk "set bookmark")
    "Bj" '(bookmark-jump :wk "jump to bookmark")

  ;; universal argument
    "u" '(universal-argument :wk "universal prefix")

  ;; notes
  ;; see 'citar' and 'org-roam'
    "n" '(:ignore t :wk "notes")
    ;; see org-roam and citar sections
    "na" '(org-todo-list :wk "agenda todos")
    ;; agenda

  ;; code
  ;; see 'flymake'
    "c" '(:ignore t :wk "code")

  ;; open
    "o" '(:ignore t :wk "open")
    "os" '(speedbar t :wk "speedbar") ;; TODO this needs some love

  ;; search
  ;; see 'consult'
    "s" '(:ignore t :wk "search")

5.2. Evil

(use-package evil
    "w" '(:keymap evil-window-map :wk "window") ;; window bindings
  (setq evil-search-module 'isearch)

  (setq evil-want-C-u-scroll t) ;; allow scroll up with 'C-u'
  (setq evil-want-C-d-scroll t) ;; allow scroll down with 'C-d'

  (setq evil-want-integration t) ;; necessary for evil collection
  (setq evil-want-keybinding nil)

  (setq evil-split-window-below t)
  (setq evil-vsplit-window-right t)

  (setq evil-want-C-i-jump nil) ;; hopefully this will fix weird tab behaviour

  (setq evil-undo-system 'undo-redo) ;; undo via 'u', and redo the undone change via 'C-r'; only available in emacs 28+.
  (evil-mode t) ;; globally enable evil mode
  ;; set the initial state for some kinds of buffers.
  (evil-set-initial-state 'messages-buffer-mode 'normal)
  (evil-set-initial-state 'dashboard-mode 'normal)
  ;; buffers in which I want to immediately start typing should be in 'insert' state by default.
  (evil-set-initial-state 'eshell-mode 'insert)
  (evil-set-initial-state 'magit-diff-mode 'insert)

5.2.1. Evil collection

(use-package evil-collection ;; evilifies a bunch of things
  :after evil
  (setq evil-collection-outline-bind-tab-p t) ;; '<TAB>' cycles visibility in 'outline-minor-mode'
  ;; If I want to incrementally enable evil-collection mode-by-mode, I can do something like the following:
  ;; (setq evil-collection-mode-list nil) ;; I don't like surprises
  ;; (add-to-list 'evil-collection-mode-list 'magit) ;; evilify magit
  ;; (add-to-list 'evil-collection-mode-list '(pdf pdf-view)) ;; evilify pdf-view

5.2.2. Evil commentary

;; port of Tim Pope's commentary package
(use-package evil-commentary
  :after evil
  (evil-commentary-mode) ;; globally enable evil-commentary

5.2.3. Evil surround

;; port of Tim Pope's surround package
(use-package evil-surround
  :after evil
  :hook (
         (org-mode . (lambda () (push '(?~ . ("~" . "~")) evil-surround-pairs-alist)))
         (org-mode . (lambda () (push '(?$ . ("\\(" . "\\)")) evil-surround-pairs-alist))))
  (global-evil-surround-mode 1) ;; globally enable evil-surround

5.2.4. Evil goggles

;; show visual hints for evil motions
(use-package evil-goggles

  ;; optionally use diff-mode's faces; as a result, deleted text
  ;; will be highlighed with `diff-removed` face which is typically
  ;; some red color (as defined by the color theme)
  ;; other faces such as `diff-added` will be used for other actions

5.3. Avy

Super-charged navigaton.

Use . after an avy command to trigger embark-act on the selected candidate.

(use-package avy
  (defun patrl/avy-action-embark (pt)
          (goto-char pt)
       (cdr (ring-ref avy-ring 0))))
    t) ;; adds an avy action for embark
  (general-def '(normal motion)
    "s" 'evil-avy-goto-char-timer
    "f" 'evil-avy-goto-char-in-line
    "gl" 'evil-avy-goto-line ;; this rules
    ";" 'avy-resume
  (setf (alist-get ?. avy-dispatch-alist) 'patrl/avy-action-embark) ;; avy embark integration

5.3.1. Link hint

(use-package link-hint
    "l" '(link-hint-open-link :wk "open link"))
  (setq browse-url-browser-function 'browse-url-firefox)
  (setq link-hint-avy-style 'pre))

5.4. Which key

Display key bindings.

(use-package which-key
  :after evil
  :init (which-key-mode)

6. Appearance

6.1. Icons

(use-package all-the-icons)

;; prettify dired with icons
(use-package all-the-icons-dired
  (dired-mode . all-the-icons-dired-mode)

6.2. Olivetti

Add some margins (useful for writing prose).

(use-package olivetti
  (setq olivetti-body-width 80)
  (setq olivetti-style 'fancy)
  (setq olivetti-minimum-body-width 50))

6.3. Mode line

Minimal mode line.

(use-package mood-line
  :config (mood-line-mode))

6.4. Fonts

(defun patrl/setup-font-faces ()
  (set-face-attribute 'default nil :font (font-spec :family "Blex Mono Nerd Font" :size 30 :weight 'medium))
  (set-face-attribute 'fixed-pitch nil :font (font-spec :family "Blex Mono Nerd Font" :size 30 :weight 'medium))
  (set-face-attribute 'variable-pitch nil :font (font-spec :family "iA Writer Duospace" :size 30 :weight 'medium))
  (set-fontset-font t 'unicode "DeJa Vu Sans Mono")
  (set-fontset-font t nil "Twitter Color Emoji")

;; run this hook after we have initialized the first time
(add-hook 'after-init-hook 'patrl/setup-font-faces)
;; re-run this hook if we create a new frame from daemonized Emacs
(add-hook 'server-after-make-frame-hook 'patrl/setup-font-faces)

N.b. that this interacts with org-superstars-mode.

6.5. Themes

Visually distinguish between 'real' buffers and everything else.

(use-package solaire-mode
  (solaire-global-mode +1))

Some nice themes:

(use-package tron-legacy-theme
  (setq tron-legacy-theme-vivid-cursor t))
(use-package doom-themes
  ;; Global settings (defaults)
  (setq doom-themes-enable-bold t ; if nil, bold is universally disabled
        doom-themes-enable-italic t)
                                        ; if nil, italics is universally disabled
  (load-theme 'doom-nord t)

  ;; Enable flashing mode-line on errors
  ;; Corrects (and improves) org-mode's native fontification.

Visually highlight todo.

(use-package hl-todo

7. Organization

7.1. Buffer management

7.1.1. TODO Popper

Classify certain buffer types as popups.

Not sure if I want to keep this around.

(use-package popper
        "bp" '(:ignore t :wk "popper")
        "bpc" '(popper-cycle t :wk "cycle")
        "bpt" '(popper-toggle-latest t :wk "toggle latest")
        "bpb" '(popper-toggle-type t :wk "toggle type")
        "bpk" '(popper-kill-latest-popup t :wk "kill latest")
  (setq popper-reference-buffers
          "\\*Async Shell Command\\*"
          "^\\*eshell.*\\*" eshell-mode
          "\\*TeX Help\\*"
          "\\*Embark Collect Live\\*"
  (popper-mode +1)
  (popper-echo-mode +1))

7.1.2. bufler

This has been quite nice so far.

(use-package bufler
  (bufler-workspace-mode t)
  ;; (bufler-workspace-tabs-mode t)
    "bB" '(bufler :wk "bufler") ;; overrides consult
    "bf" '(bufler-workspace-frame-set :wk "bufler workspace frame set") 
    "bl" '(bufler-list :wk "bufler list") 
  (:keymaps 'bufler-list-mode-map
            :states 'normal
            "?" 'hydra:bufler/body
            "RET" 'bufler-list-buffer-switch
            "SPC" 'bufler-list-buffer-peek
            "d" 'bufler-list-buffer-kill)

7.2. Projects

;; use emacs' built-in 'project.el'
(use-package project
    "p" '(:keymap project-prefix-map :wk "project")
  :straight (:type built-in))

7.3. File management

(use-package dired
    "fd" '(dired :wk "dired") ;; open dired (in a directory)
    "fj" '(dired-jump :wk "dired jump")) ;; open direct in the current directory
  ;; ranger like navigation
  (:keymaps 'dired-mode-map
            :states 'normal
            "h" 'dired-up-directory
            "q" 'kill-current-buffer
            "l" 'dired-find-file
  (dired-mode . dired-hide-details-mode) ;; make dired prettier
  :straight (:type built-in))

;; toggle subtree visibility with 'TAB'
;; makes dired a much more pleasant file manager
(use-package dired-subtree)

8. Languages

8.1. Lua

(use-package lua-mode
  :mode "\\.lua\\'")

8.2. Lisp

8.2.1. Sly

;; FIXME - compatibility with corfu
(use-package sly)

8.2.2. lispy

(use-package lispy
  (:keymaps 'lispy-mode-map 
            "TAB" 'indent-for-tab-command) ;; necessary for 'corfu'
  :hook (emacs-lisp-mode . lispy-mode)
  (racket-mode . lispy-mode))

(use-package lispyville
  :hook (lispy-mode . lispyville-mode)
  (:keymaps 'lispyville-mode-map
            "TAB" 'indent-for-tab-command) ;; necessary for 'corfu'
  ;; the following is necessary to retain tab completion in lispy mode 
  ;; TODO play around with keythemes 
  (lispyville-set-key-theme '(operators c-w additional)))

8.3. Org

8.3.1. Org mode


        (use-package org
          ;; :straight (:type built-in)
          (setq org-todo-keywords
                ;; it's extremely useful to distinguish between short-term goals and long-term projects
                '((sequence "TODO(t)" "SOMEDAY(s)" "|" "DONE(d)")
                  (sequence "TO-READ(r)" "READING(R)" "|" "HAVE-READ(d)")
                  (sequence "PROJ(p)" "|" "COMPLETED(c)")))
          (setq org-src-fontify-natively t) ;; fontify code in src blocks
          (setq org-highlight-latex-and-related '(native))
          (setq org-adapt-indentation nil) ;; interacts poorly with 'evil-open-below'
          (org-agenda-files '("~/Dropbox (MIT)/org/agenda/"))
            :keymaps 'org-mode-map
            "l" '(:ignore t :wk "link")
            "ll" '(org-insert-link t :wk "link")
            "lp" '(org-latex-preview t :wk "prev latex")
            "h" '(consult-org-heading :wk "consult heading")
            "d" '(org-cut-special :wk "org cut special")
            "y" '(org-copy-special :wk "org copy special")
            "p" '(org-paste-special :wk "org paste special")
            "b" '(:keymap org-babel-map :wk "babel")
            "t" '(org-todo :wk "todo")
            "s" '(org-insert-structure-template :wk "template")
            "e" '(org-edit-special :wk "edit")
            "i" '(:ignore t :wk "insert")
            "ih" '(org-insert-heading :wk "insert heading")
            "is" '(org-insert-subheading :wk "insert heading")
            "f" '(org-footnote-action :wk "footnote action")
            ">" '(org-demote-subtree :wk "demote subtree")
            "<" '(org-promote-subtree :wk "demote subtree")
          (:keymaps 'org-agenda-mode-map
                    "j" '(org-agenda-next-line)
                    "h" '(org-agenda-previous-line))

          (org-mode . olivetti-mode)
          (org-mode . variable-pitch-mode)
          (org-mode . visual-line-mode)
          (org-mode . org-indent-mode) ;; indent
          ;; (org-mode . org-num-mode) ;; FIXME currently too buggy
          (org-mode . (lambda () (electric-indent-local-mode -1))) ;; disable electric indentation
          (add-to-list 'org-latex-packages-alist '("" "braket" t))

8.3.2. Extra bindings

(use-package evil-org
  :after org
  :hook (org-mode . (lambda () evil-org-mode))
  (require 'evil-org-agenda)

8.3.3. Sidebar

(use-package org-sidebar
  :after org
  :straight (:type git :host github :repo "alphapapa/org-sidebar"))

8.3.4. Cliplink

(use-package org-cliplink
  :after org
    :keymaps 'org-mode-map 
    "lc" '(org-cliplink :wk "cliplink")

8.3.5. Superstar

(use-package org-superstar
  :after org
  (org-mode . (lambda () (org-superstar-mode 1)))
  (setq org-superstar-special-todo-items t)) ;; SOMEDAY consider using emoji for this

8.3.6. Org roam

(use-package org-roam
    "nr" '(:ignore t :wk "roam")
    "nri" '(org-roam-node-insert t :wk "insert node")
    "nrt" '(org-roam-buffer-toggle t :wk "roam buffer toggle")
    "nrc" '(org-roam-capture t :wk "roam capture")
    "nrf" '(org-roam-node-find :wk "find node")
    "nrd" '(:ignore t :wk "dailies")
    "nrdt" '(org-roam-dailies-goto-today :wk "today")
    "nrdt" '(org-roam-dailies-goto-yesterday :wk "today")
    "nrdT" '(org-roam-dailies-goto-tomorrow :wk "today")
    "nrdd" '(org-roam-dailies-goto-date :wk "goto date")
  ;; get tags to show up in 'org-roam-node-find':
  (setq org-roam-node-display-template
        (concat "${title:*} "
                (propertize "${tags:10}" 'face 'org-tag)))
  (setq org-roam-completion-everywhere nil) ;; roam completion anywhere
  (setq org-roam-directory patrl/notes-path)
  (org-roam-db-autosync-mode) ;; ensures that org-roam is available on startup

  ;; dailies config
  (setq org-roam-dailies-directory "daily/")
  (setq org-roam-dailies-capture-templates
        '(("d" "default" entry
           "* %?"
           :target (file+head "%<%Y-%m-%d>.org"
                              "#+title: %<%Y-%m-%d>\n#+filetags: daily\n"))))
  1. TODO configure the org-roam buffer display

8.3.7. Export

(use-package citeproc
  :after org)

(with-eval-after-load 'ox-latex
   (add-to-list 'org-latex-classes
                  ("\\section{%s}" . "\\section*{%s}")
                  ("\\subsection{%s}" . "\\subsection*{%s}")
                  ("\\subsubsection{%s}" . "\\subsubsection*{%s}")
                  ("\\paragraph{%s}" . "\\paragraph*{%s}")
                  ("\\subparagraph{%s}" . "\\subparagraph*{%s}")

8.3.8. Highlighting

(use-package htmlize)

8.3.9. Org-noter

  (use-package org-noter
      :keyamps 'org-noter-doc-mode-map
      "i" 'org-noter-insert-note)
    (setq org-noter-notes-search-path (list patrl/notes-path))
    (setq org-noter-default-notes-file-names '("literature-notes.org"))
    (setq org-noter-hide-other nil)
    (setq org-noter-always-create-frame nil)

8.3.10. TODO checkout org-appear

8.4. TODO haskell

  • Setup LSP

    (use-package haskell-mode)

8.5. racket

(use-package racket-mode
  :hook (racket-mode . racket-xp-mode) ;; n.b. this requires Dr. Racket to be installed as a backend
    :keymaps 'racket-mode-map
    "r" '(racket-run-and-switch-to-repl :wk "run")
    "e" '(racket-eval-last-sexp :wk "eval last sexp")
    :keymaps 'racket-xp-mode-map
    "xr" '(racket-xp-rename :wk "rename")

(use-package pollen-mode)

8.6. nix

(use-package nix-mode
  ;; There's no `nix-mode-map`, so not currently possible to set local bindings.
  :mode "\\.nix\\'")
(use-package nix-update

8.7. latex

Useful resources:

Configuring auctex is a little like dealing with a teetering stack of plates.


  • n b: insert citation via citar (normal mode).
  • , p: preview at point.
  • , c: compile.

Auto-activating snippets:

  • mx: insert in-line equation.
  • mq: insert equation.
  • ii: insert itemize environment.
  • forfor: insert forest environment.
(use-package auctex
  :no-require t
  :mode ("\\.tex\\'" . LaTeX-mode)
  (setq TeX-parse-self t ; parse on load
      TeX-auto-save t  ; parse on save
      TeX-source-correlate-mode t
      TeX-source-correlate-method 'synctex
      TeX-source-correlate-start-server nil
      TeX-electric-sub-and-superscript t
      TeX-engine 'luatex ;; use lualatex by default
      TeX-save-query nil) 

(use-package tex
  :straight auctex
    :keymaps 'LaTeX-mode-map
    ;; "TAB" 'TeX-complete-symbol ;; FIXME let's 'TAB' do autocompletion (but it's kind of useless to be honest)
    "m" '(LaTeX-macro :wk "insert macro")
    "s" '(LaTeX-section :wk "insert section header")
    "e" '(LaTeX-environment :wk "insert environment")
    "p" '(preview-at-point :wk "preview at point")
    "f" '(TeX-font :wk "font")
    "c" '(TeX-command-run-all :wk "compile")
  (setq TeX-electric-math (cons "\\(" "\\)")) ;; '$' inserts an in-line equation '\(...\)'
  (add-hook 'TeX-mode-hook #'visual-line-mode)
  (add-hook 'TeX-mode-hook #'prettify-symbols-mode)
  (add-hook 'TeX-after-compilation-finished-functions
  (add-to-list 'TeX-view-program-selection '(output-pdf "PDF Tools"))
  (add-hook 'TeX-mode-hook #'outline-minor-mode)
  ;; (add-hook 'TeX-mode-hook #'flymake-aspell-setup)
(use-package pdf-tools

evil-tex is a crucial component in my workflow. evil-surround integration makes things a breeze. Some examples:

  • Italicize word from point in normal mode: ysw;i.
(use-package evil-tex
  :hook (LaTeX-mode . evil-tex-mode))
(use-package citar
  :after all-the-icons
  ;; icon support via all-the-icons
  (setq citar-symbols
        `((file ,(all-the-icons-faicon "file-o" :face 'all-the-icons-green :v-adjust -0.1) . " ")
          (note ,(all-the-icons-material "speaker_notes" :face 'all-the-icons-blue :v-adjust -0.3) . " ")
          (link ,(all-the-icons-octicon "link" :face 'all-the-icons-orange :v-adjust 0.01) . " ")))
  (setq citar-symbol-separator "  ")
    "nb" '(citar-open :wk "citar")
  (setq citar-notes-paths (list patrl/notes-path))
  (setq citar-library-paths (list patrl/library-path))
  (setq citar-bibliography (list patrl/global-bib-file))
  1. TODO add "citep" and "citealt" to the supported list of latex citation commands.
  2. TODO add hook for reftex-mode
  3. TODO latexmk
    ;; FIXME
    (use-package auctex-latexmk
      :after latex 
      (setq auctex-latexmk-inherit-TeX-PDF-mode t)

8.7.1. Issues

  1. TODO pdf buffer isn't reverted in preview continuously mode.

    I think probably I just need to use zathura as the pdf viewer, which has its own smart revert functionality.

8.8. markdown

(use-package markdown-mode
  :hook ((markdown-mode . visual-line-mode)
         (markdown-mode . olivetti-mode)
         (markdown-mode . variable-pitch-mode))
  :commands (markdown-mode gfm-mode)
  :mode (("README\\.md\\'" . gfm-mode)
         ("\\.md\\'" . markdown-mode)
         ("\\.markdown\\'" . markdown-mode))
  (setq markdown-command "pandoc")
  (setq markdown-header-scaling t))
(use-package pandoc-mode
  :after markdown-mode
  :hook (markdown-mode . pandoc-mode))

9. Completion

9.1. Vertico with orderless and marginalia

(use-package vertico
  :init (vertico-mode)
  (setq vertico-cycle t) ;; enable cycling for 'vertico-next' and 'vertico-prev'
  (:keymaps 'vertico-map
            ;; keybindings to cycle through vertico results.
            "C-j" 'vertico-next
            "C-k" 'vertico-previous
            "C-f" 'vertico-exit)
  (:keymaps 'minibuffer-local-map
            "M-h" 'backward-kill-word)

(use-package orderless
  (setq completion-styles '(orderless)
        completion-category-defaults nil
        completion-category-overrides '((file (styles partial-completion)))))

(use-package savehist

(use-package marginalia
  :after vertico
  (marginalia-annotators '(marginalia-annotators-heavy marginalia-annotators-light nil))

9.2. Consult

(use-package consult
    "bb" '(consult-buffer :wk "consult buffer")
    "Bb" '(consult-bookmark :wk "consult bookmark")
    "ht" '(consult-theme :wk "consult theme")
    "sr" '(consult-ripgrep :wk "consult rg")
    "sg" '(consult-grep :wk "consult grep")
    "sG" '(consult-git-grep :wk "consult git grep")
    "sf" '(consult-find :wk "consult find")
    "sF" '(consult-locate :wk "consult locate")
    "sl" '(consult-line :wk "consult line")
    "sy" '(consult-yank-from-kill-ring :wk "consult yank from kill ring")
    "i" '(consult-imenu :wk "consult imenu")
  ;; use project.el to retrieve the project root
  (setq consult-project-root-function
        (lambda ()
          (when-let (project (project-current))
            (car (project-roots project))))))

9.3. Embark

(use-package embark
     "." 'embark-act) ;; easily accessible 'embark-act' binding.
  ("C-;" 'embark-dwim)
  (:keymaps 'vertico-map
            "C-." 'embark-act)
  (:keymaps 'embark-heading-map
            "l" 'org-id-store-link)
  (setq prefix-help-command #'embark-prefix-help-command)

(use-package embark-consult
  :after (embark consult)
  :demand t ; only necessary if you have the hook below
  ;; if you want to have consult previews as you move around an
  ;; auto-updating embark collect buffer
  (embark-collect-mode . consult-preview-at-point-mode))

9.4. Corfu

A minimal ui for completion-in-region.

(use-package corfu
  (eval-expression-minibuffer-setup . corfu-mode)
  (corfu-cycle t) ;; allows cycling through candidates
  (corfu-auto nil) ;; disables auto-completion
  (:keymaps 'corfu-map
            "C-j" 'corfu-next
            "C-k" 'corfu-previous
            "SPC" 'corfu-insert-separator ;; for compatibility with orderless

;; FIXME add icons to corfu
;; (use-package kind-icon
;;   :after corfu
;;   :custom
;;   (kind-icon-default-style '(:padding 0 :stroke 0 :margin 0 :radius 0 :height 0.5 :scale 0.5))
;;   (kind-icon-default-face 'corfu-default) ; to compute blended backgrounds correctly
;;   :config
;;   (add-to-list 'corfu-margin-formatters #'kind-icon-margin-formatter))

  :states '(insert)
  "C-k" ;; this was interfering with corfu completion

(use-package emacs
  (setq tab-always-indent 'complete) ;; enable tab completion

9.4.1. TODO this isn't working so well with haskell-mode

9.4.2. TODO consider incorporating the cape package

10. Checkers

  • Use flymake over flycheck.

10.1. FIXME Flymake

(use-package flymake
  :straight (:type built-in)
    :keymaps 'flymake-mode-map
    "cf" '(consult-flymake :wk "consult flymake") ;; depends on consult
    "cc" '(flymake-mode :wk "toggle flymake") ;; depends on consult
  (TeX-mode . flymake-mode) ;; this is now working
  (emacs-lisp-mode . flymake-mode)
  (flymake-no-changes-timeout nil)
  (general-nmap "] !" 'flymake-goto-next-error)
  (general-nmap "[ !" 'flymake-goto-prev-error)

10.2. Spell check

(use-package flymake-aspell
  :after flymake)
(use-package ispell
  :straight (:type built-in)
  (setq ispell-dictionary "en_US")
  (setq ispell-program-name "aspell")
  (setq ispell-silently-savep t)

11. Tools

11.1. Snippets

11.1.1. Auto-activating snippets

(use-package aas
  :hook (LaTeX-mode . aas-activate-for-major-mode)
  :hook (org-mode . aas-activate-for-major-mode)
  ;; easy emoji entry in text mode.
  (aas-set-snippets 'text-mode
    ":-)" "🙂"
    "8-)" "😎"
    ":rofl" "🤣"
    ":lol" "😂"
    "<3" "❤️"
    ":eyes" "👀"
    ":dragon" "🐉"
    ":fire" "🔥"
    ":hole" "🕳️"
    ":flush" "😳"
    ":wow" "😮"
(use-package laas
  :hook ((LaTeX-mode . laas-mode)
         (org-mode . laas-mode))
  (aas-set-snippets 'laas-mode
    ;; I need to make sure not to accidentally trigger the following, so I should only use impossible (or extremely rare) bigrams/trigrams.
    "mx" (lambda () (interactive)
            (yas-expand-snippet "\\\\($1\\\\)$0"))
    "mq" (lambda () (interactive)
            (yas-expand-snippet "\\[$1\\]$0"))
    "*i" (lambda () (interactive)
            (yas-expand-snippet "\\begin{itemize}\n$>\\item $0\n\\end{itemize}"))
    "*I" (lambda () (interactive)
            (yas-expand-snippet "\\begin{enumerate}\n$>\\item $0\n\\end{enumerate}"))
    "*e" (lambda () (interactive)
            (yas-expand-snippet "\\begin{exe}\n$>\\ex $0\n\\end{exe}"))
    "*f" (lambda () (interactive)
            (yas-expand-snippet "\\begin{forest}\n[{$1}\n[{$2}]\n[{$0}]\n]\n\\end{forest}"))
    :cond #'texmathp ; expand only while in math 
    "Olon" "O(n \\log n)"
    ";:" "\\coloneq"
    ";;N" "\\mathbb{N}"
    ";T" "\\top"
    ";B" "\\bot"
    ";;x" "\\times"
    ";;v" "\\veebar"
    ";;u" "\\cup"
    ";;{" "\\subseteq"
    ";D" "\\Diamond"
    ";;b" "\\Box" 
    ;; bind to functions!
    "sum" (lambda () (interactive)
            (yas-expand-snippet "\\sum_{$1}^{$2} $0"))
    "grandu" (lambda () (interactive)
            (yas-expand-snippet "\\bigcup\limits_{$1} $0"))
    "Span" (lambda () (interactive)
             (yas-expand-snippet "\\Span($1)$0"))
    "lam" (lambda () (interactive)
            (yas-expand-snippet "\\lambda $1_{$2}\\,.\\,$0"))
    ;; "set" (lambda () (interactive)
    ;;           (yas-expand-snippet "\\set{ $1 | $2} $0"))
    "txt" (lambda () (interactive)
              (yas-expand-snippet "\\text{$1} $0"))
    ";;o" (lambda () (interactive)
              (yas-expand-snippet "\\oplus"))
    ;; "ev" (lambda () (interactive)
    ;;             (yas-expand-snippet "\\left\\llbracket$3\\right\\rrbracket^$1_$2 $3"))
    ;; clash with event type sigs
    ;; add accent snippets
    :cond #'laas-object-on-left-condition
    "qq" (lambda () (interactive) (laas-wrap-previous-object "sqrt"))

11.1.2. Yasnippet

(use-package yasnippet
  (add-to-list 'yas-snippet-dirs "~/.config/emacs-vanilla/snippets")
  (yas-global-mode 1))

11.1.3. TODO Tempel

Templates can be found in ~/.config/emacs-vanilla/templates.

(use-package tempel
  ("M-+" 'tempel-complete
   "M-*" 'tempel-insert)
  (:keymaps 'tempel-map
            "TAB" 'tempel-next) ;; progress through fields via `TAB'
  (defun tempel-setup-capf ()
    (add-hook 'completion-at-point-functions #'tempel-expand))
  (add-hook 'prog-mode-hook 'tempel-setup-capf)
  (add-hook 'text-mode-hook 'tempel-setup-capf))

11.1.4. Autoinsert

(use-package autoinsert
  :straight (:type built-in)
  (setq auto-insert-query nil) ;; Do not ask when inserting
  (auto-insert-mode 1) ;; enable auto-insert-mode globally
  (add-hook 'find-file-hook 'auto-insert) ;; run auto-insert when a new file is opened
  (setq auto-insert-alist nil) ;; delete default auto-inserts
  1. TODO setup built in package autoinsert for file templates via yasnippet.

11.2. Web preview

(use-package simple-httpd
  :commands httpd-serve-directory)

11.3. Magit

(use-package magit
    "g" '(:ignore t :wk "git")
    "gg" '(magit-status :wk "status")

11.4. Eshell

(use-package eshell
  :straight (:type built-in)
    "oe" '(eshell :wk "eshell")

11.5. LSP

Note I still need to set keybindings

(use-package lsp-mode
  (lsp-completion-provider :none) ;; we use corfu!
  ;; FIXME function isn't getting auto-loaded.
  (defun patrl/lsp-mode-setup-completion ()
    (setf (alist-get 'styles (alist-get 'lsp-capf completion-category-defaults))
          '(orderless))) ;; Configure orderless
  (lsp-mode . lsp-enable-which-key-integration)
  (lsp-completion-mode . patrl/lsp-mode-setup) ;; setup orderless completion style.
  lsp patrl/lsp-mode-setup-completion

(use-package lsp-ui
  :after lsp-mode
  :commands lsp-ui-mode

(use-package lsp-haskell
  :after lsp-mode
  (setq lsp-haskell-server-path "haskell-language-server") ;; for some reason this doesn't get found automatically
  ;; (setq lsp-haskell-formatting-provider "brittany")

11.6. direnv

Essential, since I'm on NixOS.

(use-package direnv

11.7. 0x0

(use-package 0x0
    "x" '(:ignore t :wk "web")
    "x;" '(0x0-dwim t :wk "0x0 dwim")
    "xt" '(0x0-upload-text :wk "0x0 upload text")
    "xf" '(0x0-upload-file :wk "0x0 upload file")
    "xk" '(0x0-upload-kill-ring :wk "0x0 upload kill ring")
    "xp" '(0x0-popup :wk "0x0 popup")
    "xs" '(0x0-shorten-uri :wk "0x0 shorten url")

11.8. TODO Elfeed


;; We write a function to determine how we want elfeed to display the buffer with the current entry.
(defun patrl/elfeed-display-buffer (buf &optional act)
  (pop-to-buffer buf)
  (set-window-text-height (get-buffer-window) (round (* 0.7 (frame-height)))))

(defun patrl/elfeed-search-show-entry-pre (&optional lines)
  "Returns a function to scroll forward or back in the Elfeed search results, displaying entries without switching to them."
  (lambda (times)
    (interactive "p")
    (forward-line (* times (or lines 0)))
    (call-interactively #'elfeed-search-show-entry)
    (select-window (previous-window))
    (unless elfeed-search-remain-on-entry (forward-line -1))))

(use-package elfeed
  :commands elfeed
    "oE" '(elfeed :wk "elfeed"))
  ;; :config
  (setq elfeed-show-entry-switch #'patrl/elfeed-display-buffer))

(use-package elfeed-org
 (setq rmh-elfeed-org-files (list "~/Dropbox (MIT)/org/elfeed.org"))

11.9. TODO Notmuch

A gmail-focused notmuch setup, with lieer as the sync backend.

(use-package notmuch
  ;; in gmail, messages are trashed by removing the 'inbox' tag, and adding the 'trash' tag. This will move messages to the gmail trash folder, but won't permnanently delete them.
  (defvar +notmuch-delete-tags '("+trash" "-inbox" "-unread" "-new"))
  ;; in gmail, messages are archived simply by removing the 'inbox' tag.
  (setq notmuch-archive-tags '("-inbox" "-new"))
  ;; show new mail first
  (setq notmuch-search-oldest-first nil)
  ;; the 'new' tag isn't synced to the gmail server; messages new to notmuch aquire this tag.
  (add-to-list 'notmuch-saved-searches '(:name "new" :query "tag:new" :key "n"))
  (defun +notmuch/search-delete ()
    (notmuch-search-add-tag +notmuch-delete-tags)
  (defun +notmuch/tree-delete ()
    (notmuch-tree-add-tag +notmuch-delete-tags)
    "on" '(notmuch :wk "notmuch")) 
  ;; single key deletion.
  (:keymaps 'notmuch-search-mode-map
            :states 'normal
            "D" '+notmuch/search-delete
  (:keymaps 'notmuch-tree-mode-map
            :states 'normal
            "D" '+notmuch/tree-delete)

12. Staging grounds

12.1. Org transclusion

(use-package org-transclusion
  :after org
    "nt" '(org-transclusion-mode :wk "transclusion mode")))

12.2. Org modern

(use-package org-modern
  :straight (:type git :host github :repo

12.3. FIXME Smooth scrolling

(use-package pdf-continuous-scroll-mode
  :after pdf-tools
  :straight (:type git :host github :repo "dalanicolai/pdf-continuous-scroll-mode.el"))  

12.4. TODO Cape

12.5. Numbex

(use-package numbex
  :straight (:type git :host github :repo "enricoflor/numbex"))

12.6. Deadgrep

(use-package deadgrep
    "sd" '(deadgrep :wk "deadgrep")

12.7. Tree-sitter

(use-package tree-sitter)

(use-package tree-sitter-langs)

12.8. Helpful

(use-package helpful
    "hc" '(helpful-command :wk "helpful command")
    "hf" '(helpful-callable :wk "helpful callable")
    "hh" '(helpful-at-point :wk "helpful at point")
    "hF" '(helpful-function :wk "helpful function")
    "hv" '(helpful-variable :wk "helpful variable")
    "hk" '(helpful-key :wk "helpful key")))

13. Graveyard

Packages i've tried out which, for whatever reason, haven't suited me.

13.1. Cdrt

(use-package crdt

13.2. cdlatex

(use-package cdlatex

13.3. company

(use-package company
  (company-idle-delay nil) ;; turn off auto-completion
  (:keymap 'company-mode-map
           "C-SPC" 'company-complete) ;; keybinding to trigger company completion
  (prog-mode . company-mode)
  (LaTeX-mode . company-mode)
  ;; the following stops company from using the orderless completion style
  ;; makes company much more useful
  (define-advice company-capf
      (:around (orig-fun &rest args) set-completion-styles)
    (let ((completion-styles '(basic partial-completion)))
      (apply orig-fun args)))
(use-package company-bibtex
  (setq company-bibtex-bibliography
        (list patrl/global-bib-file))
  :after company
  (add-to-list 'company-backends 'company-bibtex)

Author: Patrick D. Elliott

Created: 2022-05-10 Tue 11:21