dotfiles

config.org (141339B)

---

 * macOS installation info
 On macOS, I use Homebrew to install Emacs from daviderestivo/emacs-head/emacs-head@28.
 I install with ~--HEAD --with-dbus --with-cocoa --with-xwidgets --with-native-comp~.
 
 * Why I choose use-package
 - provides bind-key by default
 - is mostly just macros that wrap the needed stuff from package.el. can check that with ~macroexpand~.
 - adds a bunch of performance improvements
 * Let me know when we're at a certain version
 #+begin_src emacs-lisp
   (when (version<= "30" emacs-version)
     (message "Check out C-x w d to make windows dedicated."))
 #+end_src
 * Install from source
 Emacs 29 ships with a way to install packages from source, here's a small wrapper around it.
 
 #+begin_src emacs-lisp
   (cl-defun za/package-vc-install (&key (fetcher "github") repo name rev backend load)
     "Install a package from a remote if it's not already installed.
   This is a thin wrapper around `package-vc-install' in order to
   make non-interactive usage more ergonomic.  Takes the following
   named arguments:
 
   - FETCHER the remote where to get the package (e.g., \"gitlab\").
     If omitted, this defaults to \"github\".
 
   - REPO should be the name of the repository (e.g.,
   \"slotThe/arXiv-citation\".
 
   - NAME, REV, and BACKEND are as in `package-vc-install' (which
     see).
 
   - LOAD is optionally a subdirectory that should be added to `load-path'."
     (let* ((url (cond ((string-match-p (rx bos "http" (? ?s) "://") repo)
                        repo)
                       (t (format "https://www.%s.com/%s" fetcher repo))))
            (iname (when name (intern name)))
            (pac-name (or iname (intern (file-name-base repo))))
            (to-load (when load
                       (format "%s/%s"
                               (package-desc-dir (package-get-descriptor pac-name))
                               load))))
       (unless (package-installed-p pac-name)
         (package-vc-install url iname rev backend))
       (when load
         (unless (file-directory-p to-load)
           (user-error "Not a readable dir: %s" to-load))
         (add-to-list 'load-path to-load))
       (message "%s" pac-name)))
 #+end_src
 
 You can use this in use-package with an ~:init~ clause.
 
 * exec-path-from-shell (macOS)
 In macOS, the path is not set correctly (i.e. as it is in the terminal) in the GUI app. This fixes it.
 Not needed when using emacs-plus, because it has a custom patch for it. It also defines a [[https://github.com/d12frosted/homebrew-emacs-plus?tab=readme-ov-file#system-appearance-change][custom variable]] which hopefully should be enough to detect if we're running emacs-plus.
 
 #+begin_src emacs-lisp
   (when (and (string-equal system-type "darwin")
              (not (boundp 'ns-system-appearance-change-functions)))
     (use-package exec-path-from-shell
       :config
       (add-to-list 'exec-path-from-shell-variables "NOTMUCH_CONFIG")
       (exec-path-from-shell-initialize)))
 #+end_src
 
 * Emacs file locations
 ** Auto-Save files
 By default, auto-save files ("#file#") are placed in the same directory as the file itself.
 I want to put this all in some unified place:
 
 #+begin_src emacs-lisp
   (let ((saves-directory "~/.local/share/emacs/saves/"))
     (unless (file-directory-p saves-directory)
       (make-directory saves-directory))
     (setq auto-save-file-name-transforms
           `((".*" ,saves-directory t))))
 #+end_src
 
 ** Backup files
 By default, backup files (those with a tilde) are saved in the same directory as the currently edited file.
 This setting puts them in ~/.local/share/emacs/backups.
 
 #+begin_src emacs-lisp
   (let ((backups-directory "~/.local/share/emacs/backups"))
     (unless (file-directory-p backups-directory)
       (make-directory backups-directory))
     (setq backup-directory-alist `(("." . ,backups-directory)))
     (setq backup-by-copying t))
 #+end_src
 
 ** Custom settings file
 Both commands are necessary.
 First one tells Emacs where to save customizations.
 The second one actually loads them.
 
 #+begin_src emacs-lisp
   (setq custom-file (expand-file-name (concat user-emacs-directory "custom.el")))
   (load custom-file)
 #+end_src
 ** Delete by trash
 #+begin_src emacs-lisp
   (setq delete-by-moving-to-trash t)
   (unless (fboundp 'system-move-file-to-trash)
     (setq trash-directory "~/.Trash"))
 #+end_src
 * Daemon
 I want to have a way to kill the Emacs daemon.
 So, define a function that kills the frame, and with a prefix kills emacs.
 
 #+begin_src emacs-lisp
   (defun za/emacsclient-c-x-c-c (&optional arg)
     "If running in emacsclient, make C-x C-c exit frame, and C-u C-x C-c exit Emacs."
     (interactive "P") ; prefix arg in raw form
     (if arg
         (save-buffers-kill-emacs)
       (save-buffers-kill-terminal)))
 #+end_src
 
 Then, if I'm in an emacsclient, I want to bind C-x C-c to that function (if not, I just want the default keybinding):
 
 #+begin_src emacs-lisp
   ;; If not running in emacsclient, use the default bindings
   (if (daemonp)
       (bind-key "C-x C-c" #'za/emacsclient-c-x-c-c))
 #+end_src
 
 Furthermore, I want to set the theme correctly whenever I connect with 'emacsclient':
 
 #+begin_src emacs-lisp
   (if (daemonp)
       (add-hook 'after-make-frame-functions #'za/auto-select-theme))
 #+end_src
 * Sound support
 On macOS, you can use afplay:
 
 #+begin_src emacs-lisp
   (defun za/play-sound-file-macos (file &optional volume device)
     "Play sound using `afplay` on macOS"
     (unless (file-readable-p file)
       (user-error "File %s not readable." file))
 
     ;; the `apply` is required here because I need to build a list of arguments
     (apply 'start-process `("afplay" nil
                             "afplay"
                             ,@(if volume (list "-v" (int-to-string volume)))
                             ,file)))
 #+end_src
 
 Then redefine the play-sound-file function where needed:
 
 #+begin_src emacs-lisp
   (cond ((and (not (fboundp 'play-sound-internal))
               (eq system-type 'darwin))
          (advice-add 'play-sound-file :override #'za/play-sound-file-macos)))
 #+end_src
 * DISABLED Fix non-dbus macOS notification
 macOS version might not be compiled with dbus support; in that case you can use e.g. terminal-notifier.
 If you use the ~sender~ option, notifications don't show
 unless the app is in the background. [[https://github.com/julienXX/terminal-notifier/issues/68][See this Github issue.]]
 
 #+begin_src emacs-lisp :tangle no
   ;; on mac without dbus:
   (org-show-notification-handler
    (lambda (str) (start-process "terminal-notifier" nil (executable-find "terminal-notifier")
                                 "-title" "Timer done"
                                 "-message" str
                                 "-group" "org.gnu.Emacs"
                                 "-ignoreDnD"
                                 "-activate" "org.gnu.Emacs")))
 #+end_src
 * Custom notification functions
 #+begin_src emacs-lisp
   (defun za/notify (title message)
     "Show notification with TITLE and MESSAGE."
     (ignore-errors (require 'notifications))
     (cond ((fboundp 'ns-do-applescript)
            (ns-do-applescript
             (format "display notification \"%s\" with title \"%s\""
                     (replace-regexp-in-string "\"" "#" message)
                     (replace-regexp-in-string "\"" "#" title))))
           ((string= system-type "gnu/linux")
            (require 'notifications)
            (notifications-notify :title title :body message))
           (t (error "No notification handler defined!"))))
 
   (defun za/send-notification-interactivity-required (&rest _)
     "Notify that a function needs action."
     (za/notify "Interactivity required" "A function requires interactivity."))
 
   (defun za/notify-on-interactivity (func &rest r)
     "Send a notification whenever FUNC requires interactivity.
   Used as :around advice, calling FUNC with arguments R."
     (advice-add #'y-or-n-p :before #'za/send-notification-interactivity-required)
     (advice-add #'yes-or-no-p :before #'za/send-notification-interactivity-required)
     (advice-add #'user-error :before #'za/send-notification-interactivity-required)
     (with-demoted-errors "Error in %s" (apply func r))
     (advice-remove #'y-or-n-p #'za/send-notification-interactivity-required)
     (advice-remove #'yes-or-no-p #'za/send-notification-interactivity-required)
     (advice-remove #'user-error #'za/send-notification-interactivity-required))
 #+end_src
 
 * Editing
 ** Everything is UTF-8
 #+begin_src emacs-lisp
   (set-language-environment 'utf-8)
   (setq locale-coding-system 'utf-8)
   (setq buffer-file-coding-system 'utf-8-unix)
   (set-terminal-coding-system 'utf-8)
   (set-keyboard-coding-system 'utf-8)
   (set-selection-coding-system 'utf-8)
   (prefer-coding-system 'utf-8)
 #+end_src
 ** Overwrite selection on typing
 Normally, when I select something and start typing, Emacs clears the selection, i.e. it deselects and inserts text after the cursor.
 I want to replace the selection.
 
 #+begin_src emacs-lisp
   (delete-selection-mode t)
 #+end_src
 
 ** Strip trailing whitespace
 You can show trailing whitespace by setting show-trailing-whitespace to 't'.
 But I want to automatically strip trailing whitespace.
 Luckily there's already a function for that, I just need to call it in a hook:
 
 #+begin_src emacs-lisp
   (add-hook 'before-save-hook #'delete-trailing-whitespace)
 #+end_src
 
 ** Formatting & indentation
 
 Show a tab as 8 spaces:
 
 #+begin_src emacs-lisp
   (setq-default tab-width 8)
 #+end_src
 
 Never insert tabs with indentation by default:
 
 #+begin_src emacs-lisp
   (setq-default indent-tabs-mode nil)
 #+end_src
 
 Allow switching between the two easily:
 
 #+begin_src emacs-lisp
   (defun indent-tabs ()
     (interactive)
     (setq indent-tabs-mode t))
   (defun indent-spaces ()
     (interactive)
     (setq indent-tabs-mode nil))
 #+end_src
 
 Indentation for various modes:
 
 #+begin_src emacs-lisp
   (setq-default sh-basic-offset 2
                 c-basic-offset 4)
 #+end_src
 
 ** Wrapping
 A function to toggle wrapping:
 
 #+begin_src emacs-lisp
   (defvar-local za/wrapping nil "Wrapping changes per buffer.")
 
   (defun za/toggle-wrap (&optional enable)
     "Toggle line wrapping settings. With ENABLE a positive number, enable wrapping. If ENABLE is negative or zero, disable wrapping."
     (interactive "P") ; prefix arg in raw form
 
     ;; If an argument is provided, prefix or otherwise
     (if enable
         (let ((enable (cond ((numberp enable)
                              enable)
                             ((booleanp enable)
                              (if enable 1 0))
                             ((or (listp enable) (string= "-" enable))
                              (prefix-numeric-value enable)))))
           ;; If zero or negative, we want to disable wrapping, so pretend it's currently enabled.
           ;; And vice versa.
           (cond ((<= enable 0) (setq za/wrapping t))
                 ((> enable 0) (setq za/wrapping nil)))))
 
 
     (let ((disable-wrapping (lambda ()
                               (visual-line-mode -1)
                               (toggle-truncate-lines t)))
           (enable-wrapping (lambda ()
                              (toggle-truncate-lines -1)
                              (visual-line-mode))))
 
       ;; If za/wrapping is not locally set, infer its values from the enabled modes
       (unless (boundp 'za/wrapping)
         (setq za/wrapping (and visual-line-mode
                                (not truncate-lines))))
 
       ;; Toggle wrapping based on current value
       (cond (za/wrapping
              (funcall disable-wrapping)
              (setq za/wrapping nil)
              (message "Wrapping disabled."))
             (t
              (funcall enable-wrapping)
              (setq za/wrapping t)
              (message "Wrapping enabled.")))))
 #+end_src
 
 And a keybinding to toggle wrapping:
 
 #+begin_src emacs-lisp
   (bind-key "C-c q w" #'za/toggle-wrap)
 #+end_src
 
 And fringe indicators:
 
 #+begin_src emacs-lisp
   (setopt visual-line-fringe-indicators '(left-curly-arrow right-curly-arrow))
 #+end_src
 ** Pager toggle
 M-x view-mode enables pager behavior.
 I want read-only files to automatically use pager mode:
 
 #+begin_src emacs-lisp
   (setq view-read-only t)
 #+end_src
 ** Prefer newer file loading
 #+begin_src emacs-lisp
   (setq load-prefer-newer t)
 #+end_src
 
 ** Automatically find tags file
 When opening a file in a git repo, try to discover the etags file:
 
 #+begin_src emacs-lisp
   (defun current-tags-file ()
     "Get current tags file"
     (let* ((tagspath ".git/etags")
            (git-root (locate-dominating-file (buffer-file-name) tagspath)))
       (if git-root
           (expand-file-name tagspath git-root))))
 
   (setq default-tags-table-function #'current-tags-file)
 #+end_src
 
 There's probably a better way to write this. I need to ask Reddit for feedback at some point.
 
 ** End sentences with one space
 Emacs uses the rather old-fashioned convention of treating a period followed by double spaces as end of sentence. However, it is more common these days to end sentences with a period followed by a single space.
 
 Let a period followed by a single space be treated as end of sentence:
 
 #+begin_src emacs-lisp
   (setopt sentence-end-double-space nil)
 #+end_src
 * Keybindings
 ** Expansion/completion
 Use hippie expand instead of dabbrev-expand:
 
 #+begin_src emacs-lisp
   (bind-key "M-/" #'hippie-expand)
 #+end_src
 
 ** Zap up to char
 It's more useful for me to be able to delete up to a character instead of to and including a character:
 
 #+begin_src emacs-lisp
   (defun za/zap-up-to-char-icase ()
     "Ignore case for zap-up-to-char"
     (interactive)
     (let ((case-fold-search nil))
       (call-interactively #'zap-up-to-char)))
   (bind-key "M-z" #'za/zap-up-to-char-icase)
 #+end_src
 
 ** Forward-word and forward-to-word
 Change M-f to stop at the start of the word:
 
 #+begin_src emacs-lisp
   (bind-key "M-f" #'forward-to-word)
 #+end_src
 
 Bind ESC M-f to the old functionality of M-f (stop at end of word)
 
 #+begin_src emacs-lisp
   (bind-key "ESC M-f" #'forward-word)
 #+end_src
 
 ** Rectangle insert string
 #+begin_src emacs-lisp
   (bind-key "C-x r I" #'string-insert-rectangle)
   (bind-key "C-x r R" #'replace-rectangle)
 #+end_src
 
 ** Toggle auto-revert-mode
 Sometimes I want to toggle auto reverting (or autoread) of buffer:
 
 #+begin_src emacs-lisp
   (bind-key "C-c q a" #'auto-revert-mode)
 #+end_src
 ** Fast access to view-mode (pager)
 I want to bind view-mode to a key for easy access:
 
 #+begin_src emacs-lisp
   (bind-key "C-c q r" 'view-mode)
 #+end_src
 
 ** Kill this buffer
 I like to be able to kill a buffer instantly:
 
 #+begin_src emacs-lisp
   (bind-key "s-<backspace>" 'kill-current-buffer)
 #+end_src
 
 ** Delete this file (and kill the buffer)
 #+begin_src emacs-lisp
   (defun za/delete-this-file ()
     "Kill the current buffer and delete its associated file."
     (interactive)
     (let ((fname (buffer-file-name))
           (buf (current-buffer)))
       (unless (and fname (file-exists-p fname))
         (user-error "Buffer has no associated file."))
 
       (unless (yes-or-no-p (format "Really delete %s and its buffer?" fname))
         (user-error "User cancelled."))
 
       (delete-file fname 'trash-if-enabled)
       (kill-buffer buf)
       (message "Deleted %s and killed its buffer." fname)))
 
   (bind-key "C-c s-<backspace>" #'za/delete-this-file)
 #+end_src
 
 ** Toggle fullscreen
 I'll use the keybinding that's standard on macOS:
 
 #+begin_src emacs-lisp
   (bind-key "C-s-f" #'toggle-frame-fullscreen)
 #+end_src
 
 ** Sexp manipulation
 When I write lisp, sometimes I want to switch two sexps (e.g. ~(one) (two)~ → ~(two) (one)~), so a key binding is nice for that:
 
 #+begin_src emacs-lisp
   (bind-key "C-S-t" #'transpose-sexps)
 #+end_src
 
 Also, to raise a sexp (e.g. ~(one (two))~ → ~(two)~):
 
 #+begin_src emacs-lisp
   (bind-key "C-S-u" #'raise-sexp)
 #+end_src
 
 ** Dedicated windows
 Sometimes I want to avoid Emacs overriding a window's contents.
 So I create a keybinding to toggle dedicated on a window:
 
 #+begin_src emacs-lisp
   (defun za/toggle-window-dedicated-p ()
     "Toggle set-window-dedicated-p on current window"
     (interactive)
     (cond ((window-dedicated-p (selected-window))
            (set-window-dedicated-p (selected-window) nil)
            (message "Window no longer dedicated"))
           (t
            (set-window-dedicated-p (selected-window) t)
            (message "Window marked as dedicated"))))
 
   (bind-key "C-x 9" #'za/toggle-window-dedicated-p)
 
 #+end_src
 
 ** Rotate windows horizontal ↔ vertical
 #+begin_src emacs-lisp
   (defun za/rotate-windows ()
     (interactive)
     (if (= (count-windows) 2)
         (let* ((this-win-buffer (window-buffer))
                (next-win-buffer (window-buffer (next-window)))
                (this-win-edges (window-edges (selected-window)))
                (next-win-edges (window-edges (next-window)))
                (this-win-2nd (not (and (<= (car this-win-edges)
                                            (car next-win-edges))
                                        (<= (cadr this-win-edges)
                                            (cadr next-win-edges)))))
                (splitter
                 (if (= (car this-win-edges)
                        (car (window-edges (next-window))))
                     'split-window-horizontally
                   'split-window-vertically)))
           (delete-other-windows)
           (let ((first-win (selected-window)))
             (funcall splitter)
             (if this-win-2nd (other-window 1))
             (set-window-buffer (selected-window) this-win-buffer)
             (set-window-buffer (next-window) next-win-buffer)
             (select-window first-win)
             (if this-win-2nd (other-window 1))))))
 #+end_src
 
 #+begin_src emacs-lisp
   (bind-key "C-x 7" #'za/rotate-windows)
 #+end_src
 
 ** Open line like in Vim
 I prefer to open-line the way o/O works in Vim:
 
 #+begin_src emacs-lisp
   ;; Autoindent open-*-lines
   (defvar za/open-line-newline-and-indent t
     "Modify the behavior of the open-*-line functions to cause them to autoindent.")
 
   (defun za/open-line (prefix)
     "Open line like `o`/`O` in Vim. Negative prefix for line above, positive for below."
     (interactive "p")
     (cond ((< prefix 0)
            (beginning-of-line)
            (open-line (abs prefix)))
           (t
            (end-of-line)
            (open-line prefix)
            (forward-line 1)))
     (when za/open-line-newline-and-indent
       (indent-according-to-mode)))
 
   (defun za/open-line-keep-point (prefix)
     "Open line like `o`/`O` in Vim but don't move point. Negative prefix for line above, positive for below."
     (interactive "p")
     (save-mark-and-excursion (za/open-line prefix)))
 #+end_src
 
 And keybindings:
 
 #+begin_src emacs-lisp
   (bind-key "C-o" #'za/open-line)
   (bind-key "C-M-o" #'za/open-line-keep-point)
 #+end_src
 
 ** Unfill region/paragraph
 Taken from here: https://www.emacswiki.org/emacs/UnfillParagraph
 
 #+begin_src emacs-lisp
   (defun za/unfill-paragraph (&optional region)
     "Takes a multi-line paragraph and makes it into a single line of text."
     (interactive (progn (barf-if-buffer-read-only) '(t)))
     (let ((fill-column (point-max))
           ;; This would override `fill-column' if it's an integer.
           (emacs-lisp-docstring-fill-column t))
       (fill-paragraph nil region)))
 
   (bind-key "M-Q" #'za/unfill-paragraph)
 #+end_src
 ** Easily edit my config
 Bind a keyboard shortcut to open my config.
 The "(interactive)" means that it can be called from a keybinding or from M-x.
 
 #+begin_src emacs-lisp
   (defun za/edit-config-org ()
     "Edit my config.org file"
     (interactive)
     (find-file (expand-file-name "config.org" user-emacs-directory)))
 #+end_src
 
 #+begin_src emacs-lisp
   (bind-key "C-c E" 'za/edit-config-org)
 #+end_src
 ** Visible mode
 #+begin_src emacs-lisp
   (bind-key (kbd "C-c q v") #'visible-mode)
 #+end_src
 ** Clone buffer indirectly by default
 #+begin_src emacs-lisp
   (bind-key (kbd "C-x x n") #'clone-indirect-buffer)
 #+end_src
 * Custom functions
 ** Make region readonly or writable
 #+begin_src emacs-lisp
   (defun za/set-region-read-only (begin end)
     "Sets the read-only text property on the marked region.
   Use `set-region-writeable' to remove this property."
     ;; See https://stackoverflow.com/questions/7410125
     (interactive "r")
     (with-silent-modifications
       (put-text-property begin end 'read-only t)))
 
   (defun za/set-region-writeable (begin end)
     "Removes the read-only text property from the marked region.
   Use `set-region-read-only' to set this property."
     ;; See https://stackoverflow.com/questions/7410125
     (interactive "r")
     (with-silent-modifications
       (remove-text-properties begin end '(read-only t))))
 #+end_src
 ** Insert macro as Lisp
 From here: https://www.masteringemacs.org/article/keyboard-macros-are-misunderstood
 
 #+begin_src emacs-lisp
   (use-package kmacro
     :ensure nil ; included with Emacs
     :bind (:map kmacro-keymap
                 ("I" . kmacro-insert-macro))
     :config
     (defalias 'kmacro-insert-macro 'insert-kbd-macro)
 
     ;; Add advice to ignore errors on `kmacro-keyboard-macro-p`, it was
     ;; messing up because of some entry in `obarray`
     (advice-add #'kmacro-keyboard-macro-p :around (lambda (fun sym) "Ignore errors." (ignore-errors (funcall fun sym)))))
 #+end_src
 ** Show local help at point when idling
 #+begin_src emacs-lisp
   (defun za/echo-area-tooltips ()
     "Show tooltips in the echo area automatically for current buffer."
     (setq-local help-at-pt-display-when-idle t
                 help-at-pt-timer-delay 0)
     (help-at-pt-cancel-timer)
     (help-at-pt-set-timer))
 #+end_src
 
 ** Info manual functions
 For some reason, these things don't show up in the index:
 
 #+begin_src emacs-lisp
   (defun elisp-info (&optional node)
     "Read documentation for Elisp in the info system.
   With optional NODE, go directly to that node."
     (interactive)
     (info (format "(elisp)%s" (or node ""))))
 #+end_src
 
 Though I can also just use ~info-display-manual~.
 
 ** Radio
 Just a wrapper function to my radio script:
 
 #+begin_src emacs-lisp
   (defun radio ()
     "Play an internet radio"
     (interactive)
     (ansi-term "radio" "*radio*"))
 #+end_src
 
 ** no-op
 #+begin_src emacs-lisp
   (defun za/no-op (&rest args))
 #+end_src
 
 ** Syncthing
 Some functions to start/stop syncthing.
 #+begin_src emacs-lisp
   (defconst za/st-buffer-name "*syncthing*" "Buffer name for the syncthing process.")
   (defun za/st ()
     "Start syncthing"
     (interactive)
     (if (get-buffer-process za/st-buffer-name)
         (user-error "Syncthing is already running."))
     (async-shell-command "syncthing serve --no-browser" za/st-buffer-name))
 
   (defun za/st-kill ()
     "Stop syncthing"
     (interactive)
     (unless (get-buffer-process za/st-buffer-name)
       (user-error "Syncthing is not running."))
     (async-shell-command "syncthing cli operations shutdown"))
 #+end_src
 ** Replace typographic quotes
 #+begin_src emacs-lisp
   (defun za/replace-typographic-quotes ()
     "Replace typographic quotes with plain quotes"
     (interactive)
     (save-mark-and-excursion
       (goto-char (point-min))
       (while (re-search-forward (rx (any ?“ ?”)) nil 'noerror)
         (replace-match "\""))
       (goto-char (point-min))
       (while (re-search-forward (rx (any "‘" "’")) nil 'noerror)
         (replace-match "'"))))
 #+end_src
 ** Distraction-free on current buffer
 #+begin_src emacs-lisp
   (defun za/buffer-focus-no-distractions ()
     "Focus on this buffer"
     (interactive)
     (cond ((or (not (boundp 'za/no-distractions))
                (not za/no-distractions))
            (olivetti-mode 1)
            (line-number-mode 0)
            (display-line-numbers-mode 0)
            (window-configuration-to-register ?w)
            (delete-other-windows)
            (setq-local za/tmp/mode-line-format mode-line-format)
            (setq-local mode-line-format nil)
            (setq-local za/tmp/internal-border-width (frame-parameter nil 'internal-border-width))
            (set-frame-parameter nil 'internal-border-width 20)
            (setq-local za/no-distractions t)
            (message "Window configuration stored in register W"))
           (za/no-distractions
            (set-frame-parameter nil 'internal-border-width za/tmp/internal-border-width)
            (line-number-mode 0)
            (display-line-numbers-mode 1)
            (setq-local mode-line-format za/tmp/mode-line-format)
            (jump-to-register ?w)
            (olivetti-mode 0)
            (setq-local za/no-distractions nil))))
 #+end_src
 * Interface
 ** Theme
 Icons required for some parts of the doom theme:
 
 #+begin_src emacs-lisp
   (use-package all-the-icons)
 #+end_src
 
 Load Doom Emacs themes:
 
 #+begin_src emacs-lisp
   (use-package doom-themes
     :config
     ;; 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
 
     ;; Enable flashing mode-line on errors
     (doom-themes-visual-bell-config)
 
     ;; Corrects (and improves) org-mode's native fontification.
     (doom-themes-org-config))
 #+end_src
 
 Define the themes I want:
 
 #+begin_src emacs-lisp
   (defconst za/dark-theme-name 'doom-one "A symbol representing the name of the dark theme I use.")
   (defconst za/light-theme-name 'jokull "A symbol representing the name of the light theme I use.")
   ;; I used to use doom-acario-light before writing my own theme
 
   (defun za/dark-theme ()
     "Switch to dark theme"
     (interactive)
     (mapc #'disable-theme custom-enabled-themes)
     (load-theme za/dark-theme-name t)
     (add-hook 'pdf-view-mode-hook #'pdf-view-midnight-minor-mode))
 
   (defun za/light-theme ()
     "Switch to light theme"
     (interactive)
     (mapc #'disable-theme custom-enabled-themes)
     (load-theme za/light-theme-name t)
     (remove-hook 'pdf-view-mode-hook #'pdf-view-midnight-minor-mode))
 #+end_src
 
 Change theme depending on the current system theme.
 The way I check for dark mode is defined in 'dark-mode-p'; currently I use the presence of the ~/.config/dark-theme file to indicate when dark theme is set.
 I quote the call to ~file-exists-p~ because I want to evaluate it on-demand, not immediately.
 A function ending in '-p' is a predicate, i.e. returns true or false.
 If calling a function that's in a variable, you have to use 'funcall'.
 To evaluate a quoted form, use 'eval'.
 
 #+begin_src emacs-lisp
   (defun za/auto-select-theme (&rest _)
     "Automatically select dark/light theme based on presence of ~/.config/dark-theme"
     (let ((dark-mode-p '(file-exists-p "~/.config/dark-theme")))
       (if (eval dark-mode-p)
           (za/dark-theme)
         (za/light-theme))))
 
   (za/auto-select-theme)
 #+end_src
 
 ** Font
 I want Menlo, size 12:
 
 #+begin_src emacs-lisp
   (add-to-list 'default-frame-alist '(font . "Menlo-13"))
   (custom-set-faces
    ; height = pt * 10
    '(fixed-pitch ((t (:family "Menlo" :height 130))))
    '(variable-pitch ((t (:family "ETBembo" :height 140))))
    '(org-block ((t (:inherit fixed-pitch))))
    '(org-table ((t (:foreground "#0087af" :inherit fixed-pitch))))
    '(org-indent ((t (:inherit (org-hide fixed-pitch))))))
 
   (set-face-font 'fixed-pitch "Menlo-13")
   (set-face-font 'variable-pitch "ETBembo-14")
 #+end_src
 
 I like nicer list bullets:
 
 #+begin_src emacs-lisp
   (font-lock-add-keywords
    'org-mode
    `((,(rx bol (* blank) (group ?-) " ")  ; list regexp
       1                                   ; first match
       '(face nil display "•"))))          ; replace with bullet point, keep same face
 #+end_src
 ** Cursor
 The default box cursor isn't really accurate, because the cursor is actually between letters, not on a letter.
 So, I want a bar instead of a box:
 
 #+begin_src emacs-lisp
   (setq-default cursor-type '(bar . 4)
                 cursor-in-non-selected-windows 'hollow)
 #+end_src
 
 (I use ~setq-default~ here because cursor-type is automatically buffer-local when it's set)
 
 And enable cursorline:
 
 #+begin_src emacs-lisp
   (global-hl-line-mode)
 #+end_src
 
 And visualize tab characters by stretching the cursor:
 
 #+begin_src emacs-lisp
   (setq-default x-stretch-cursor t)
 #+end_src
 ** Matching parentheses
 Don't add a delay to show matching parenthesis.
 Must come before show-paren-mode enable.
 
 #+begin_src emacs-lisp
   (setq show-paren-delay 0)
 #+end_src
 
 Show matching parentheses:
 
 #+begin_src emacs-lisp
   (show-paren-mode t)
 #+end_src
 ** Line numbers
 Relative line numbers:
 
 #+begin_src emacs-lisp
   (setq display-line-numbers-type 'relative)
   (global-display-line-numbers-mode)
 #+end_src
 
 Function to hide them:
 
 #+begin_src emacs-lisp
   (defun za/hide-line-numbers ()
     "Hide line numbers"
     (display-line-numbers-mode 0))
 #+end_src
 Don't display them in specific modes.  For each of the modes in
 'mode-hooks', add a function to hide line numbers when the mode
 activates (which triggers the 'mode'-hook).
 
 #+begin_src emacs-lisp
   (let ((mode-hooks '(doc-view-mode-hook vterm-mode-hook mpc-status-mode-hook mpc-tagbrowser-mode-hook)))
     (mapc
      (lambda (mode-name)
        (add-hook mode-name #'za/hide-line-numbers))
      mode-hooks))
 #+end_src
 ** Modeline
 I want to show the time and date in the modeline:
 
 #+begin_src emacs-lisp
   (setq display-time-day-and-date t           ; also the date
         display-time-default-load-average nil ; don't show load average
         display-time-format "%I:%M%p %e %b (%a)")   ; "HR:MIN(AM/PM) day-of-month Month (Day)"
   (display-time-mode 1)                  ; enable time mode
 #+end_src
 
 And to set the modeline format:
 
 #+begin_src emacs-lisp
   (setq-default mode-line-format '("%e" mode-line-front-space mode-line-mule-info mode-line-client mode-line-modified mode-line-remote mode-line-frame-identification mode-line-buffer-identification "   " mode-line-position
                                    (vc-mode vc-mode)
                                    "  " mode-line-modes mode-line-misc-info mode-line-end-spaces))
 #+end_src
 
 I want to hide certain modes from the modeline.
 For that, ~delight~ is a useful package; unlike ~diminish~, it can also change the display of /major/ modes (~diminish~ only does minor modes).
 
 #+begin_src emacs-lisp
     (use-package delight
       :config
       (delight 'visual-line-mode " ↩" 'simple)
       (delight 'auto-revert-mode " AR" 'autorevert)
       (delight 'abbrev-mode " Abv" 'abbrev))
 #+end_src
 ** Transparent title bar
 #+begin_src emacs-lisp
   (add-to-list 'default-frame-alist '(ns-transparent-titlebar . t))
 #+end_src
 ** Frame title
 #+begin_src emacs-lisp
   (setopt frame-title-format "%F--%b-[%f]--%Z")
 #+end_src
 
 ** Tab bar
 Only show tab bar if there's more than 1 tab:
 
 #+begin_src emacs-lisp
   (setq tab-bar-show 1)
 #+end_src
 ** Buffer displaying
 
 So, this is a bit hard to grok. But basically the alist contains a
 regular expression to match a buffer name, then a list of functions to
 use in order for displaying the list, and then options for those functions (each of which is an alist).
 
 #+begin_src emacs-lisp
   (setq
    ;; Maximum number of side-windows to create on (left top right bottom)
    window-sides-slots '(0   ;; left
                         1   ;; top
                         3   ;; right
                         1 ) ;; bottom
 
    display-buffer-alist `(
                           ;; Right side
                           (,(rx (or "*Help*" (seq "*helpful " (* anything) "*")))
                            (display-buffer-reuse-window display-buffer-in-side-window)
                            (side . right)
                            (slot . -1)
                            (inhibit-same-window . t))
                           (,(rx "*Async Shell " (* anything) "*")
                            (display-buffer-reuse-window display-buffer-in-side-window)
                            (side . right)
                            (slot . 0)
                            (inhibit-same-window . t))
                           (,(rx "magit-process: " (* anything))
                            (display-buffer-reuse-window display-buffer-in-side-window)
                            (side . right)
                            (slot . 0)
                            (inhibit-same-window . t))
 
                           ;; Top side
                           (,(rx "*Info*")
                            (display-buffer-reuse-window display-buffer-in-side-window)
                            (side . top)
                            (slot . 0))
                           (,(rx "*Man " (* anything) "*")
                            (display-buffer-reuse-window display-buffer-in-side-window)
                            (side . top)
                            (slot . 0))
 
                           ;; Bottom
                           (,(rx "*Flycheck errors*")
                            (display-buffer-reuse-window display-buffer-in-side-window)
                            (side . bottom)
                            (slot . 0))))
 #+end_src
 
 And a way to toggle those side windows:
 
 #+begin_src emacs-lisp
   (bind-key "C-c W" #'window-toggle-side-windows)
 #+end_src
 
 ** Eldoc
 When editing Elisp and other supported major-modes, Eldoc will display useful information about the construct at point in the echo area.
 
 #+begin_src emacs-lisp
   (use-package eldoc
     :ensure nil ; installed with Emacs
     :delight
     :config
     (global-eldoc-mode 1))
 #+end_src
 
 ** Pulse line
 When you switch windows, Emacs can flash the cursor briefly to guide your eyes; I like that.
 Set some options for pulsing:
 
 #+begin_src emacs-lisp
   (setq pulse-iterations 10)
   (setq pulse-delay 0.05)
 #+end_src
 
 Define the pulse function:
 
 #+begin_src emacs-lisp
   (defun pulse-line (&rest _)
     "Pulse the current line."
     (pulse-momentary-highlight-one-line (point)))
 #+end_src
 
 Run it in certain cases: scrolling up/down, recentering, switching windows.
 'dolist' binds 'command' to each value in the list in turn, and runs the body.
 'advice-add' makes the pulse-line function run after 'command'.
 
 #+begin_src emacs-lisp
   (dolist (command '(scroll-up-command scroll-down-command recenter-top-bottom other-window))
     (advice-add command :after #'pulse-line))
 #+end_src
 
 And set the pulse color:
 
 #+begin_src emacs-lisp
   (custom-set-faces '(pulse-highlight-start-face ((t (:background "CadetBlue2")))))
 #+end_src
 
 ** Enable all commands
 By default, Emacs disables some commands.
 I want to have these enabled so I don't get a prompt whenever I try to use a disabled command.
 
 #+begin_src emacs-lisp
   (setq disabled-command-function nil)
 #+end_src
 ** More extensive apropos
 #+begin_src emacs-lisp
   (setq apropos-do-all t)
 #+end_src
 ** Enable recursive minibuffers
 #+begin_src emacs-lisp
   (setq enable-recursive-minibuffers t
         minibuffer-depth-indicate-mode t)
 #+end_src
 ** View webp and other formats
 Emacs handles common image formats internally, but for stuff like webp, you need an external converter:
 
 #+begin_src emacs-lisp
   (setq image-use-external-converter t)
 #+end_src
 
 You also need imagemagick installed.
 
 ** Repeat mode: easy repeating of commands
 #+begin_src emacs-lisp
   (repeat-mode 1)
 #+end_src
 
 ** Messages
 Hide some messages I don't need.
 
 #+begin_src emacs-lisp
   (recentf-mode)
   (setq inhibit-startup-message t)
 #+end_src
 
 ** Start buffer (dashboard)
 #+begin_src emacs-lisp
   (use-package dashboard
     :custom
     (dashboard-startup-banner 'logo)
     (dashboard-items '((gtd-inbox-counts . 3)
                        (syncthing-status . 3)
                        (recents . 5)
                        (bookmarks . 5)))
 
 
     :bind (:map dashboard-mode-map
                 ("ss" . za/st)
                 ("sk" . za/st-kill)
                 ("J" . org-clock-goto))
     :config
     (add-to-list 'dashboard-item-generators '(gtd-inbox-counts . dashboard-insert-gtd-inbox-counts))
     (add-to-list 'dashboard-item-generators '(syncthing-status . dashboard-insert-syncthing-status))
 
     (defun za/quotes-from-my-site ()
       (let* ((quotes-file (concat za/my-website-dir "content/quotes.md"))
              ;; Reformat quotes for display in dashboard
              (file-contents (with-temp-buffer
                               (insert-file-contents quotes-file)
                               (re-search-forward (rx bol "> "))
                               (delete-region (point-min) (pos-bol))
                               (goto-char (point-min))
                               (save-excursion (replace-regexp (rx bol ">" (* " ") (? "\n")) ""))
                               (save-excursion (replace-regexp (rx eol "\n") "  "))
                               (buffer-substring-no-properties (point-min) (point-max)))))
         ;; Split file into individual quotes
         (split-string file-contents "  ---  ")))
 
     (defun za/quotes-manual ()
       '("The Universe is under no obligation to make sense to you."
         "I would like to die on Mars. Just not on impact."
         "That's one small step for a man, one giant leap for mankind."
         "We choose to go to the moon in this decade and do the other things, not because they are easy, but because they are hard, because that goal will serve to organize and measure the best of our energies and skills, because that challenge is one that we are willing to accept, one we are unwilling to postpone, and one which we intend to win."
         "Space is for everybody. It’s not just for a few people in science or math, or for a select group of astronauts. That’s our new frontier out there, and it’s everybody’s business to know about space."
         "On one side are those who believe space travel is difficult work, but who go for it anyway. On the other are those who believe caring for a goldfish is, and who don’t go after much of anything. Where we choose to seed ourselves on the spectrum of what’s possible is what will ultimately define the size of our lives."))
 
     ;; Have to redefine this, original one has wrong type
     (defcustom dashboard-footer-messages
     '("The one true editor, Emacs!"
       "Who the hell uses VIM anyway? Go Evil!"
       "Free as free speech, free as free Beer"
       "Happy coding!"
       "Vi Vi Vi, the editor of the beast"
       "Welcome to the church of Emacs"
       "While any text editor can save your files, only Emacs can save your soul"
       "I showed you my source code, pls respond")
     "A list of messages, one of which dashboard chooses to display."
     :type '(repeat string)
     :group 'dashboard)
 
     ;; Use my saved quotes in the dashboard (https://alex.balgavy.eu/quotes/)
     (setopt dashboard-footer-messages
           (let* ((quotes (if (boundp 'za/my-website-dir) (za/quotes-from-my-site) (za/quotes-manual))))
             ;; Run each quote through fill-region for better display
             (require 's)
             (mapcar (lambda (quote-line)
                       (with-temp-buffer
                         (insert (s-trim quote-line))
                         (fill-region (point-min) (point-max))
                         (buffer-substring-no-properties (point-min) (point-max))))
                     quotes))))
 
   (defun dashboard-insert-gtd-inbox-counts (list-size)
     (require 'org-roam)
     (let* ((lines-inbox (za/org-count-headlines-in-file 1 za/org-life-inbox))
            (lines-mobile (if (boundp 'za/org-life-inbox-mobile) (za/org-count-headlines-in-file 1 za/org-life-inbox-mobile) 0))
            (count-docs (length (directory-files za/org-life-doc-inbox nil (rx bos (not ?.)))))
            (item-list))
 
       (when (> lines-inbox 0)
         (push (list :name "Inbox" :count lines-inbox :file za/org-life-inbox) item-list))
       (when (> lines-mobile 0)
         (push (list :name "Mobile" :count lines-mobile :file za/org-life-inbox-mobile) item-list))
       (when (> count-docs 0)
         (push (list :name "Docs" :count count-docs :file za/org-life-doc-inbox) item-list))
 
       (dashboard-insert-section
        ;; Widget title
        "GTD:"
        ;; list generated for dashboard
        item-list
        list-size
        'gtd
        "t"
        ;; decide what to do when clicked ("el" is automatically assigned)
        `(lambda (&rest _)
           (message "%s" (find-file (plist-get ',el :file))))
        ;; show how list is shown in dashboard ("el" is automatically assigned)
        (format "%s: %s" (plist-get el :name) (plist-get el :count)))))
 
   (defun dashboard-insert-syncthing-status (list-size)
     (when (and (get-buffer-process za/st-buffer-name)
                (boundp 'za/syncthing-api-key))
       (let* ((syncstatus (json-parse-string
                           (shell-command-to-string
                            (format "curl -sH 'Authorization: Bearer %s' 'http://localhost:8384/rest/db/completion'" za/syncthing-api-key))))
              (completion (gethash "completion" syncstatus))
              (folders (json-parse-string
                        (shell-command-to-string
                         (format "curl -sH 'Authorization: Bearer %s' 'http://localhost:8384/rest/stats/folder'" za/syncthing-api-key))
                        :false-object nil
                        :null-object nil))
              (org-lastsync (format-time-string "%H:%M:%S (%F)" (date-to-time (gethash "lastScan" (gethash "lifeorg" folders)))))
              (devices (json-parse-string
                        (shell-command-to-string
                         (format "curl -sH 'Authorization: Bearer %s' 'http://localhost:8384/rest/system/connections'" za/syncthing-api-key))
                        :object-type 'alist
                        :false-object nil
                        :null-object nil))
              (connected-devices (length (seq-filter
                                          (lambda (a)
                                            (alist-get 'connected (cdr a))) (alist-get 'connections devices))))
              (item-list `(,(format "Completion: %s%%" completion)
                           ,(format "Connected devices: %s" connected-devices)
                           ,(format "Org last sync: %s" org-lastsync))))
 
         (dashboard-insert-section
          ;; Widget title
          "Syncthing:"
          ;; list generated for dashboard
          item-list
          list-size
          'syncthing-status
          ;; shortcut key for section
          nil
          ;; when clicked
          (lambda (&rest _) ())
          ;; show how list is shown in dashboard ("el" is automatically assigned)
          (format "%s" el)))))
 
   (dashboard-setup-startup-hook)
   (setq initial-buffer-choice (lambda () (get-buffer-create "*dashboard*")))
 #+end_src
 
 ** Scrolling
 #+begin_src emacs-lisp
   (setopt scroll-step 1)
   ;; Marker distance from center
   (setopt scroll-conservatively 100000)
   ;; Keep screen position on scroll
   (setopt scroll-preserve-screen-position 1)
   ;; Start scrolling when marker at top/bottom
   (setopt scroll-margin 0)
 
   ;; Mouse scrolls 1 line at a time
   (setopt mouse-wheel-scroll-amount '(1))
 
   ;; On a long mouse scroll keep scrolling by 1 line
   (setq mouse-wheel-progressive-speed nil)
 
   ;; Enable pixel scroll precision mode
   (unless (version< emacs-version "29")
     (pixel-scroll-precision-mode))
 
   ;; Speed up cursor movement.
   ;; https://emacs.stackexchange.com/questions/28736/emacs-pointcursor-movement-lag/28746
   (setopt auto-window-vscroll nil)
 #+end_src
 * General packages
 
 ** which-key
 Minor mode for Emacs that displays the key bindings following your currently entered incomplete command (a prefix) in a popup.
 
 #+BEGIN_SRC emacs-lisp
   (use-package which-key
     :delight
     :config
     (which-key-mode))
 #+end_src
 
 ** counsel + ivy + swiper + prescient
 Better incremental completion and selection narrowing.
 And a bunch more.
 Generally makes for nicer interactivity, like ido mode on steroids.
 Switched to this from Helm, it's more lightweight.
 
 *** ivy: generic completion mechanism
 #+begin_src emacs-lisp
   (use-package ivy
     :delight
     :custom
     (ivy-use-virtual-buffers t "extend searching to bookmarks")
     (ivy-height 20 "set height of the ivy window")
     (ivy-count-format "(%d/%d) " "count format, from the ivy help page")
     (ivy-display-style 'fancy)
     (ivy-format-function 'ivy-format-function-line)
     (ivy-use-selectable-prompt t "to let me select exactly what I'm typing as a candidate")
 
     :bind (("C-x b" . ivy-switch-buffer)
            ("C-c v" . ivy-push-view)
            ("C-c V" . ivy-pop-view)
 
            ;; accidentally pressing shift-space deletes input, because
            ;; by default, shift-space is bound to
            ;; ~ivy-restrict-to-matches~ in the ivy minibuffer.
            :map ivy-minibuffer-map
            ("S-SPC" . (lambda () (interactive) (insert ?\s)))
            ("<backtab>" . ivy-restrict-to-matches))
     :config
     (ivy-add-actions
      'counsel-dired
      '(("f" (lambda (dir) (counsel-fzf nil dir)) "Fzf in directory")
        ("g" (lambda (dir) (counsel-ag nil dir)) "Ag in directory")))
     (ivy-add-actions
      'dired
      '(("f" (lambda (dir) (ivy-exit-with-action (counsel-fzf nil dir))) "Fzf in directory")
        ("g" (lambda (dir) (ivy-exit-with-action (counsel-ag nil dir))) "Ag in directory")))
     (ivy-add-actions
      'counsel-describe-function
      '(("d" (lambda (fun) (ivy-exit-with-action (edebug-instrument-function (intern fun)))) "Edebug instrument function")))
     (ivy-mode)
 
     (defun edit-script ()
       "Edit a file in ~/.scripts/"
       (interactive)
       (let ((input (ivy--input)))
         (ivy-quit-and-run (counsel-file-jump nil "~/.scripts/"))))
 
     (defun edit-config ()
       "Edit a file in ~/.dotfiles/"
       (interactive)
       (let ((input (ivy--input)))
         (ivy-quit-and-run (counsel-file-jump nil "~/.dotfiles/")))))
 #+end_src
 
 *** counsel: collection of common Emacs commands enhanced using ivy
 #+begin_src emacs-lisp
   (use-package counsel
     :demand
     :delight
     :config
     (counsel-mode)
     :bind (("M-x" . counsel-M-x)
            ("C-x C-f" . counsel-find-file)
            ("M-y" . counsel-yank-pop)
            ("C-c c" . counsel-compile)
            ("M-s g" . counsel-rg)
            ("M-s f" . counsel-fzf)
            ("C-c b" . counsel-bookmark)
            ("C-c p" . counsel-recentf)
            ("C-c o" . counsel-outline)
            ("C-h f" . counsel-describe-function)
            ("C-h v" . counsel-describe-variable)
            ("C-h o" . counsel-describe-symbol)
            ("C-c g j" . counsel-org-agenda-headlines)))
 #+end_src
 *** swiper: search enhanced using ivy
 #+begin_src emacs-lisp
   (use-package swiper
     :bind (("C-s" . swiper-isearch)
            ("C-r" . swiper-isearch-backward)))
 #+end_src
 *** prescient: scoring system for M-x
 #+begin_src emacs-lisp
   (use-package prescient
     :config (prescient-persist-mode))
 
   (use-package ivy-prescient
     :after counsel
     :custom (ivy-prescient-retain-classic-highlighting t)
     :config (ivy-prescient-mode))
 #+end_src
 
 *** ivy-posframe: ivy in a popup
 I like having ivy in a popup.
 Problem: posframe does not work if emacs is too old and on macos.
 See here: https://github.com/tumashu/posframe/issues/30
 On Mac, ~brew install --HEAD emacs~ doesn't work either.
 Solution: ~brew tap daviderestivo/emacs-head && brew install emacs-head@28 --with-cocoa~
 
 #+begin_src emacs-lisp
   (if (and (version< emacs-version "28") (equal system-type 'darwin))
       (message "ivy-posframe won't work properly, run `brew install daviderestivo/emacs-head/emacs-head@28 --with-cocoa`")
     (use-package ivy-posframe
       :delight
       :custom
       (ivy-posframe-display-functions-alist '((t . ivy-posframe-display-at-frame-center)))
       (ivy-posframe-parameters
        '((left-fringe . 8)
          (right-fringe . 8)))
       (ivy-posframe-border-width 3)
       (ivy-truncate-lines nil) ;; otherwise the cursor gets hidden by long lines in posframe
       :custom-face
       (ivy-posframe-border ((t (:inherit mode-line-inactive))))
       :config
       (ivy-posframe-mode 1)))
 #+end_src
 
 [[https://github.com/tumashu/ivy-posframe/issues/123][See here]] for cursor going offscreen in the posframe. Currently 'solved' with ~ivy-truncate-lines~ nil.
 
 ** DISABLED vertico + consult + marginalia + embark + posframe + prescient
 Alternative to counsel/ivy/swiper, will probably switch to this at some point.
 [[https://old.reddit.com/r/emacs/comments/qfrxgb/using_emacs_episode_80_vertico_marginalia_consult/hi6mfh7/][Here]] is a good comparison.
 
 A [[https://old.reddit.com/r/emacs/comments/11lqkbo/weekly_tips_tricks_c_thread/jbe06qv/][comment here to follow]] when I switch to vertico.
 #+begin_src emacs-lisp :tangle no
   (dolist (pack '(vertico consult marginalia embark vertico-posframe vertico-prescient))
     (unless (package-installed-p pack)
       (package-install pack))
     (require pack))
 
   (vertico-mode 1)
   (vertico-posframe-mode 1)
   (marginalia-mode 1)
   (vertico-prescient-mode 1)
   (setq completion-styles '(basic substring partial-completion flex))
 
   (global-set-key (kbd "M-o") #'embark-act)
   (global-set-key (kbd "C-s") #'consult-line)
 
 #+end_src
 ** company: completion mechanism
 #+begin_src emacs-lisp
   (use-package company)
 #+end_src
 
 ** wgrep: writable grep
 #+begin_src emacs-lisp
   (use-package wgrep)
 #+end_src
 ** avy: jump to any position
 This lets me jump to any position in Emacs rather quickly, sometimes it's useful.
 ~avy-goto-char-timer~ lets me type a part of the text before avy kicks in.
 
 #+begin_src emacs-lisp
   (use-package avy
     :custom
     (avy-single-candidate-jump nil "Often I want to perform an action, never jump automatically")
     :bind
     (("C-:" . avy-goto-char-timer)))
 #+end_src
 
 ** calendar
 #+begin_src emacs-lisp
   (use-package calendar
     :ensure nil ; comes with Emacs
     :custom
     (calendar-week-start-day 1))
 #+end_src
 ** calfw: graphical calendar
 Basically provides a way to show the org agenda as a standard GUI calendar app would.
 
 #+begin_src emacs-lisp
   (use-package calfw
     :config
     (use-package calfw-org)
     :custom
     (cfw:org-overwrite-default-keybinding t))
 #+end_src
 
 ** vanish: hide parts of the file
 #+begin_src emacs-lisp
   (use-package vanish
     :init
     (za/package-vc-install :repo "thezeroalpha/vanish.el" :rev "develop")
     (require 'vanish)
     :ensure nil
     :bind (:map vanish-mode-map
                 ("C-c q h h" . vanish-hide-dwim)
                 ("C-c q h u r" . vanish-show-all-regions)
                 ("C-c q h u e" . vanish-elt-unhide)
                 ("C-c q h u u" . vanish-show-all)))
 #+end_src
 ** magit
 #+begin_src emacs-lisp
   (use-package magit)
 #+end_src
 ** vterm
 Emacs has a bunch of built-in terminal emulators.
 And they all suck.
 (OK not really, eshell is alright, but not for interactive terminal programs like newsboat/neomutt)
 
 Also use emacsclient inside vterm as an editor, because that'll open documents in the existing Emacs session.
 And I'm not gonna be a heretic and open Vim inside of Emacs.
 
 #+begin_src emacs-lisp
   (use-package vterm
     :hook
     (vterm-mode . (lambda () (unless server-process (server-start))))
     :bind (("C-c t" . switch-to-vterm))
     :config
     (defun switch-to-vterm ()
       "Switch to a running vterm, or start one and switch to it."
       (interactive)
       (if (get-buffer vterm-buffer-name)
           (switch-to-buffer vterm-buffer-name)
         (vterm))))
 #+end_src
 ** sr-speedbar
 Make speed bar show in the current frame.
 
 #+begin_src emacs-lisp
   (use-package sr-speedbar
     :bind (("C-c F" . za/jump-to-speedbar-or-open)
            :map speedbar-mode-map
            ("q" . sr-speedbar-close))
     :custom
     (sr-speedbar-right-side nil)
 
     :config
     (defun za/jump-to-speedbar-or-open ()
       "Open a speedbar or jump to it if already open."
       (interactive)
       (if (or (not (boundp 'sr-speedbar-exist-p))
               (not (sr-speedbar-exist-p)))
           (sr-speedbar-open))
       (sr-speedbar-select-window)))
 #+end_src
 ** expand-region
 Expand the selected region semantically.
 
 #+begin_src emacs-lisp
   (use-package expand-region
     :bind ("C-=" . er/expand-region))
 #+end_src
 ** flycheck
 Install flycheck:
 
 #+begin_src emacs-lisp
   (use-package flycheck)
 #+end_src
 ** rainbow-mode: visualise hex colors
 'rainbow-mode' lets you visualise hex colors:
 
 #+begin_src emacs-lisp
   (use-package rainbow-mode)
 #+end_src
 ** hl-todo: highlight TODO keywords
 I want to highlight TODO keywords in comments:
 
 #+begin_src emacs-lisp
   (use-package hl-todo
     :custom-face
     (hl-todo ((t (:inherit hl-todo :underline t))))
     :custom
     (hl-todo-keyword-faces '(("TODO"   . "#ff7060")
                              ("FIXME"  . "#caa000")))
     :config
     (global-hl-todo-mode t))
 #+end_src
 ** undo-tree
 Sometimes it's better to look at undo history as a tree:
 
 #+begin_src emacs-lisp
   (use-package undo-tree
     :delight
     :custom
     (undo-tree-history-directory-alist
      (progn (let ((undo-tree-dir (concat user-emacs-directory "undo-tree/")))
               (unless (file-directory-p undo-tree-dir) (make-directory undo-tree-dir))
               `(("." . ,undo-tree-dir)))))
 
     :config
     (global-undo-tree-mode))
 #+end_src
 
 *** TODO undo tree dir should be configurable
 ** eglot
 A good LSP plugin.
 
 #+begin_src emacs-lisp
   (use-package eglot)
 #+end_src
 ** crdt
 Collaborative editing in Emacs:
 
 #+begin_src emacs-lisp
   (use-package crdt)
 #+end_src
 ** git gutter
 General git gutter:
 
 #+begin_src emacs-lisp
   (use-package git-gutter
     :bind (("C-c d n" . git-gutter:next-hunk)
            ("C-c d p" . git-gutter:previous-hunk))
     :config
     (global-git-gutter-mode 1))
 #+end_src
 ** keycast
 In case I want to show what keys I'm pressing.
 
 #+begin_src emacs-lisp
   (use-package keycast)
 #+end_src
 ** ace-window: better window switching
 Window switching with ~other-window~ sucks when I have more than 2 windows open. Too much cognitive load.
 This lets me select a window to jump to using a single key, sort of like ~avy~.
 
 #+begin_src emacs-lisp
   (use-package ace-window
     :custom
     (aw-keys '(?a ?s ?d ?f ?g ?h ?j ?k ?l) "I prefer using home-row keys instead of numbers")
 
     :custom-face
     ;; I want something a little more contrasty
     (aw-leading-char-face ((t (:inherit font-lock-keyword-face :height 2.0))))
 
     :bind ("M-o" . ace-window))
 #+end_src
 ** decide-mode for dice rolling
 #+begin_src emacs-lisp
   (use-package decide
     :init (za/package-vc-install :repo "lifelike/decide-mode" :name "decide")
     :ensure nil
     :bind ("C-c q ?" . decide-mode))
 #+end_src
 
 ** try: try out different packages
 #+begin_src emacs-lisp
   (use-package try)
 #+end_src
 ** dumb-jump
 "jump to definition" package, minimal configuration with no stored indexes.
 Uses The Silver Searcher ag, ripgrep rg, or grep to find potential definitions of a function or variable under point.
 
 #+begin_src emacs-lisp
   (use-package dumb-jump)
 #+end_src
 
 Enable xref backend:
 
 #+begin_src emacs-lisp
   (add-hook 'xref-backend-functions #'dumb-jump-xref-activate)
   (setq xref-show-definitions-function #'xref-show-definitions-completing-read)
 #+end_src
 ** DISABLED command-log-mode
 Simple real-time logger of commands.
 
 #+begin_src emacs-lisp :tangle no
   (use-package command-log-mode)
 #+end_src
 ** package-lint
 Linter for the metadata in Emacs Lisp files which are intended to be packages.
 
 #+begin_src emacs-lisp
   (use-package package-lint)
   (use-package flycheck-package)
   (eval-after-load 'flycheck
     '(flycheck-package-setup))
 #+end_src
 ** prism: change color of text depending on depth
 Prism changes the color of text depending on their depth. Makes it easier to see where something is at a glance.
 
 #+begin_src emacs-lisp
   (use-package prism)
 #+end_src
 ** olivetti: distraction-free writing
 #+begin_src emacs-lisp
   (use-package olivetti
     :diminish)
 #+end_src
 ** nov.el: EPUB support
 #+begin_src emacs-lisp
   (use-package nov)
   (add-to-list 'auto-mode-alist '("\\.epub\\'" . nov-mode))
 #+end_src
 ** god-mode: reduce the need to hold down modifier keys
 - All commands are assumed to use the control modifier (C-) unless otherwise indicated.
 - g is used to indicate the meta modifier
 - G is used to indicate both the control and meta modifiers
 #+begin_src emacs-lisp
   (use-package god-mode
     :bind
     (("s-<escape>" . god-mode-all)
      :map god-local-mode-map
      ("z" . repeat)
      ("i" . god-local-mode))
     :hook    (post-command . za/god-mode-update-mode-line)
     :config
     (defun za/god-mode-update-mode-line ()
       "Update the color of the modeline depending on god-mode."
       (cond (god-local-mode
              (set-face-attribute 'mode-line nil :background "#770085"))
             (t
              (let* ((current-theme (car custom-enabled-themes))
                      (theme-settings (get current-theme 'theme-settings)))
                 (dolist (theme-setting theme-settings)
                   (if (and (eq (car theme-setting) 'theme-face)
                            (eq (cadr theme-setting) 'mode-line))
                       (let* ((face-def (caar (last theme-setting)))
                              (properties (car (last face-def)))
                              (bg (plist-get properties :background)))
                         (set-face-attribute 'mode-line nil :background bg)))))))))
 #+end_src
 ** devil: alternative to god-mode that uses a comma
 #+begin_src emacs-lisp
   (use-package devil
     :init
     (za/package-vc-install :repo "susam/devil")
     (require 'devil)
     :custom
     (devil-lighter " \u272A")
     (devil-prompt "\u272A %t")
     :config (global-devil-mode)
     :bind ("C-," . global-devil-mode))
 #+end_src
 ** academic-phrases
 Gives ideas for phrases to use in academic writing.
 #+begin_src emacs-lisp
   (use-package academic-phrases)
 #+end_src
 ** ediff
 #+begin_src emacs-lisp
   (use-package ediff
     :custom
     ((ediff-keep-variants nil "Prompt to remove unmodifid buffers after session")
      (ediff-make-buffers-readonly-at-startup nil "Don't make all buffers read-only at startup")
      (ediff-show-clashes-only t "Only show diff regions where both buffers disagree with ancestor")
      (ediff-split-window-function 'split-window-horizontally "I want long vertical side-by-side windows")
      (ediff-window-setup-function 'ediff-setup-windows-plain "Everything in one frame please")))
 #+end_src
 ** highlight-indent-guides
 #+begin_src emacs-lisp
   (use-package highlight-indent-guides
     :hook (yaml-mode . highlight-indent-guides-mode)
     :custom
     ((highlight-indent-guides-method 'character))
     :custom-face
     (highlight-indent-guides-character-face ((t (:foreground "#adadad")))))
 #+end_src
 ** cc-avy
 #+begin_src emacs-lisp
   (use-package cc-avy
     :ensure nil ; local
     :bind ("C-M-:" . cc/avy-menu))
 #+end_src
 ** annotate
 #+begin_src emacs-lisp
   (use-package annotate
     :custom (annotate-annotation-position-policy :margin)
     :config
     (defun za/annotate-initialize-extra-hooks ()
       (add-hook 'after-save-hook #'annotate-save-annotations t t))
     (defun za/annotate-shutdown-extra-hooks ()
       (remove-hook 'after-save-hook #'annotate-save-annotations t))
     (advice-add 'annotate-initialize :after #'za/annotate-initialize-extra-hooks)
     (advice-add 'annotate-shutdown :after #'za/annotate-shutdown-extra-hooks))
 
 #+end_src
 ** yasnippet
 #+begin_src emacs-lisp
   (use-package yasnippet
     :config (yas-global-mode)
     :delight)
 #+end_src
 * Mode/language specific packages
 ** Org
 *** Custom functions
 **** Get number of headlines in a file
 #+begin_src emacs-lisp
   (defun za/org-count-headlines-in-file (level filename)
     "Count number of level LEVEL headlines in FILENAME. If LEVEL is 0, count all."
     (let ((headline-str (cond ((zerop level) "^\*+")
                               (t (format "^%s " (apply 'concat (make-list level "\\*")))))))
       (save-mark-and-excursion
         (with-temp-buffer
           (insert-file-contents filename)
           (count-matches headline-str (point-min) (point-max))))))
 #+end_src
 
 **** Yank URL
 #+begin_src emacs-lisp
   (defun org-yank-link-url ()
     (interactive)
     (kill-new (org-element-property :raw-link (org-element-context)))
     (message "Link copied to clipboard"))
 #+end_src
 *** Installation
 Install Org and require additional components that I use.
 
 #+begin_src emacs-lisp
   (use-package org
     :custom
     (org-outline-path-complete-in-steps nil "Complete path all at once (needed for completion frameworks")
     (org-format-latex-options (plist-put org-format-latex-options :scale 2.0) "Larger latex previews")
     (org-goto-interface 'outline-path-completion "Use outline path completion for org-goto, instead of its weird interface")
     (org-insert-heading-respect-content t "Insert headings after current subtree")
     (org-clock-report-include-clocking-task t "Include currently active task in clocktable")
     (org-id-link-to-org-use-id 'create-if-interactive "If org-store-link is called directly, create an ID.")
     (org-clock-mode-line-total 'today)
     (org-return-follows-link t "Easier link following. Actual enter is still possible with ~C-q C-j~.")
     (org-hide-emphasis-markers t "Don't show italics/bold markers")
     (org-babel-python-command "python3")
     (org-confirm-babel-evaluate nil)
     (org-file-apps '((auto-mode . emacs)
                      (directory . emacs)
                      ("\\.mm\\'" . default)
                      ("\\.x?html?\\'" . default)
                      ("\\.pdf\\'" . emacs)))
     (org-link-elisp-confirm-function #'y-or-n-p)
     (org-link-elisp-skip-confirm-regexp "^org-noter$")
     (org-clock-sound (concat user-emacs-directory "notification.wav"))
     (org-export-backends '(ascii html icalendar latex md odt org pandoc jira))
     (org-catch-invisible-edits 'show-and-error
                                "Sometimes when text is folded away, I might accidentally edit text inside of it. This option prevents that. I wanted to do 'smart', but that has a 'fixme' so it might change in the future...Instead, show what's being edited, but don't perform the edit.")
     (org-src-tab-acts-natively t "a tab in a code block indents the code as it should")
     (org-attach-store-link-p 'attached)
     (org-attach-archive-delete 'query)
     (org-archive-subtree-add-inherited-tags t)
     (org-stuck-projects '("/PROJ"
                           ("NEXT" "STARTED")
                           nil nil)
                         "List projects that are stuck (don't have a next action)")
     (org-tag-alist (let ((za/org-tag-energy-levels
                           '((:startgroup)
                             ("sport" . ?h) ; Sport (deep focus, long tasks, no interruptions, at least an hour)
                             ("cruise" . ?l) ; Cruise (shallow focus, can be interrupted, can batch lots of quick tasks together)
                             ("parked" . ?e) ; Parked (take a break, look into the distance, walk the dog, stretch, etc.)
                             ("errand" . ?o) ; Errand (anything that involves me being out of the house)
                             (:endgroup)))
                          (za/org-tag-1-3-5
                           '(; 1-3-5 tagging
                             (:startgroup)
                             ("_1" . ?1) ; 1 big task, 3-4 hrs
                             ("_3" . ?3) ; 3 medium tasks, 1-2 hrs
                             ("_5" . ?5) ; 5 small tasks, 30min-1hr
                             (:endgroup))))
                      `(,@za/org-tag-contexts ,@za/org-tag-energy-levels ,@za/org-tag-1-3-5)))
 
     :bind (("C-c a" . org-agenda)
            ("C-c n" . org-capture)
            ("C-c l" . org-store-link)
            :map org-mode-map
            ("C-M-<return>" . org-insert-todo-heading)
            ("C-c M-y" . org-yank-link-url)
            ("C-c N" . org-noter)
            ("C-M-i" . completion-at-point)
            ("C-c SPC" . org-table-blank-field)
            ("C-c C-w" . za/org-refile-wrapper))
     :hook ((org-mode . abbrev-mode)
            (org-mode . za/echo-area-tooltips)
            (org-mode . org-superstar-mode)
            (org-mode . org-indent-mode)
            (org-mode . za/settings-on-org-mode)
            (org-mode . org-pretty-table-mode)
            (org-mode . variable-pitch-mode))
     :config
     (za/package-vc-install :repo "Fuco1/org-pretty-table")
     (require 'org-pretty-table)
     (delight 'org-pretty-table nil)
 
 
     (za/package-vc-install :repo "https://git.sr.ht/~bzg/org-contrib" :load "lisp/")
     (require 'org-contrib)
     (require 'org-checklist)
     (delight 'org-indent-mode nil 'org-indent)
     (defun za/settings-on-org-mode ()
       "Settings on enabling org mode"
       (za/toggle-wrap t))
 
     (defcustom za/org-inline-images-desired-screen-proportion (/ (float 3) 4)
       "Percentage of the window (as a float) that Org inline images should take up."
       :type 'float)
 
     (defun za/org-display-inline-images-set-width (&rest _)
       "Set `org-image-actual-width` dynamically before displaying images."
       (if (window-system)
           (let* ((total-width (window-pixel-width))
                  (image-width (round (* total-width za/org-inline-images-desired-screen-proportion))))
             (setq-local org-image-actual-width image-width))))
 
     (advice-add 'org-display-inline-images :before #'za/org-display-inline-images-set-width)
 
     (defun za/org-attach-tag (old/org-attach-tag &rest args)
       "Wraps :around org-attach-tag (as OLD/ORG-ATTACH-TAG) with ARGS.
   When inside capture for org-roam, attaching fails at
   org-attach-tag. This function prevents that error interrupting
   org-attach."
       (if ; there's no heading
           (not (org-element-lineage (org-element-at-point)
                                     '(headline inlinetask)
                                     'include-self))
           nil ; there's no point attaching a tag
                                           ; otherwise, normal attach
         (apply old/org-attach-tag args)))
 
     (advice-add #'org-attach-tag :around #'za/org-attach-tag)
     (defun za/org-clear-1-3-5 ()
       "Clears the _1/_3/_5 daily tags from all antries."
       (interactive)
       (let ((number-of-entries
              (length (org-map-entries
                       (lambda ()
                         (let* ((tags-1-3-5 '("_1" "_3" "_5"))
                                (tags-without-1-3-5 (seq-remove (lambda (e) (member e tags-1-3-5))
                                                                org-scanner-tags)))
                           (org-set-tags tags-without-1-3-5)))
                       "_1|_3|_5"
                       'agenda-with-archives))))
         (message "Modified %d entries." number-of-entries)))
     (defun za/archive-finished-tickler ()
       (interactive)
       (progn
         (find-file-other-window za/org-life-tickler)
         (length (org-map-entries
                  (lambda ()
                    (org-fold-show-subtree)
                    (when (y-or-n-p "Archive? ")
                      (org-archive-subtree-default)
                      (save-buffer)))
                  "TIMESTAMP<*\"<today>\""
                  'file))))
 
     (require 'org-tempo)
     (require 'org-habit)
     (require 'org-id)
     (use-package ob-async)
     (use-package ob-rust)
     (org-babel-do-load-languages
      'org-babel-load-languages
      '((emacs-lisp . t)
        (R . t)
        (python . t)
        (ruby . t)
        (shell . t)
        (sqlite . t)
        (rust . t)))
     (use-package inf-ruby)
     (use-package org-superstar
       :custom
       (org-superstar-leading-bullet ?\s))
 
     ;; Linking to emails via notmuch
     (use-package ol-notmuch)
 
     ;; Improved search
     (use-package org-ql)
 
     ;; My override for org clock resolve
     (require 'org-clock-override)
 
     ;; Tempo expansions
     (add-to-list 'org-structure-template-alist '("se" . "src emacs-lisp"))
     (add-to-list 'org-structure-template-alist '("sb" . "src bibtex"))
     (add-to-list 'org-structure-template-alist '("ss" . "src sh"))
     (add-to-list 'org-structure-template-alist '("sy" . "src yaml")))
 #+end_src
 *** Agenda & GTD
 **** Agenda mode settings
 #+begin_src emacs-lisp
   (use-package org-agenda
     :ensure org
     :bind (:map org-agenda-mode-map
                 ("C-c TAB" . za/org-agenda-goto-narrowed-subtree)
                 ("@" . za/org-agenda-show-context-tags))
     :custom
     (org-agenda-files (list za/org-life-main
                             za/org-life-inbox
                             za/org-life-tickler))
     (org-agenda-text-search-extra-files
      (directory-files za/org-life-dir t (rx bol (not ?.) (* anything) ".org"))
      "I want to search all Org files in the life directory")
 
     :config
     (defun za/org-agenda-show-context-tags ()
       "Show the context tags (e.g. @computer) applicable to the current item."
       (interactive)
       (let* ((tags (org-get-at-bol 'tags))
              (context-tag-p (lambda (tag) (string-prefix-p "@" tag)))
              (context-tags (seq-filter context-tag-p tags)))
         (if context-tags
             (message "Contexts are :%s:"
                      (org-no-properties (mapconcat #'identity context-tags ":")))
           (message "No contexts associated with this line"))))
     (defun za/org-agenda-goto-narrowed-subtree ()
       "Jump to current agenda item and narrow to its subtree."
       (interactive)
       (delete-other-windows)
       (org-agenda-goto)
       (org-narrow-to-subtree)
       (outline-hide-subtree)
       (org-show-children 1)
       (other-window 1)))
 #+end_src
 
 Fix tag display by dynamically calculating the column.
 
 #+begin_src emacs-lisp
   (defun za/settings-org-agenda-mode ()
     "My settings for org agenda mode"
     )
   (add-hook 'org-agenda-mode-hook #'za/settings-org-agenda-mode)
 #+end_src
 
 **** Opening files
 Convenience functions to make opening the main file faster:
 
 #+begin_src emacs-lisp
   (defun gtd () "GTD: main file" (interactive) (find-file za/org-life-main))
   (defun gtd-inbox ()
     "GTD: inbox"
     (interactive)
     (let ((count-docs (length (directory-files za/org-life-doc-inbox nil (rx bos (not ?.))))))
       (find-file za/org-life-inbox)
       (when (> count-docs 0)
         (dired-other-window za/org-life-doc-inbox)
         (dired-revert)
         (other-window 1))))
   (defun gtd-inbox-mobile () "GTD: mobile inbox" (interactive) (find-file za/org-life-inbox-mobile))
   (defun gtd-archive () "GTD: archive" (interactive) (find-file za/org-life-archive))
   (defun gtd-someday () "GTD: someday" (interactive) (find-file za/org-life-someday))
   (defun gtd-tickler () "GTD: tickler" (interactive) (find-file za/org-life-tickler))
 #+end_src
 
 Bind keys to those functions:
 
 #+begin_src emacs-lisp
   (bind-keys :prefix "M-g t"
              :prefix-map za/gtd-files-map
              :prefix-docstring "Visit GTD file"
              ("i" . gtd-inbox)
              ("l" . gtd)
              ("a" . gtd-archive)
              ("s" . gtd-someday)
              ("t" . gtd-tickler))
 #+end_src
 
 To improve jumping to any headline via counsel, filter returned candidates to include source file.
 
 #+begin_src emacs-lisp
   (defun za/counsel-org-agenda-headlines--candidates-with-filename (candidates)
     "Convert CANDIDATES to include source filename for each candidate."
     (mapcar (lambda (candidate)
               (let ((name (nth 0 candidate))
                     (path (nth 1 candidate))
                     (pos (nth 2 candidate)))
                 (list (format "%s/%s" (file-name-nondirectory path) name)
                       path
                       pos)))
             candidates))
 
   (advice-add #'counsel-org-agenda-headlines--candidates :filter-return #'za/counsel-org-agenda-headlines--candidates-with-filename)
 #+end_src
 
 *** Processing inbox
 I made a function for processing the inbox, focusing on one item at a time:
 
 #+begin_src emacs-lisp
   (defun za/gtd-inbox-next-item ()
     (interactive)
     (unless (string= (buffer-file-name) (file-truename za/org-life-inbox))
       (user-error "You're not in your GTD inbox file."))
     (widen)
     (org-first-headline-recenter)
     (org-narrow-to-subtree))
 #+end_src
 
 And a conditional binding:
 
 #+begin_src emacs-lisp
   (bind-key "C-c g n" #'za/gtd-inbox-next-item 'org-mode-map (string= (buffer-file-name) (file-truename za/org-life-inbox)))
 #+end_src
 
 And a function for importing other inboxes:
 
 #+begin_src emacs-lisp
   (defun za/gtd-inbox-import ()
     (interactive)
     (unless (string= (buffer-file-name) (file-truename za/org-life-inbox))
       (user-error "You're not in your GTD inbox file"))
     (when (directory-files za/org-life-dir nil "\\.sync-conflict-")
         (user-error "Sync conflicts found, please fix them"))
     (let ((mobile (if (boundp 'za/org-life-inbox-mobile) (file-truename za/org-life-inbox-mobile) nil))
           (calendar (if (boundp 'za/org-life-calendar-inbox) (file-truename za/org-life-calendar-inbox) nil)))
       (save-mark-and-excursion
         (goto-char (point-max))
         (when mobile
           (insert-file mobile)
           (goto-char (point-max))
           (write-region "" nil mobile))
         (when calendar
           (insert-file calendar)
           (write-region "" nil calendar)
           (goto-char (point-max)))
         (message "Imported other inboxes."))))
 #+end_src
 
 Also with a conditional binding:
 
 #+begin_src emacs-lisp
   (bind-key "C-c g i" #'za/gtd-inbox-import 'org-mode-map (string= (buffer-file-name) (file-truename za/org-life-inbox)))
 #+end_src
 *** Refiling & archiving
 #+begin_src emacs-lisp
   (use-package org-refile
     :ensure org
     :custom
     (org-refile-targets `((,za/org-life-main :maxlevel . 3)
                           (,za/org-life-someday :level . 1)
                           (,za/org-life-tickler :maxlevel . 3))
                         "Where I want to be able to move subtrees (doesn't include inbox because I never refile to that, and the archive has its own keybining)")
     (org-archive-location (concat za/org-life-archive "::datetree/")
                           "I want to archive to a specific file, in a date tree")
     (org-refile-use-outline-path 'file
                                  "Include the destination file as an element in the path to a heading, and to use the full paths as completion targets rather than just the heading text itself")
     (org-outline-path-complete-in-steps nil
                                         "Tell Org that I don’t want to complete in steps; I want Org to generate all of the possible completions and present them at once (necessary for Helm/Ivy)")
     (org-refile-allow-creating-parent-nodes 'confirm
                                             "Allow me to tack new heading names onto the end of my outline path, and if I am asking to create new ones, make me confirm it"))
 #+end_src
 
 *** Quick capture
 Quick capture lets me send something to my inbox very quickly, without thinking about where it should go.
 The inbox is processed later.
 
 Templates for quick capture:
 
 #+begin_src emacs-lisp
   (use-package org-capture
     :ensure org
     :custom
     (org-capture-templates `(("t" "Todo [inbox]" entry
                               (file ,za/org-life-inbox)
                               "* TODO %i%?")
 
                              ("s" "Save for read/watch/listen" entry
                               (file+headline ,za/org-life-someday "Read/watch/listen")
                               "* %?[[%^{link}][%^{description}]] %^g"))))
 #+end_src
 
 *** Todo & custom agenda views
 Todo keywords based on the GTD system (pipe separates incomplete from complete).
 Apart from the logging-on-done configured [[*Logging][below]], I also want to log a note & timestamp when I start waiting on something.
 In ~org-todo-keywords~, ~@~ means note+timestamp, ~!~ means timestamp, ~@/!~ means note+timestamp on state entry and timestamp on leave.
 
 #+begin_src emacs-lisp
   (custom-set-variables '(org-todo-keywords '((sequence "TODO(t)" "NEXT(n)" "STARTED(s)" "WAITING(w@)" "PROJ(p)" "|" "DONE(d)" "CANCELLED(c)")))
                         '(org-todo-keyword-faces '(("TODO" . org-todo)
                                                    ("NEXT" . org-todo)
                                                    ("WAITING" . org-todo)
                                                    ("STARTED" . org-todo)
                                                    ("PROJ" . org-todo)
                                                    ("DONE" . org-done)
                                                    ("CANCELLED" . org-done))))
 #+end_src
 
 
 Something is a habit if: it has a HABIT tag, STYLE is habit, LOGGING is logrepeat, it has a scheduled repeater from today.
 
 #+begin_src emacs-lisp
   (defun za/mark-as-habit ()
     "This function makes sure that the current heading has:
   (1) a HABIT tag
   (2) todo set to TODO
   (3) LOGGING property set to logrepeat
   (4) a scheduled repeater from today"
     (interactive)
     (org-back-to-heading t)
     (org-set-property "TODO" "TODO")
     (org-set-property "LOGGING" "logrepeat")
     (org-set-property "STYLE" "habit")
     (org-toggle-tag "HABIT" 'on)
     (org-schedule nil))
 #+end_src
 
 +I decided that projects will not be TODO items, but their progress will be tracked with a progress cookie ([x/y]). This function converts an item to a project: it adds a PROJECT tag, sets the progress indicator to count all checkboxes in sub-items (only TODO items), and removes any existing TODO keywords. Finally, PROJECT tags shouldn't be inherited (i.e. subtasks shouldn't be marked as projects).+
 In the end, I want NEXT items that are part of a project to be shown as such (so inherit that PROJECT tag), but projects themselves will have a PROJ todo keyword.
 This function converts an item to a project.
 
 #+begin_src emacs-lisp
   (defun za/mark-as-project ()
     "This function makes sure that the current heading has
       (1) the tag PROJECT
       (2) the todo keyword PROJ
       (3) the property COOKIE_DATA set to \"todo recursive\"
       (4) a progress indicator"
     (interactive)
     (org-back-to-heading t)
     ;; Step 1: clear out everything
     (org-set-property "TODO" "")
 
     ;; org-set-property errors via org-priority if you try to clear
     ;; priority of an item that doesn't have priority. Stupid design,
     ;; but I can't change that so we gotta jump through hoops:
     (let ((have-priority (org-element-property :priority (org-element-at-point))))
       (when have-priority
         (org-set-property "PRIORITY" "")))
 
     ;; Step 2: set info (stats cookie, todo, tag, properties drawer)
     (forward-whitespace 1)
     (insert "[/] ")
     (org-set-property "TODO" "PROJ")
     (org-toggle-tag "PROJECT" 'on)
     (org-set-property "COOKIE_DATA" "todo recursive")
     (org-update-statistics-cookies nil))
 #+end_src
 
 And a keybinding for it:
 
 #+begin_src emacs-lisp
   (bind-key "C-c g p" #'za/mark-as-project 'org-mode-map)
 #+end_src
 
 Want all tags to be inherited:
 
 #+begin_src emacs-lisp
   (custom-set-variables '(org-tags-exclude-from-inheritance nil))
 #+end_src
 
 Define a function to skip items if they're part of a project (i.e. one of their parents has a "PROJECT" tag).
 +The problem is, the "PROJECT" tag isn't inherited. So, we temporarily disable excluding from inheritance, just for the ~org-get-tags~ call. Then check if "PROJECT" is one of the tags.+ That tag is now inherited.
 
 #+begin_src emacs-lisp
   (defun za/skip-if-in-project ()
     "Skip items that are part of a project but not a project themselves."
     (let ((skip (save-excursion (org-end-of-subtree t)))
           (keep nil)
           (item-tags (let ((org-use-tag-inheritance t)) (org-get-tags)))
           (item-tags-without-inherited (let ((org-use-tag-inheritance nil)) (org-get-tags))))
       (if (and (member "PROJECT" item-tags)
                (not (member "PROJECT" item-tags-without-inherited)))
           skip
         keep)))
 #+end_src
 
 Also, define a function to skip tasks (trees) that are not habits (i.e. don't have the STYLE property ~habit~):
 
 #+begin_src emacs-lisp
   (defun za/skip-unless-habit ()
     "Skip trees that are not habits"
     (let ((skip (save-excursion (org-end-of-subtree t)))
           (keep nil))
       (if (string= (org-entry-get nil "STYLE") "habit")
           keep
         skip)))
 #+end_src
 
 And one to skip tasks that /are/ habits:
 
 #+begin_src emacs-lisp
   (defun za/skip-if-habit ()
     "Skip trees that are not habits"
     (let ((skip (save-excursion (org-end-of-subtree t)))
           (keep nil))
       (if (string= (org-entry-get nil "STYLE") "habit")
           skip
         keep)))
 #+end_src
 
 Skip ones with a habit tag:
 
 #+begin_src emacs-lisp
   (defun za/skip-if-has-habit-tag ()
     (let ((skip (save-excursion (org-end-of-subtree t)))
           (keep nil)
           (item-tags-without-inherited (let ((org-use-tag-inheritance nil)) (org-get-tags))))
       (if (or (member "HABIT" item-tags-without-inherited)
               (member "flatastic" item-tags-without-inherited))
           skip
         keep)))
 #+end_src
 
 And another function, to skip tasks that are blocked:
 
 #+begin_src emacs-lisp
   (defun za/skip-if-blocked ()
     "Skip trees that are blocked by previous tasks"
     (let ((skip (save-excursion (org-end-of-subtree t)))
           (keep nil))
       (if (org-entry-blocked-p)
           skip
         keep)))
 #+end_src
 
 For listing tasks without a context - skip if it has a context tag:
 
 #+begin_src emacs-lisp
   (defun za/skip-if-has-context ()
     (let ((skip (save-excursion (org-end-of-subtree t)))
           (keep nil)
           (item-tags-without-inherited (let ((org-use-tag-inheritance nil)) (org-get-tags)))
           (context-tag-p (lambda (s) (eq (aref s 0) ?@))))
       (if (cl-some context-tag-p item-tags-without-inherited)
           skip
         keep)))
 #+end_src
 
 For listing tasks without an energy level - skip if it has an energy level:
 
 #+begin_src emacs-lisp
   (defun za/skip-if-has-energy-level ()
     (let ((skip (save-excursion (org-end-of-subtree t)))
           (keep nil)
           (item-tags-without-inherited (let ((org-use-tag-inheritance nil)) (org-get-tags)))
           (energy-tag-p (lambda (s) (member s '("sport" "cruise" "parked" "errand")))))
       (if (cl-some energy-tag-p item-tags-without-inherited)
           skip
         keep)))
 #+end_src
 
 #+begin_src emacs-lisp
   (defun za/skip-if-scheduled-in-future ()
     (let* ((skip (save-excursion (org-end-of-subtree t)))
            (keep nil)
            (scheduled-time (org-get-scheduled-time (point))))
       (if (and scheduled-time (time-less-p (current-time) scheduled-time))
           skip
         keep)))
 #+end_src
 
 #+begin_src emacs-lisp
   (defun za/skip-if-scheduled ()
     (let* ((skip (save-excursion (org-end-of-subtree t)))
            (keep nil)
            (scheduled-time (org-get-scheduled-time (point))))
       (if scheduled-time
           skip
         keep)))
 #+end_src
 
 Create custom agenda view based on those keywords.
 Agenda views are made up of blocks, appearing in the order that you declare them.
 The first two strings are what shows up in the agenda dispatcher (the key to press and the description).
 
 #+begin_src emacs-lisp
   (setq org-agenda-custom-commands
         '(("n" "Next actions"
            todo "NEXT" ((org-agenda-overriding-header "Next actions:")
                         (org-agenda-sorting-strategy '(priority-down alpha-up))
                         (org-agenda-skip-function #'za/skip-if-scheduled)))
           ("q" "Query" (lambda (&rest _) (call-interactively #'org-ql-search)))
 
           ("W" "Waiting"
            ((todo "WAITING" ((org-agenda-overriding-header "Waiting:")))))
           ("S" . "Saved for later...")
           ("Sw" "Saved to watch"
            ((tags-todo "WATCH" ((org-agenda-overriding-header "To watch:")
                                 (org-agenda-files `(,za/org-life-someday ,@org-agenda-files))))))
 
           ("Sr" "Saved to read"
            ((tags-todo "READ" ((org-agenda-overriding-header "To read:")
                                (org-agenda-files `(,za/org-life-someday ,@org-agenda-files))))))
           ("Sl" "Saved to listen"
            ((tags-todo "LISTEN" ((org-agenda-overriding-header "To listen:")
                                  (org-agenda-files `(,za/org-life-someday ,@org-agenda-files))))))
 
           ("a" . "Agenda with schedule only...")
           ("aw" "This week"
            ((agenda "" ((org-agenda-span 'week)))))
           ("aD" "Today"
            ((agenda "" ((org-agenda-span 'day)))))
           ("ad" "Today (no habits)"
            ((agenda "" ((org-agenda-span 'day)
                         (org-agenda-skip-function 'za/skip-if-has-habit-tag)))))
           ("at" "Tomorrow (no habits)"
            ((agenda "" ((org-agenda-span 'day)
                         (org-agenda-start-day "+1d")
                         (org-agenda-skip-function 'za/skip-if-has-habit-tag)))))
           ("aT" "Tomorrow"
            ((agenda "" ((org-agenda-span 'day)
                         (org-agenda-start-day "+1d")))))
 
           ("w" "Week Agenda + Next Actions"
            ((agenda "" ((org-agenda-overriding-header "Week agenda:")))
             (todo "NEXT" ((org-agenda-overriding-header "Next actions:")))))
 
           ("o" "Month agenda"
            ((agenda "" ((org-agenda-overriding-header "Month agenda:")
                         (org-agenda-span 'month)))))
 
           ("d" "Day Agenda + Habits graph + Waiting"
            ((agenda "" ((org-agenda-overriding-header "Day:")
                         (org-agenda-span 'day)
                         (org-habit-show-habits nil)
                         (org-agenda-skip-function 'za/skip-if-has-habit-tag)))
             (todo "STARTED" ((org-agenda-overriding-header "In progress:")))
             (todo "WAITING" ((org-agenda-overriding-header "Waiting:")))
             (agenda "" ((org-agenda-overriding-header "Habits:")
                         (org-agenda-span 'day)
                         (org-agenda-use-time-grid nil)
                         (org-agenda-skip-function 'za/skip-unless-habit)
                         (org-habit-show-habits t) (org-habit-show-habits-only-for-today nil)
                         (org-habit-show-all-today t)))))
           ("D" "Day Agenda with habit tags + Habits + Waiting"
            ((agenda "" ((org-agenda-overriding-header "Day:")
                         (org-agenda-span 'day)
                         (org-habit-show-habits nil)))
             (todo "STARTED" ((org-agenda-overriding-header "In progress:")))
             (todo "WAITING" ((org-agenda-overriding-header "Waiting:")))
             (agenda "" ((org-agenda-overriding-header "Habits:")
                         (org-agenda-span 'day)
                         (org-agenda-use-time-grid nil)
                         (org-agenda-skip-function 'za/skip-unless-habit)
                         (org-habit-show-habits t) (org-habit-show-habits-only-for-today nil)
                         (org-habit-show-all-today t)))))
 
 
           ("k" "Kanban view"
            ((todo "DONE" ((org-agenda-overriding-header "Done:") (org-agenda-sorting-strategy '(deadline-up priority-down alpha-up))))
             (todo "STARTED" ((org-agenda-overriding-header "In progress:") (org-agenda-sorting-strategy '(deadline-up priority-down alpha-up))))
             (todo "NEXT" ((org-agenda-overriding-header "To do:") (org-agenda-sorting-strategy '(deadline-up priority-down alpha-up))))))
 
           ("p" "Projects"
            ((todo "PROJ" ((org-agenda-overriding-header "Projects:")
                           (org-agenda-prefix-format '((todo . " %i %-22(let ((deadline (org-entry-get nil \"DEADLINE\"))) (if deadline deadline \"\"))")))
                           (org-agenda-dim-blocked-tasks nil)
                           (org-agenda-sorting-strategy '((todo deadline-up alpha-down)))))))
           ("1" "1-3-5"
            ((tags "_1" ((org-agenda-overriding-header "Big tasks:")
                         (org-agenda-skip-function 'za/skip-if-scheduled-in-future)
                         (org-agenda-sorting-strategy '(todo-state-down deadline-up priority-down alpha-up))))
             (tags "_3" ((org-agenda-overriding-header "Medium tasks:")
                         (org-agenda-skip-function 'za/skip-if-scheduled-in-future)
                         (org-agenda-sorting-strategy '(todo-state-down deadline-up priority-down alpha-up))))
             (tags "_5" ((org-agenda-overriding-header "Small tasks:")
                         (org-agenda-skip-function 'za/skip-if-scheduled-in-future)
                         (org-agenda-sorting-strategy '(todo-state-down deadline-up priority-down alpha-up))))))
 
           ;; Useful thread for opening calfw: https://github.com/kiwanami/emacs-calfw/issues/18
           ("c" "Calendar view" (lambda (&rest _)
                                  (interactive)
                                  (let ((org-agenda-skip-function 'za/skip-if-habit))
                                    (cfw:open-org-calendar))))
           ("f" . "Find & fix...")
           ("f@" "Next actions missing context"
            todo "NEXT" ((org-agenda-overriding-header "Missing context:")
                         (org-agenda-sorting-strategy '(priority-down alpha-up))
                         (org-agenda-skip-function 'za/skip-if-has-context)))
           ("fe" "Next actions missing energy"
            todo "NEXT" ((org-agenda-overriding-header "Missing energy level:")
                         (org-agenda-sorting-strategy '(priority-down alpha-up))
                         (org-agenda-skip-function 'za/skip-if-has-energy-level)))
           ("ff" "Finished tasks that aren't in a project"
            ((tags "TODO=\"DONE\"|TODO=\"CANCELLED\"" ((org-agenda-overriding-header "Finished tasks:")
                                                       (org-agenda-skip-function 'za/skip-if-in-project)))))
           ("ft" "Tasks without a scheduled time"
            alltodo "" ((org-agenda-overriding-header "Missing scheduled time:")
                        (org-agenda-skip-function '(org-agenda-skip-entry-if 'scheduled 'deadline 'timestamp))))))
 #+end_src
 
 In calfw, I don't want to show habits:
 
 #+begin_src emacs-lisp
   (add-hook 'cfw:calendar-mode-hook (setq-local org-agenda-skip-function 'za/skip-if-habit))
 #+end_src
 
 *** Automatically mark next project item as NEXT
 Unless the current item is a project, when a project item is done, the next item in the project should be marked "NEXT".
 I tried org-edna but I couldn't get it working after an hour of effort. So a bit of lisp is the easier solution.
 
 #+begin_src emacs-lisp
   (defun za/gtd-auto-next ()
     "Automatically mark project item as next."
     (save-excursion
       (org-back-to-heading)
       (when (buffer-narrowed-p)
         (widen))
       (when (and (member org-state org-done-keywords)
                  (not (member "PROJECT" (org-get-tags nil 'local)))
                  (member "PROJECT" (let ((org-use-tag-inheritance t))
                                      (org-get-tags nil))))
         (when (org-goto-sibling)
           (org-entry-put (point) "TODO" "NEXT")))))
 
   (add-hook #'org-after-todo-state-change-hook #'za/gtd-auto-next)
 #+end_src
 
 *** Logging for tasks
 I want to log into the LOGBOOK drawer (useful when I want to take quick notes):
 
 #+begin_src emacs-lisp
   (setq org-log-into-drawer "LOGBOOK")
 #+end_src
 
 I also want to log when I finish a task (useful for archiving).
 Furthermore, when I'm done, I want to add a note (any important
 workarounds/tips). And when I reschedule, I want to know the reason.
 I can disable logging on state change for a specific task by adding ~:LOGGING: nil~ to the ~:PROPERTIES:~ drawer.
 
 #+begin_src emacs-lisp
   (setq org-log-done 'time
         org-log-reschedule 'note)
 #+end_src
 
 I want to hide drawers on startup. This variable has options:
 - 'overview': Top-level headlines only.
 - 'content': All headlines.
 - 'showall': No folding on any entry.
 - 'show2levels: Headline levels 1-2.
 - 'show3levels: Headline levels 1-3.
 - 'show4levels: Headline levels 1-4.
 - 'show5levels: Headline levels 1-5.
 - 'showeverything: Show even drawer contents.
 
 #+begin_src emacs-lisp
   (setq org-startup-folded 'content)
 #+end_src
 
 *** Task ordering
 Some tasks should be ordered, i.e. they should be done in steps.
 Those have the ~:ORDERED: t~ setting in ~:PROPERTIES:~, and it should be enforced:
 
 #+begin_src emacs-lisp
   (setq org-enforce-todo-dependencies t)
 #+end_src
 
 Furthermore, tasks that are ordered and can't be done yet because of previous steps should be dimmed in the agenda:
 
 #+begin_src emacs-lisp
   (setq org-agenda-dim-blocked-tasks t)
 #+end_src
 
 I might also want to set ~org-enforce-todo-checkbox-dependencies~, but not convinced on that one yet.
 
 *** Time tracking & effort
 Time tracking should be done in its own drawer:
 
 #+begin_src emacs-lisp
   (setq org-clock-into-drawer "CLOCK")
 #+end_src
 
 And to customize how clock tables work:
 
 #+begin_src emacs-lisp
   (setq org-clocktable-defaults '(:lang "en" :scope agenda-with-archives  :wstart 1 :mstart 1 :compact t :maxlevel nil))
   (setq org-agenda-clockreport-parameter-plist '(:link t :maxlevel nil))
 #+end_src
 
 I want to set effort in hours:minutes:
 
 #+begin_src emacs-lisp
   (add-to-list 'org-global-properties '("Effort_ALL" . "0:05 0:10 0:15 0:20 0:30 0:45 1:00 1:30 2:00 4:00 6:00 8:00"))
 #+end_src
 
 I want column view to look like this:
 
 | To do        | Task      | Tags | Sum of time elapsed | Sum of time estimated (effort) |
 |--------------+-----------+------+---------------------+--------------------------------|
 | todo keyword | task name | tags | sum of clock        | sum of estimated time          |
 | ...          | ...       | ...  | ...                 | ...                            |
 
 #+begin_src emacs-lisp
   (setq org-columns-default-format "%7TODO (To Do) %32ITEM(Task) %TAGS(Tags) %11CLOCKSUM_T(Clock) %10Difficulty(Difficulty) %8Effort(Effort){:}")
 #+end_src
 
 Fix column alignment in agenda.
 
 #+begin_src emacs-lisp
   (set-face-attribute 'org-column nil
                       :height (face-attribute 'default :height)
                       :family (face-attribute 'default :family))
   (set-face-attribute 'org-agenda-date-today nil
                       :height (face-attribute 'default :height))
 #+end_src
 
 *** Calculate time since timestamp
 #+begin_src emacs-lisp
   (defun za/org-time-since ()
     "Print the amount of time between the timestamp at point and the current date and time."
     (interactive)
     (unless (org-at-timestamp-p 'lax)
       (user-error "Not at timestamp"))
 
     (when (org-at-timestamp-p 'lax)
       (let ((timestamp (match-string 0)))
         (with-temp-buffer
           (insert timestamp
                   "--"
                   (org-time-stamp '(16)))
           (org-evaluate-time-range)))))
 #+end_src
 
 Also a method to add overlays with that timestamp:
 
 #+begin_src emacs-lisp
   (defvar-local za/org-timestamp-overlays--list nil "Buffer-local list of overlays with timestamps")
   (defvar-local za/org-timestamp-overlays--show nil "Buffer-local boolean to show overlays.")
   (defun za/org-timestamp-overlays-clear ()
     "Clear all overlays with timestamps in current buffer."
     (dolist (ov za/org-timestamp-overlays--list)
       (delete-overlay ov))
     (setq-local za/org-timestamp-overlays--list nil))
 
   (defun za/org-timestamp-overlays-add ()
     "Add overlays for active timestamps in current buffer."
     (let ((markup-string (lambda (s) (propertize (format "{%s}" s)
                                                  'face 'org-habit-ready-future-face))))
       (save-excursion
         (let* ((beg (point-min))
                (end (point-max)))
           (goto-char beg)
           (while (re-search-forward (org-re-timestamp 'active) end t)
             (let ((ov (make-overlay (point) (point))))
               (overlay-put ov 'before-string (funcall markup-string (za/org-time-since)))
               (add-to-list 'za/org-timestamp-overlays--list ov)))))))
 
   (defun za/org-timestamp-overlays-redraw ()
     "Redraw all overlays for active timestamps."
     (za/org-timestamp-overlays-clear)
     (za/org-timestamp-overlays-add))
 
   (defun za/org-timestamp-hook-fn (&rest _)
     (za/org-timestamp-overlays-redraw))
 
   (bind-key "C-c q p" #'tmp/p)
   (defun za/org-timestamp-overlays-toggle (&optional prefix)
     "With no prefix, toggle showing timestamp overlay.
   With PREFIX = 0, redraw overlays.
   With PREFIX > 0, show overlays.
   With PREFIX < 0, hide overlays."
     (interactive "P")
     (let ((overlays-hide (lambda ()
                            (za/org-timestamp-overlays-clear)
                            (remove-hook 'org-cycle-hook #'za/org-timestamp-hook-fn)
                            (setq za/org-timestamp-overlays--show nil)
                            (message "Overlays hidden.")))
           (overlays-show (lambda ()
                            (za/org-timestamp-overlays-redraw)
                            (add-hook 'org-cycle-hook #'za/org-timestamp-hook-fn)
                            (setq za/org-timestamp-overlays--show t)
                            (message "Overlays showing.")))
           (overlays-redraw-maybe (lambda ()
                                    (when za/org-timestamp-overlays--show
                                      (za/org-timestamp-overlays-redraw)
                                      (message "Redrawing overlays."))))
           (prefix-num (prefix-numeric-value prefix)))
       (cond ((not prefix)
              (cond (za/org-timestamp-overlays--show
                     (funcall overlays-hide))
                    (t
                     (funcall overlays-show))))
             ((zerop prefix-num)
              )
             ((> prefix-num 0)
              (funcall overlays-show))
             ((< prefix-num 0)
              (funcall overlays-hide)))))
 
 #+end_src
 
 Bind a key:
 
 #+begin_src emacs-lisp
   (bind-key "C-c q d" #'za/org-timestamp-overlays-toggle 'org-mode-map)
   (bind-key "C-c q d" #'za/org-timestamp-overlays-toggle 'org-agenda-mode-map)
 #+end_src
 *** Priorities: how important something is
 I usually have a lot of 'next' actions, so I prefer 4 priority levels instead of the default 3: A (urgent, ASAP), B (important),  C (if you have nothing else, do this), D (do in free time):
 
 #+begin_src emacs-lisp
   (setq org-priority-highest ?A
         org-priority-lowest ?D
         org-priority-default ?C)
 #+end_src
 
 Faces for priorities in agenda:
 
 #+begin_src emacs-lisp
   (setq org-priority-faces `((?A . (:foreground ,(face-foreground 'error)))
                              (?B . (:foreground ,(face-foreground 'org-todo)))
                              (?C . (:foreground ,(face-foreground 'font-lock-constant-face) :weight semi-light))
                              (?D . (:foreground ,(face-foreground 'font-lock-string-face) :slant italic :weight light))))
 #+end_src
 
 And to be able to bulk-set priorities in agenda:
 
 #+begin_src emacs-lisp
   (setq org-agenda-bulk-custom-functions '((?P (lambda nil (org-agenda-priority 'set)))))
 #+end_src
 *** Energy requirement: how difficult something is
 #+begin_src emacs-lisp
   (add-to-list 'org-global-properties '("Difficulty_ALL" . "low medium high"))
 #+end_src
 *** Org export backends
 #+begin_src emacs-lisp
   (use-package ox-pandoc)
 #+end_src
 
 *** org publishing
 I decided, after trying many different things, to settle on org-publish.
 
 #+begin_src emacs-lisp
   (defconst za/org-roam-top-name "Top" "The name of the top-level Org-roam node.")
   (defun za/org-roam-sitemap-function (title list)
     "Customized function to generate sitemap for org-roam, almost the same as `org-publish-sitemap-default`."
     (concat "#+TITLE: " title "\n\n"
             (format "[[file:%s][%s]]\n\n"
                     (file-name-nondirectory (org-roam-node-file
                                              (org-roam-node-from-title-or-alias za/org-roam-top-name)))
                     "Click here for entrypoint.")))
   ;; (org-list-to-org list)))  <-- this is taken care of by Zola
 
 #+end_src
 
 To make this work with Zola, I need to export Github-flavored markdown (fenced code blocks with language):
 
 #+begin_src emacs-lisp
   (require 'ox-publish)
   (require 'ox-md)
 
   (use-package ox-gfm
     :init
     (with-eval-after-load 'org (require 'ox-gfm)))
 #+end_src
 
 First difficulty: Zola needs front matter with ~+++...+++~.
 The default Markdown backend doesn't provide that, so need to customize it by advising the default ~org-md-template~.
 
 #+begin_src emacs-lisp
   (defun za/org-md-template-zola (contents info)
     "Markdown template compatible with Zola (generates the necessary front matter from CONTENTS and INFO)."
     (let ((title (org-md-plain-text (org-element-interpret-data (plist-get info :title)) info)))
       (concat "+++\n"
               (format "title = \"%s\"\n" (string-replace "\"" "'" title))
 
               ;; If the note contains a math org-roam tag
               (when (member "math" (plist-get info :filetags))
                 "template = \"page-math.html\"\n")
 
               "+++\n"
               (format "# %s\n" title)
               contents)))
 #+end_src
 
 Second difficulty: links need to be reformatted and changed for static data (like images).
 This function filters the return value of ~org-md-link~.
 
 #+begin_src emacs-lisp
   (defun za/org-md-link-zola (linkstr)
     "A filter function for the return value of
           `org-md-link` (LINKSTR) to generate a link compatible with Zola."
     (cond ((string-match-p (rx ".md") linkstr)
            (string-replace "](" "](@/org-roam/" linkstr))
           ((string-match-p (rx "](" (? (* alnum) "://") "/") linkstr)
            (replace-regexp-in-string (rx "](" (? (* alnum) "://") "/" (* any) "/org-roam/data") "](/org-roam-data" linkstr))
           (t linkstr)))
 #+end_src
 
 A wrapper to set the right image link:
 
 #+begin_src emacs-lisp
   (defun za/org-html--format-image (args)
     "Modify source image link to work with my Org roam setup"
     (let ((source (nth 0 args))
           (_attributes (nth 1 args))
           (_info (nth 2 args)))
       (list (replace-regexp-in-string (rx bos "data/") "/org-roam-data/" source)
             _attributes
             _info)))
 #+end_src
 
 And here's the custom publish function that adds/removes the necessary advice:
 
 #+begin_src emacs-lisp
   (defun za/org-gfm-publish-to-gfm-zola (plist filename pub-dir)
     "Run `org-gfm-publish-to-gfm`, advising the necessary
   functions to generate Zola-compatible markdown."
     (let* ((org-export-output-file-name-locked (lambda (extension &rest _)
                                                  (concat (plist-get plist :publishing-directory)
                                                          "locked-"
                                                          (file-name-base filename)
                                                          extension)))
            (node (car (seq-filter
                        (lambda (node) (file-equal-p (org-roam-node-file node) filename))
                        (org-roam-node-list))))
            (locked-p (cond ((file-equal-p filename
                                           (file-name-concat (plist-get plist :base-directory) (plist-get plist :sitemap-filename)))
                             nil)
                            (t
                             (member "locked" (org-roam-node-tags node)))))
            (advice '((org-gfm-inner-template :override za/org-md-template-zola)
                      (org-md-link :filter-return za/org-md-link-zola)
                      (org-html--format-image :filter-args za/org-html--format-image)
                      (org-gfm-table :override org-md--convert-to-html)))) ; Zola uses CommonMark, so doesn't support Markdown tables
 
       (dolist (orig-type-new advice) (apply #'advice-add orig-type-new))
       (unwind-protect
           (cond (locked-p
                  (advice-add #'org-export-output-file-name :override org-export-output-file-name-locked)
                  (unwind-protect
                      (org-gfm-publish-to-gfm plist filename pub-dir)
                    (advice-remove #'org-export-output-file-name org-export-output-file-name-locked)))
                 (t
                  (org-gfm-publish-to-gfm plist filename pub-dir)))
         (dolist (orig-type-new advice)
           (advice-remove (nth 0 orig-type-new)
                          (nth 2 orig-type-new))))))
 #+end_src
 
 Finally, the list of things we can publish with their respective publishin functions:
 
 #+begin_src emacs-lisp
   (if (boundp 'za/my-website-dir)
       (setq org-publish-project-alist
             `(
               ("org-notes"
                :base-directory ,za/org-roam-dir
                :base-extension "org"
                :publishing-directory ,(concat za/my-website-dir "content/org-roam/")
                :publishing-function za/org-gfm-publish-to-gfm-zola
                :recursive t
                :sitemap-filename "_index.md"
                :sitemap-title "Org Roam"
                :sitemap-function za/org-roam-sitemap-function
                :auto-sitemap t)
 
               ("org-notes-data"
                :base-directory ,(concat za/org-roam-dir "/data")
                :base-extension any
                :publishing-directory ,(concat za/my-website-dir "static/org-roam-data/")
                :recursive t
                :publishing-function org-publish-attachment)
 
               ("org-roam" :components ("org-notes" "org-notes-data"))))
     (warn "za/my-website-dir not bound, not setting org publishing targets."))
 #+end_src
 
 And a function to rsync to my VPS:
 
 #+begin_src emacs-lisp
   (defun za/publish-upload-to-website ()
     "Upload my website to my VPS"
     (interactive)
     (async-shell-command (format "cd %s && zola build && yes|publish" za/my-website-dir) "*Async Shell publish*"))
 #+end_src
 *** Rebuild org cache
 
 #+begin_src emacs-lisp
   (defun za/force-org-rebuild-cache ()
     "Rebuild the `org-mode' and `org-roam' cache."
     (interactive)
     (org-id-update-id-locations)
     ;; Note: you may need `org-roam-db-clear-all'
     ;; followed by `org-roam-db-sync'
     (org-roam-db-sync)
     (org-roam-update-org-id-locations))
 #+end_src
 *** Sync with Flatastic
 API work is handled via an external ruby script.
 
 #+begin_src emacs-lisp
   (defun za/org-flatastic-sync-tasks ()
     "Add tasks from flatastic to inbox"
     (interactive)
     (unless (json-available-p)
       (user-error "JSON not available"))
     (unless (boundp 'za/org-life-inbox)
       (user-error "Please set za/org-life-inbox"))
     (let* ((api-data (json-parse-string
                       (progn
                         (require 'exec-path-from-shell)
                         (exec-path-from-shell-copy-envs
                          '("FLATASTIC_API_KEY" "FLATASTIC_USER_ID"))
                         (shell-command-to-string "~/.local/share/rbenv/shims/ruby ~/.scripts/flatastic.rb"))
                       :object-type 'alist))
            (format-data-as-org (lambda (l)
                                  (format "* TODO %s :flatastic:\n  SCHEDULED: <%s>\n  Points: %d\n"
                                          (alist-get 'description l)
                                          (alist-get 'scheduled_due_date l)
                                          (alist-get 'point_value l))))
            (org-flatastic-items (mapcar format-data-as-org api-data)))
       (with-current-buffer (find-file-noselect za/org-life-inbox)
         (goto-char (point-max))
         (insert "\n" (string-join org-flatastic-items "\n")))
       (message "Synced %d Flatastic tasks to inbox" (length api-data))))
 #+end_src
 *** Link to Thunderbird messages
 Create a custom link to open thunderbird emails by ID:
 
 #+begin_src emacs-lisp
   (org-link-set-parameters
    "thunderbird"
    :follow #'za/org-link-thunderbird-follow)
 
   (defun za/org-link-thunderbird-follow (messageid)
     "Open the message with id `messageid` in Thunderbird"
     (shell-command (format "thunderbird mid:%s" (shell-quote-argument messageid))))
 #+end_src
 *** Inverse refile
 #+begin_src emacs-lisp
   (defun za/org-refile-to-point (refloc)
     "Prompt for a heading and refile it to point."
     (interactive (list (org-refile-get-location "Heading: ")))
     (let* ((file (nth 1 refloc))
            (pos (nth 3 refloc)))
       (save-excursion
         (with-current-buffer (find-file-noselect file 'noward)
           (save-excursion
             (save-restriction
               (widen)
               (goto-char pos)
               (org-copy-subtree 1 t))))
         (org-paste-subtree nil nil nil t))))
 
 
   (defun za/org-refile-wrapper (arg)
     "Wrap org-refile so that it does the inverse with a negative argument"
     (interactive "P")
     (if (minusp (prefix-numeric-value arg))
         (call-interactively #'za/org-refile-to-point)
       (org-refile arg)))
 
 #+end_src
 
 *** org-caldav
 This lets me sync my Org agenda to my CalDAV server.
 The main reason is because Orgzly doesn't have a calendar view and can't (yet) search for events on a specific day, so if someone asks "are you free on that day", it's a bit hard for me to answer if I don't have my computer with me.
 This way, I can just check my calendar.
 
 #+begin_src emacs-lisp
   (if (and (boundp 'za/caldav-url)
            (boundp 'za/caldav-org-calendar-id)
            (boundp 'za/org-life-calendar-inbox))
       (use-package org-caldav
         :init
         (defconst za/org-life-calendar-inbox (concat za/org-life-dir "calendar-inbox.org"))
         :custom
         (org-caldav-url za/caldav-url)
         (org-caldav-calendar-id za/caldav-org-calendar-id)
         (org-caldav-inbox za/org-life-calendar-inbox)
         (org-caldav-files (cons (car (split-string org-archive-location "::")) org-agenda-files))
         (org-caldav-sync-todo nil)
         (org-icalendar-include-todo nil)
         (org-icalendar-use-deadline '(event-if-todo event-if-not-todo todo-due))
         (org-icalendar-use-scheduled '(todo-start event-if-todo event-if-not-todo))
         (org-caldav-exclude-tags '("HABIT")
                                  "I don't want to export habits, because those will just clutter up my calendar. The calendar is supposed to be for one-off stuff, or rarely repeating stuff. Yes, I have to manually add the HABIT tag to every habit. Perhaps nicer would be to exclude based on the property ~:STYLE: habit~, but I haven't figured that one out yet.")
         (org-caldav-todo-percent-states '((0 "TODO")
                                           (0 "WAITING")
                                           (1 "NEXT")
                                           (2 "STARTED")
                                           (0 "PROJ")
                                           (100 "DONE")
                                           (100 "CANCELLED")))
         :config
         (defun za/caldav-after-sync-notify () (za/notify "org-caldav sync complete" "Finished syncing"))
         (advice-add #'org-caldav-sync :after #'za/caldav-after-sync-notify)
         (advice-add #'org-caldav-sync :around #'za/notify-on-interactivity))
     (warn "za/caldav-url, za/caldav-org-calendar-id, za/org-life-calendar-inbox not bound, not using org-caldav."))
 #+end_src
 
 Maybe check [[https://old.reddit.com/r/orgmode/comments/8rl8ep/making_orgcaldav_useable/e0sb5j0/][this]] for a way to sync on save.
 
 *** org-ref
 #+begin_src emacs-lisp
   (use-package org-ref)
 #+end_src
 *** org-roam
 #+begin_src emacs-lisp
   (use-package org-roam
     :custom
     (org-roam-directory za/org-roam-dir)
     (org-roam-completion-everywhere t)
     (org-roam-dailies-capture-templates
      '(("d" "default" entry
         "* %U\n%?"
         :target (file+head "%<%Y-%m-%d>.org"
                            "#+title: %<%Y-%m-%d>\n"))))
     :config
                                           ; can't use nil because org-roam-ui checks for boundp on this and
                                           ; errors if bound but nil.
     (with-eval-after-load 'org-roam-dailies
       (makunbound 'org-roam-dailies-directory))
     (defun za/org-roam-dailies-goto-latest-note ()
       (interactive)
       (unless (boundp 'org-roam-dailies-directory)
         (za/org-roam-dailies-select-dir))
       (let* ((dailies (org-roam-dailies--list-files))
              (latest-note (car (last dailies))))
         (unless latest-note
           (user-error "Can't find latest note"))
         (find-file latest-note)
         (run-hooks 'org-roam-dailies-find-file-hook)))
     (org-roam-setup)
     (bind-keys :prefix "C-c w"
                :prefix-map za/org-roam-map
                :prefix-docstring "Org roam"
                ("n" . org-roam-capture)
                ("f" . org-roam-node-find)
                ("w" . org-roam-buffer-toggle)
                ("i" . org-roam-node-insert))
     (bind-keys :prefix "C-c j"
                :prefix-map za/org-roam-dailies-map
                :prefix-docstring "Org roam dailies"
                ("s" . za/org-roam-dailies-select-dir)
                ("n" . org-roam-dailies-capture-today)
                ("j" . org-roam-dailies-goto-today)
                ("+" . org-roam-dailies-goto-tomorrow)
                (">" . org-roam-dailies-goto-next-note)
                ("-" . org-roam-dailies-goto-yesterday)
                ("<" . org-roam-dailies-goto-previous-note)
                ("g" . org-roam-dailies-goto-date)
                ("l" . za/org-roam-dailies-goto-latest-note)
                ("." . org-roam-dailies-find-directory))
 
     (defun za/org-roam-dailies--daily-note-p (&optional file)
       "Replacement of default function. Return t if FILE is an Org-roam daily-note, nil otherwise.
   If FILE is not specified, use the current buffer's file-path."
       (when-let ((path (expand-file-name
                         (or file
                             (buffer-file-name (buffer-base-buffer)))))
                  (directory (expand-file-name org-roam-dailies-directory org-roam-directory)))
         (setq path (expand-file-name path))
         (save-match-data
           (and
            ;; (org-roam-file-p path) ; don't want this, dailies might not be in org-roam path
            (org-roam-descendant-of-p path directory)))))
     (advice-add #'org-roam-dailies--daily-note-p :override #'za/org-roam-dailies--daily-note-p)
 
     (defun za/org-roam-dailies-select-dir ()
       "Select an org-roam-dailies folder."
       (interactive)
       (let* ((choices (cons '(?0 nil) za/org-roam-dailies-dirs))
              (choice (nth 1 (read-multiple-choice "org-roam-dailies dir" choices))))
         (if choice
             (progn (setq org-roam-dailies-directory choice)
                    (message "Selected org-roam-dailies directory: %s" org-roam-dailies-directory))
           (makunbound 'org-roam-dailies-directory))))
 
     (defun za/org-roam-dailies-calendar-mark-entries-p ()
       "Only mark dailies entries in calendar if a dailies directory is set."
       (boundp 'org-roam-dailies-directory))
     (advice-add #'org-roam-dailies-calendar-mark-entries :before-while #'za/org-roam-dailies-calendar-mark-entries-p)
 
     ;; Before doing anything journal-related, check that a journal is
     ;; selected, or prompt for one.
     (defun za/org-roam-dailies--capture-check-non-nil-dailies-dir (&rest _)
       (unless (boundp 'org-roam-dailies-directory)
         (za/org-roam-dailies-select-dir))
       (unless (boundp 'org-roam-dailies-directory)
         (user-error "No org-roam-dailies-directory selected!")))
 
     (advice-add #'org-roam-dailies--capture :before #'za/org-roam-dailies--capture-check-non-nil-dailies-dir)
     (advice-add #'org-roam-dailies-goto-date :before #'za/org-roam-dailies--capture-check-non-nil-dailies-dir)
     (require 'org-roam-export))
 #+end_src
 
 *** org-roam-ui
 #+begin_src emacs-lisp
   (use-package org-roam-ui)
 #+end_src
 *** org-download
 Drag-and-drop images to Emacs Org mode.
 
 #+begin_src emacs-lisp
   (use-package org-download
     :custom
     (org-download-method 'attach)
     (org-download-backend t))
 #+end_src
 
 *** org-sticky-header
 Displays in the header-line the Org heading for the node that’s at the top of the window.
 
 #+begin_src emacs-lisp
   (use-package org-sticky-header)
 #+end_src
 *** org-timestone
 #+begin_src emacs-lisp
   (use-package org-timestone
     :init (za/package-vc-install :repo "thezeroalpha/org-timestone.el")
     :ensure nil
     :after org
     :bind (:map org-mode-map
                 ("C-c C-t" . org-timestone-org-todo-wrapper)))
 #+end_src
 *** org-noter
 #+begin_src emacs-lisp
   (use-package org-noter
     :config
     ;; Fix disabling of line wrap by no-opping set-notes-scroll
     (advice-add 'org-noter--set-notes-scroll :override 'za/no-op))
 #+end_src
 *** el-easydraw
 Lets you draw stuff in org mode documents.
 
 #+begin_src emacs-lisp :tangle no
   (za/package-vc-install :repo "misohena/el-easydraw" :name "edraw")
   (with-eval-after-load 'org
     (require 'edraw-org)
     (edraw-org-setup-default)
     (bind-key "C-c q c" #'edraw-color-picker-insert-color))
 #+end_src
 *** ox-jira
 #+begin_src emacs-lisp
   (use-package ox-jira)
 #+end_src
 *** org-confluence
 ox-confluence with some custom code to remove the theme & create expandable drawers.
 Add to confluence by pressing ~ctrl + shift + d~ when editing a page and inserting confluence wiki text.
 
 #+begin_src emacs-lisp
   (require 'ox-confluence)
   (org-export-define-derived-backend 'confluence-ext 'confluence
     :translate-alist '((drawer . za/org-confluence-drawer))
     :filters-alist '((:filter-src-block . za/org-confluence--code-block-remove-theme))
     :menu-entry
     '(?F "Export to Confluence (ext)"
          ((?F "As Confluence buffer (ext)" za/org-confluence-export-as-confluence))))
 
   (defun za/org-confluence-export-as-confluence
       (&optional async subtreep visible-only body-only ext-plist)
     (interactive)
     (org-export-to-buffer 'confluence-ext "*org CONFLUENCE Export*"
       async subtreep visible-only body-only ext-plist (lambda () (text-mode))))
 
   (defun za/org-confluence--code-block-remove-theme (block _backend _info)
     "Remove the theme from the block"
     (replace-regexp-in-string (rx "\{code:theme=Emacs" (? "|")) "\{code:" block))
 
 
   (defun za/org-confluence-drawer (drawer contents info)
     "Handle custom drawers"
     (let* ((name (org-element-property :drawer-name drawer)))
       (concat
        (format "\{expand:%s\}\n" name)
        contents
        "\{expand\}")))
 #+end_src
 *** TODO the path for org-roam export and data export should be configurable, not hard-coded
 ** Mail mode for neomutt
 When editing a message from neomutt, I want to use mail mode.
 Even though I won't be sending the email from there, I like the syntax highlighting :)
 
 #+begin_src emacs-lisp
   (add-to-list 'auto-mode-alist '("/neomutt-" . mail-mode))
 #+end_src
 ** DISABLED Semantic mode
 Disabled for now, don't use it much.
 SemanticDB is written into ~/.emacs.d/semanticdb/.
 
 #+begin_src emacs-lisp :tangle no
   (use-package semantic
     :bind (:map semantic-mode-map
                 ("C-c , ." . semantic-ia-show-summary))
     :custom
     (semantic-default-submodes '(global-semantic-idle-scheduler-mode ; reparse buffer when idle
                                  global-semanticdb-minor-mode ; maintain database
                                  global-semantic-idle-summary-mode  ; show information (e.g. types) about tag at point
                                  global-semantic-stickyfunc-mode))) ; show current func in header line
 
 
 #+end_src
 
 ** Bib(la)tex
 #+begin_src emacs-lisp
   (use-package bibtex
     :config
     (bibtex-set-dialect "biblatex"))
 #+end_src
 
 ** Python
 In Python, I want to enable flycheck and semantic mode:
 
 #+begin_src emacs-lisp
   (add-hook 'python-mode-hook #'flycheck-mode)
   ;;(add-hook 'python-mode-hook #'semantic-mode)
 #+end_src
 
 ** Elisp
 #+begin_src emacs-lisp
   (use-package emacs-lisp
     :ensure nil ; preinstalled
     :hook ((emacs-lisp-mode . flycheck-mode)
            (emacs-lisp-mode . rainbow-mode)
            (emacs-lisp-mode . outline-minor-mode)
            (emacs-lisp-mode . company-mode)))
 #+end_src
 ** lean-mode
 Specifically for the Lean prover.
 I also install company-lean and helm-lean, which are suggested on the [[https://github.com/leanprover/lean-mode][Github page]].
 Then I map company-complete only for lean-mode.
 
 #+begin_src emacs-lisp
   (use-package lean-mode
     :config
     (use-package company-lean)
     :bind (:map lean-mode-map
                 ("S-SPC" . company-complete)))
 #+end_src
 
 ** sh-mode
 #+begin_src emacs-lisp :results value
   (use-package sh-script
     :hook (sh-mode . flycheck-mode))
 #+end_src
 
 ** anki-editor
 Some extra keybindings that are not set up by default.
 anki-editor doesn't provide a keymap so I have to set one up here:
 
 #+begin_src emacs-lisp
   (use-package anki-editor
     :init
     (defvar anki-editor-mode-map (make-sparse-keymap))
     (add-to-list 'minor-mode-map-alist (cons 'anki-editor-mode
                                              anki-editor-mode-map))
     :custom
     (anki-editor-use-math-jax t)
 
     :bind (:map anki-editor-mode-map
                 ("C-c t" . org-property-next-allowed-value)
                 ("C-c i" . anki-editor-insert-note)
                 ("C-c p" . anki-editor-push-notes)
                 ("C-c c" . anki-editor-cloze-dwim)))
 #+end_src
 ** pdf-tools
 A better replacement for DocView:
 
 #+begin_src emacs-lisp
   (use-package pdf-tools
     :init
     (pdf-tools-install)
 
     :custom
     (pdf-annot-default-annotation-properties '((t
                                                 (label . "Alex Balgavy"))
                                                (text
                                                 (icon . "Note")
                                                 (color . "#0088ff"))
                                                (highlight
                                                 (color . "yellow"))
                                                (squiggly
                                                 (color . "orange"))
                                                (strike-out
                                                 (color . "red"))
                                                (underline
                                                 (color . "blue"))))
     :bind (:map pdf-isearch-minor-mode-map
                 ("C-s" . isearch-forward)
                 :map pdf-view-mode-map
                 ;; Save position & jump back
                 ("C-SPC" . (lambda () (interactive) (message "Position saved") (pdf-view-position-to-register ?x)))
                 ("C-u C-SPC" . (lambda () (interactive) (pdf-view-jump-to-register ?x))))
     :hook
     (pdf-annot-list-mode . pdf-annot-list-follow-minor-mode)
     (pdf-annot-edit-contents-minor-mode . org-mode)
     (pdf-view-mode . (lambda () (display-line-numbers-mode 0)))
 
     :config
     ;; The arrow tooltip does not show properly when jumping to a
     ;; location. Maybe this is a Mac-only thing. See here:
     ;; https://github.com/politza/pdf-tools/issues/145
     ;; This ~:override~ advice fixes it, color is customized via ~tooltip~ face
     (advice-add #'pdf-util-tooltip-arrow :override #'za/pdf-util-tooltip-arrow)
     (defun za/pdf-util-tooltip-arrow (image-top &optional timeout)
       "Fix up `pdf-util-tooltip-arrow`, the original doesn't show the arrow."
       (pdf-util-assert-pdf-window)
       (when (floatp image-top)
         (setq image-top
               (round (* image-top (cdr (pdf-view-image-size))))))
       (let* (x-gtk-use-system-tooltips ;allow for display property in tooltip
              (dx (+ (or (car (window-margins)) 0)
                     (car (window-fringes))))
              (dy image-top)
              (pos (list dx dy dx (+ dy (* 2 (frame-char-height)))))
              (vscroll
               (pdf-util-required-vscroll pos))
              (tooltip-frame-parameters
               `((border-width . 0)
                 (internal-border-width . 0)
                 ,@tooltip-frame-parameters))
              (tooltip-hide-delay (or timeout 3)))
         (when vscroll
           (image-set-window-vscroll vscroll))
         (setq dy (max 0 (- dy
                            (cdr (pdf-view-image-offset))
                            (window-vscroll nil t)
                            (frame-char-height))))
         (when (overlay-get (pdf-view-current-overlay) 'before-string)
           (let* ((e (window-inside-pixel-edges))
                  (xw (pdf-util-with-edges (e) e-width)))
             (cl-incf dx (/ (- xw (car (pdf-view-image-size t))) 2))))
         (pdf-util-tooltip-in-window "\u2192" dx dy))))
 #+end_src
 
 *** TODO this clobbers register x. Find a way to not clobber a register
 ** virtualenvwrapper
 Like virtualenvwrapper.sh, but for Emacs.
 
 #+begin_src emacs-lisp
   (use-package virtualenvwrapper
     :custom
     (venv-location "~/.config/virtualenvs")
 
     :config
     (venv-initialize-interactive-shells)
     (venv-initialize-eshell))
 #+end_src
 
 ** ledger
 #+begin_src emacs-lisp
   (use-package ledger-mode
     :mode ("\\.ledger\\'")
     :hook (ledger-mode . company-mode)
     :custom
     (ledger-clear-whole-transactions t)
     (ledger-reconcile-default-commodity "eur")
     (ledger-reports
      '(("unreconciled" "%(binary) [[ledger-mode-flags]] -f %(ledger-file) --start-of-week=1 reg --uncleared")
        ("net-worth-changes" "%(binary) [[ledger-mode-flags]] -f %(ledger-file) reg ^Assets ^Liabilities -R -M -X eur --effective -n")
        ("budget-last-month" "%(binary) -f %(ledger-file) --start-of-week=1 --effective -X eur --period \"last month\" budget ^expenses:budgeted")
        ("budget-this-month" "%(binary) -f %(ledger-file) --start-of-week=1 --effective -X eur --period \"this month\" budget ^expenses:budgeted")
        ("expenses-this-month-vs-budget" "%(binary) -f %(ledger-file) --start-of-week=1 --effective --period \"this month\" --period-sort \"(amount)\" bal ^expenses:budgeted --budget -R")
        ("expenses-last-month-vs-budget" "%(binary) -f %(ledger-file) --start-of-week=1 --effective --period \"last month\" --period-sort \"(amount)\" bal ^expenses:budgeted --budget -R")
        ("expenses-last-month" "%(binary) -f %(ledger-file) --start-of-week=1 --effective --period \"last month\" --period-sort \"(amount)\" bal ^expenses -X eur -R")
        ("expenses-this-month" "%(binary) -f %(ledger-file) --start-of-week=1 --effective --period \"this month\" --period-sort \"(amount)\" bal ^expenses -X eur -R")
        ("expenses-vs-income-this-month" "%(binary) -f %(ledger-file) --start-of-week=1 --effective --period \"this month\" --period-sort \"(amount)\" bal ^income ^expenses -X eur -R")
        ("expenses-vs-income-last-month" "%(binary) -f %(ledger-file) --start-of-week=1 --effective --period \"last month\" --period-sort \"(amount)\" bal ^expenses ^income -X eur -R")
        ("bal-assets-czk" "%(binary) -f %(ledger-file) --start-of-week=1 bal Assets Liabilities -X czk -R")
        ("bal-assets" "%(binary) -f %(ledger-file) --start-of-week=1 bal Assets Liabilities -R")
        ("bal" "%(binary) -f %(ledger-file) --start-of-week=1 bal -B -R")
        ("bal-assets-eur" "%(binary) -f %(ledger-file) --start-of-week=1 bal Assets Liabilities -X eur -R")
        ("monthly-balance-abn-checking" "%(binary) -f %(ledger-file) --start-of-week=1 --effective reg --monthly 'Assets:ABN Checking' -R")
        ("monthly-expenses" "%(binary) -f %(ledger-file) --monthly register ^expenses --effective --collapse -X eur -R")
        ("reg" "%(binary) -f %(ledger-file) --start-of-week=1 reg -R")
        ("payee" "%(binary) -f %(ledger-file) --start-of-week=1 reg @%(payee) -R")
        ("account" "%(binary) -f %(ledger-file) --start-of-week=1 reg %(account) -R")
        ("reg-org-table" "%(binary) -f %(ledger-file) csv --csv-format '|%(scrub(date))|%(scrub(display_account))|%(scrub(payee))|%(scrub(display_amount))|%(scrub(display_total))|
   ' %(account) -R")))
     :config
     (with-eval-after-load 'ledger-mode
       (setq ledger-amount-regex
             (rx
              (group (or (= 2 " ") ?\t (seq " " ?\t)))
              (zero-or-more (any " " ?\t))
              (opt "=")
              (zero-or-more space)
              (opt "-")
              (opt "(")
              (one-or-more (opt (group
                                 (one-or-more (any "A-Z" "$(_£€₹"))
                                 (zero-or-more blank)))
                           (group (opt "-")
                                  (or (one-or-more (any "0-9"))
                                      (+\? (any "0-9" ",."))))
                           (opt (group (any ",.")
                                       (one-or-more (any "0-9" ")"))))
                           (opt (group (zero-or-more blank)
                                       (one-or-more (any "\"_£€₹" word))))
                           (opt (zero-or-more (any blank))
                                (any "*+/-")
                                (zero-or-more (any blank))))
              (opt ")")
              (opt (group (zero-or-more (any blank))
                          (any "=@{")
                          (opt "@")
                          (+? (not (any ?\xA ";")))))
              (opt (group (or (seq (one-or-more (any blank)) ";" (+\? nonl))
                              (zero-or-more (any blank)))))
              eol))))
 #+end_src
 
 org-capture lets me add transactions from anywhere in Emacs:
 
 Budget throws an error when there's multiple commodities involved.
 See discussion here: https://github.com/ledger/ledger/issues/1450#issuecomment-390067165
 
 #+begin_src emacs-lisp
   (defconst za/ledger-budget-fix-string
     "-X eur -F '%(justify(scrub(get_at(display_total, 0)), 20, -1, true, false)) %(justify(get_at(display_total, 1) ? -scrub(get_at(display_total, 1)) : 0.0, 20,            20 + 1 + 20, true, false)) %(justify(get_at(display_total, 1) ? (get_at(display_total, 0) ?           -(scrub(get_at(display_total, 1) + get_at(display_total, 0))) :           -(scrub(get_at(display_total, 1)))) : -(scrub(get_at(display_total, 0))), 20,            20 + 1 + 20 + 1 + 20, true, false))%(get_at(display_total, 1) and (abs(quantity(scrub(get_at(display_total, 0))) /           quantity(scrub(get_at(display_total, 1)))) >= 1) ?  \" \" : \" \")%(justify((get_at(display_total, 1) ?           (100% * (get_at(display_total, 0) ? scrub(get_at(display_total, 0)) : 0.0)) /              -scrub(get_at(display_total, 1)) : \"na\"),            5, -1, true, false))  %(!options.flat ? depth_spacer : \"\")%-(partial_account(options.flat))\n%/%$2 %$3 %$4 %$6\n%/%(prepend_width ? \" \" * int(prepend_width) : \"\")    ----------------     ----------------     ---------------- -----\n'"
     "Append this to a ledger budget to fix errors with multiple commodities.")
 #+end_src
 
 ** Notmuch
 #+begin_src emacs-lisp
   (use-package notmuch
     :custom
     (notmuch-saved-searches
      `((:name "inbox: personal" :query ,(format "folder:/%s/ tag:inbox" za/email-personal) :key ,(kbd "ip") :search-type 'tree)
        (:name "inbox: school" :query ,(format "folder:/%s/ tag:inbox" za/email-vu) :key ,(kbd "is") :search-type 'tree)
        (:name "archive: personal" :query ,(format "folder:/%s/ tag:archive" za/email-personal) :key ,(kbd "ap") :search-type 'tree)
        (:name "archive: school" :query ,(format "folder:/%s/ tag:archive" za/email-vu) :key ,(kbd "as") :search-type 'tree))
      "Define some saved searches (i.e. mailboxes)")
     (notmuch-hello-sections
      '(notmuch-hello-insert-header
        notmuch-hello-insert-saved-searches
        notmuch-hello-insert-search
        notmuch-hello-insert-alltags
        notmuch-hello-insert-footer)
      "Define the main screen sections")
     (notmuch-search-oldest-first nil "Show newest mail first")
     (notmuch-archive-tags '("-inbox" "+archive"))
     (notmuch-tagging-keys '(("a" notmuch-archive-tags "Archive")
                             ("r" notmuch-show-mark-read-tags "Mark read")
                             ("u" notmuch-show-mark-unread-tags "Mark unread")
                             ("d" notmuch-delete-tags "Delete")))
 
     :bind (("C-c m" . notmuch)
            :map notmuch-show-mode-map
            ("C-c M-y" . shr-copy-url))
     ;; Run notmuch-hook script on hello refresh, to move messages to
     ;; folders according to their tags:
     :hook (notmuch-hello-refresh . za/notmuch-hook-tags2folders)
     :init (setenv "NOTMUCH_CONFIG" "/Users/alex/.config/notmuch/config")
     :config
     (setq notmuch-show-mark-unread-tags '("+unread"))
     (setq notmuch-delete-tags '("-inbox" "+trash"))
     (defun za/notmuch-hook-tags2folders ()
       "Run notmuch-hook to organise email in folders based on tags."
       (start-process "notmuch-hook" nil "notmuch-hook" "--tags2folders")))
 #+end_src
 
 ** MPC
 #+begin_src emacs-lisp
   (use-package mpc
     :custom
     (mpc-browser-tags '(AlbumArtist Album Genre Playlist)
                       "Set the windows I want to show")
 
     :bind (:map mpc-mode-map
                 ("a" . mpc-playlist-add)
                 ("P" . mpc-playlist)
                 ("x" . mpc-playlist-delete)
                 ("p" . mpc-toggle-play)
                 ("t" . mpc-select-toggle)
                 ("f" . za/mpc-seek-forward-20-seconds)
                 ("b" . za/mpc-seek-backward-20-seconds))
     :config
     (defun za/mpc-seek-forward-20-seconds ()
       "Seek forward 20 seconds"
       (interactive)
       (mpc-seek-current "+20"))
 
     (defun za/mpc-seek-backward-20-seconds ()
       "Seek backward 20 seconds"
       (interactive)
       (mpc-seek-current "-20")))
 #+end_src
 ** Dired
 #+begin_src emacs-lisp
   (use-package dired
     :ensure nil ; installed with Emacs
     :bind (:map dired-mode-map
                 ;; 'i' expands subdirs, so I want to be able to close them too.
                 ("M-k" . dired-kill-subdir))
     :custom
     (dired-listing-switches "-alhv")
     (dired-dwim-target t "If I have another dired window open, use that as target")
     ;; By default, hide details (show again by pressing oparen):
     :hook (dired-mode . dired-hide-details-mode))
 #+end_src
 
 ** ess: statistics (R, SAS...)
 #+begin_src emacs-lisp
   (use-package ess)
 #+end_src
 
 ** help mode
 #+begin_src emacs-lisp
   (use-package help-mode
     :ensure nil ; included with Emacs
     :hook (help-mode . za/settings-on-help-mode)
     :config
     (defun za/settings-on-help-mode ()
       "Settings on enabling help mode"
       (za/toggle-wrap t)))
 #+end_src
 ** helpful
 An alternative to the built-in Emacs help that provides much more contextual information.
 I use counsel, so I use the keybindings in [[*counsel + ivy + swiper]].
 I just augment the functions counsel uses.
 Also, counsel doesn't provide some keybindings that I can get from helpful.
 
 #+begin_src emacs-lisp
   (use-package helpful
     :custom
     (counsel-describe-symbol-function #'helpful-symbol)
     (counsel-describe-function-function #'helpful-callable)
     (counsel-describe-variable-function #'helpful-variable)
 
     :bind (("C-h k" . helpful-key)
            ("C-h C" . helpful-command)
            :map helpful-mode-map
            ("l" . za/helpful-previous)
            ("r" . za/helpful-next))
 
     :hook (helpful-mode . za/settings-on-helpful-mode)
     :config
 
     (defun za/settings-on-helpful-mode ()
       "Settings on enabling helpful mode"
       (za/toggle-wrap t))
 
     ;; Then, a way to jump forward and backward in the window:
     (defvar za/helpful-buffer-ring-size 20
       "How many buffers are stored for use with `helpful-next'.")
 
     (defvar za/helpful--buffer-ring (make-ring za/helpful-buffer-ring-size)
       "Ring that stores the current Helpful buffer history.")
 
     (defun za/helpful--buffer-index (&optional buffer)
       "If BUFFER is a Helpful buffer, return it’s index in the buffer ring."
       (let ((buf (or buffer (current-buffer))))
         (and (eq (buffer-local-value 'major-mode buf) 'helpful-mode)
              (seq-position (ring-elements za/helpful--buffer-ring) buf #'eq))))
 
     (defun za/helpful--new-buffer-a (help-buf)
       "Update the buffer ring according to the current buffer and HELP-BUF."
       :filter-return #'helpful--buffer
       (let ((buf-ring za/helpful--buffer-ring))
         (let ((newer-buffers (or (za/helpful--buffer-index) 0)))
           (dotimes (_ newer-buffers) (ring-remove buf-ring 0)))
         (when (/= (ring-size buf-ring) za/helpful-buffer-ring-size)
           (ring-resize buf-ring za/helpful-buffer-ring-size))
         (ring-insert buf-ring help-buf)))
 
     (advice-add #'helpful--buffer :filter-return #'za/helpful--new-buffer-a)
 
     (defun za/helpful--next (&optional buffer)
       "Return the next live Helpful buffer relative to BUFFER."
       (let ((buf-ring za/helpful--buffer-ring)
             (index (or (za/helpful--buffer-index buffer) -1)))
         (cl-block nil
           (while (> index 0)
             (cl-decf index)
             (let ((buf (ring-ref buf-ring index)))
               (if (buffer-live-p buf) (cl-return buf)))
             (ring-remove buf-ring index)))))
 
 
     (defun za/helpful--previous (&optional buffer)
       "Return the previous live Helpful buffer relative to BUFFER."
       (let ((buf-ring za/helpful--buffer-ring)
             (index (1+ (or (za/helpful--buffer-index buffer) -1))))
         (cl-block nil
           (while (< index (ring-length buf-ring))
             (let ((buf (ring-ref buf-ring index)))
               (if (buffer-live-p buf) (cl-return buf)))
             (ring-remove buf-ring index)))))
 
     (defun za/helpful-next ()
       "Go to the next Helpful buffer."
       (interactive)
       (when-let (buf (za/helpful--next))
         (funcall helpful-switch-buffer-function buf)))
 
     (defun za/helpful-previous ()
       "Go to the previous Helpful buffer."
       (interactive)
       (when-let (buf (za/helpful--previous))
         (funcall helpful-switch-buffer-function buf))))
 #+end_src
 ** Tex-mode
 #+begin_src emacs-lisp
   (use-package tex-mode
     :ensure nil ; installed with Emacs
     :hook (tex-mode . za/settings-on-tex-mode)
     :config
     (defun za/settings-on-tex-mode ()
       "Settings on enabling helpful mode"
       (setq comment-add 0)))
 #+end_src
 ** Quail
 #+begin_src emacs-lisp
   (use-package quail
     :ensure nil) ; provided by Emacs
 #+end_src
 ** Markdown
 #+begin_src emacs-lisp
   (use-package markdown-mode)
 #+end_src
 ** vdirel (contacts)
 #+begin_src emacs-lisp
   (use-package vdirel
     :config
     (vdirel-switch-repository "~/.local/share/contacts/default"))
 #+end_src
 ** Yaml
 #+begin_src emacs-lisp
   (use-package yaml-mode
     :commands yaml-mode
     :init
     (add-hook 'yaml-mode-hook
               (lambda ()
                 (setq-local outline-regexp (rx (* blank)))
                 (outline-minor-mode))))
 #+end_src
 ** calc
 #+begin_src emacs-lisp
   (use-package calc
     :config
     (setq math-additional-units
      ;; elements:
      ;; - symbol identifying the unit,
      ;; - expression indicatingv alue of unit or nil for fundamental units
      ;; - textual description
      '((b nil "Bit")
        (B "b * 8" "Bytes")
        (KiB "1024 * B" "Kibibyte")
        (MiB "1024 * KiB" "Mebibyte")
        (GiB "1024 * MiB" "Gibibyte")
        (TiB "1024 * GiB" "Tebibyte")
        (PiB "1024 * TiB" "Pebibyte")
        (EiB "1024 * PiB" "Exbibyte")
        (ZiB "1024 * EiB" "Zebibyte")
        (YiB "1024 * ZiB" "Yobibyte")
        (KB "1000 * B" "Kilobyte")
        (MB "1000 * KB" "Megabyte")
        (GB "1000 * MB" "Gigabyte")
        (TB "1000 * GB" "Terabyte")
        (PB "1000 * TB" "Petabyte")
        (EB "1000 * PB" "Exabyte")
        (ZB "1000 * EB" "Zettabyte")
        (YB "1000 * ZB" "Yottabyte")
        (Kib "1024 * b" "Kibibit")
        (Mib "1024 * Kib" "Mebibit")
        (Gib "1024 * Mib" "Gibibit")
        (Kb "1000 * b" "Kilobit")
        (Mb "1000 * Kb" "Megabit")
        (Gb "1000 * Mb" "Gigabit")))
     (setq math-units-table nil))
 #+end_src
 ** casual
 #+begin_src emacs-lisp
   (use-package casual
     :config
     (require 'casual-image)
     :bind (:map calc-mode-map
            ("C-o" . 'casual-calc-tmenu)
            :map dired-mode-map
            ("C-o" . 'casual-dired-tmenu)
            ("C-u C-o" . 'dired-display-file)
            :map calendar-mode-map
            ("C-o" . 'casual-calendar-tmenu)
            :map image-mode-map
            ("C-o" . 'casual-image-tmenu)))
 #+end_src
 ** json
 #+begin_src emacs-lisp
   (use-package json-mode)
 #+end_src
 ** rust
 #+begin_src emacs-lisp
   (use-package rust-mode)
 #+end_src
 ** artist mode
 #+begin_src emacs-lisp
   (use-package artist
     :ensure nil ; included with emacs
     :custom (artist-figlet-default-font "term"))
 #+end_src
 * Override some faces
 #+begin_src emacs-lisp
   (with-eval-after-load 'org-faces
     (set-face-attribute 'org-table nil :inherit 'fixed-pitch)
     (set-face-attribute 'org-block nil :inherit 'fixed-pitch))
 #+end_src
 * Shortdoc
 Set a better keybinding (I'm never gonna use ~view-hello-file~ anyways):
 
 #+begin_src emacs-lisp
   (bind-key "C-h h" #'shortdoc-display-group)
 #+end_src
 * Upcoming new features
 In a new version of use-package, I can use the :vc keyword, so check for when that's available.
 See [[https://git.savannah.gnu.org/cgit/emacs.git/commit/?id=2ce279680bf9c1964e98e2aa48a03d6675c386fe][commit]] and [[https://tony-zorman.com/posts/use-package-vc.html][article]].
 
 #+begin_src emacs-lisp
   (when (fboundp 'use-package-vc-install)
     (user-error "use-package :vc keyword now available!"))
 #+end_src
 * References
 Here's a list of good articles I encountered about configging emacs:
 - [[https://karthinks.com/software/batteries-included-with-emacs/][Batteries included with Emacs]]
 - [[https://karthinks.com/software/more-batteries-included-with-emacs/][More batteries included with emacs]]
 
 For Org mode, [[https://www.youtube.com/playlist?list=PLVtKhBrRV_ZkPnBtt_TD1Cs9PJlU0IIdE][Rainer König's tutorials]] are the best.
 [[https://emacs.cafe/emacs/orgmode/gtd/2017/06/30/orgmode-gtd.html][Here's a good reference for setting up gtd in org mode]]