[emacs] Update 2 drones
[~bandali/configs] / init.org
1 #+title: =aminb='s Literate Emacs Configuration
2 #+author: Amin Bandali
3 #+babel: :cache yes
4 #+property: header-args :tangle yes
5
6 * About
7 :PROPERTIES:
8 :CUSTOM_ID: about
9 :END:
10
11 This org file is my literate configuration for GNU Emacs, and is
12 tangled to [[./init.el][init.el]]. Packages are installed and managed using
13 [[https://github.com/emacscollective/borg][Borg]]. Over the years, I've taken inspiration from configurations of
14 many different people. Some of the configurations that I can remember
15 off the top of my head are:
16
17 - [[https://github.com/dieggsy/dotfiles][dieggsy/dotfiles]]: literate Emacs and dotfiles configuration, uses
18 straight.el for managing packages
19 - [[https://github.com/dakra/dmacs][dakra/dmacs]]: literate Emacs configuration, using Borg for managing
20 packages
21 - [[http://pages.sachachua.com/.emacs.d/Sacha.html][Sacha Chua's literate Emacs configuration]]
22 - [[https://github.com/dakrone/eos][dakrone/eos]]
23 - Ryan Rix's [[http://doc.rix.si/cce/cce.html][Complete Computing Environment]] ([[http://doc.rix.si/projects/fsem.html][about cce]])
24 - [[https://github.com/jwiegley/dot-emacs][jwiegley/dot-emacs]]: nix-based configuration
25 - [[https://github.com/wasamasa/dotemacs][wasamasa/dotemacs]]
26 - [[https://github.com/hlissner/doom-emacs][Doom Emacs]]
27
28 I'd like to have a fully reproducible Emacs setup (part of the reason
29 why I store my configuration in this repository) but unfortunately out
30 of the box, that's not achievable with =package.el=, not currently
31 anyway. So, I've opted to use Borg. For what it's worth, I briefly
32 experimented with [[https://github.com/raxod502/straight.el][straight.el]], but found that it added about 2 seconds
33 to my init time; which is unacceptable for me: I use Emacs as my
34 window manager (via EXWM) and coming from bspwm, I'm too used to
35 having fast startup times.
36
37 ** Installation
38
39 To use this config for your Emacs, first you need to clone this repo,
40 then bootstrap Borg, tell Borg to retrieve package submodules, and
41 byte-compiled the packages. Something along these lines should work:
42
43 #+begin_src sh :tangle no
44 git clone https://github.com/aminb/dotfiles ~/.emacs.d
45 cd ~/.emacs.d
46 make bootstrap-borg
47 make bootstrap
48 make build
49 #+end_src
50
51 * Contents :toc_1:noexport:
52
53 - [[#about][About]]
54 - [[#header][Header]]
55 - [[#initial-setup][Initial setup]]
56 - [[#core][Core]]
57 - [[#post-initialization][Post initialization]]
58 - [[#footer][Footer]]
59
60 * Header
61 :PROPERTIES:
62 :CUSTOM_ID: header
63 :END:
64
65 ** First line
66
67 #+begin_src emacs-lisp :comments none
68 ;;; init.el --- Amin Bandali's Emacs config -*- lexical-binding: t ; eval: (view-mode 1)-*-
69 #+end_src
70
71 Enable =view-mode=, which both makes the file read-only (as a reminder
72 that =init.el= is an auto-generated file, not supposed to be edited),
73 and provides some convenient key bindings for browsing through the
74 file.
75
76 ** License
77
78 #+begin_src emacs-lisp :comments none
79 ;; Copyright (C) 2018 Amin Bandali <bandali@gnu.org>
80
81 ;; This program is free software: you can redistribute it and/or modify
82 ;; it under the terms of the GNU General Public License as published by
83 ;; the Free Software Foundation, either version 3 of the License, or
84 ;; (at your option) any later version.
85
86 ;; This program is distributed in the hope that it will be useful,
87 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
88 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
89 ;; GNU General Public License for more details.
90
91 ;; You should have received a copy of the GNU General Public License
92 ;; along with this program. If not, see <https://www.gnu.org/licenses/>.
93 #+end_src
94
95 ** Commentary
96
97 #+begin_src emacs-lisp :comments none
98 ;;; Commentary:
99
100 ;; Emacs configuration of Amin Bandali, computer scientist and functional
101 ;; programmer.
102
103 ;; THIS FILE IS AUTO-GENERATED FROM `init.org'.
104 #+end_src
105
106 ** Naming conventions
107
108 The conventions below were inspired by [[https://github.com/hlissner/doom-emacs][Doom]]'s, found [[https://github.com/hlissner/doom-emacs/blob/5dacbb7cb1c6ac246a9ccd15e6c4290def67757c/core/core.el#L3-L17][here]].
109
110 #+begin_src emacs-lisp :comments none
111 ;; Naming conventions:
112 ;;
113 ;; amin-... public variables or non-interactive functions
114 ;; amin--... private anything (non-interactive), not safe for direct use
115 ;; amin/... an interactive function; safe for M-x or keybinding
116 ;; amin:... an evil operator, motion, or command
117 ;; amin|... a hook function
118 ;; amin*... an advising function
119 ;; amin@... a hydra command
120 ;; ...! a macro
121 #+end_src
122
123 * Initial setup
124 :PROPERTIES:
125 :CUSTOM_ID: initial-setup
126 :END:
127
128 #+begin_src emacs-lisp :comments none
129 ;;; Code:
130 #+end_src
131
132 ** Emacs initialization
133
134 I'd like to do a couple of measurements of Emacs' startup time. First,
135 let's see how long Emacs takes to start up, before even loading
136 =init.el=, i.e. =user-init-file=:
137
138 #+begin_src emacs-lisp
139 (defvar amin--before-user-init-time (current-time)
140 "Value of `current-time' when Emacs begins loading `user-init-file'.")
141 (message "Loading Emacs...done (%.3fs)"
142 (float-time (time-subtract amin--before-user-init-time
143 before-init-time)))
144 #+end_src
145
146 Also, temporarily increase ~gc-cons-threshhold~ and
147 ~gc-cons-percentage~ during startup to reduce garbage collection
148 frequency. Clearing the ~file-name-handler-alist~ seems to help reduce
149 startup time as well.
150
151 #+begin_src emacs-lisp
152 (defvar amin--gc-cons-threshold gc-cons-threshold)
153 (defvar amin--gc-cons-percentage gc-cons-percentage)
154 (defvar amin--file-name-handler-alist file-name-handler-alist)
155 (setq gc-cons-threshold (* 400 1024 1024) ; 400 MiB
156 gc-cons-percentage 0.6
157 file-name-handler-alist nil
158 ;; sidesteps a bug when profiling with esup
159 esup-child-profile-require-level 0)
160 #+end_src
161
162 Of course, we'd like to set them back to their defaults once we're
163 done initializing.
164
165 #+begin_src emacs-lisp
166 (add-hook
167 'after-init-hook
168 (lambda ()
169 (setq gc-cons-threshold amin--gc-cons-threshold
170 gc-cons-percentage amin--gc-cons-percentage
171 file-name-handler-alist amin--file-name-handler-alist)))
172 #+end_src
173
174 Increase the number of lines kept in message logs (the =*Messages*=
175 buffer).
176
177 #+begin_src emacs-lisp
178 (setq message-log-max 20000)
179 #+end_src
180
181 Optionally, we could suppress some byte compiler warnings like below,
182 but for now I've decided to keep them enabled. See documentation for
183 ~byte-compile-warnings~ for more details.
184
185 #+begin_src emacs-lisp
186 ;; (setq byte-compile-warnings
187 ;; '(not free-vars unresolved noruntime lexical make-local))
188 #+end_src
189
190 ** whoami
191
192 #+begin_src emacs-lisp
193 (setq user-full-name "Amin Bandali"
194 user-mail-address "amin@aminb.org")
195 #+end_src
196
197 ** Package management
198
199 *** No =package.el=
200
201 I can do all my package management things with Borg, and don't need
202 Emacs' built-in =package.el=. Emacs 27 lets us disable =package.el= in
203 the =early-init-file= (see [[https://git.savannah.gnu.org/cgit/emacs.git/commit/?id=24acb31c04b4048b85311d794e600ecd7ce60d3b][here]]).
204
205 #+begin_src emacs-lisp :tangle early-init.el
206 (setq package-enable-at-startup nil)
207 #+end_src
208
209 But since Emacs 27 isn't out yet (Emacs 26 is just around the corner
210 right now), and even when released it'll be long before most distros
211 ship in their repos, I'll still put the old workaround with the
212 commented call to ~package-initialize~ here anyway.
213
214 #+begin_src emacs-lisp
215 (setq package-enable-at-startup nil)
216 ;; (package-initialize)
217 #+end_src
218
219 *** Borg
220
221 #+begin_quote
222 Assimilate Emacs packages as Git submodules
223 #+end_quote
224
225 [[https://github.com/emacscollective/borg][Borg]] is at the heart of package management of my Emacs setup. In
226 short, it creates a git submodule in =lib/= for each package, which
227 can then be managed with the help of Magit or other tools.
228
229 #+begin_src emacs-lisp
230 (setq user-init-file (or load-file-name buffer-file-name)
231 user-emacs-directory (file-name-directory user-init-file))
232 (add-to-list 'load-path
233 (expand-file-name "lib/borg" user-emacs-directory))
234 (require 'borg)
235 (borg-initialize)
236
237 ;; (require 'borg-nix-shell)
238 ;; (setq borg-build-shell-command 'borg-nix-shell-build-command)
239
240 (with-eval-after-load 'bind-key
241 (bind-keys
242 :package borg
243 ("C-c b A" . borg-activate)
244 ("C-c b a" . borg-assimilate)
245 ("C-c b b" . borg-build)
246 ("C-c b c" . borg-clone)
247 ("C-c b r" . borg-remove)))
248 #+end_src
249
250 *** =use-package=
251
252 #+begin_quote
253 A use-package declaration for simplifying your .emacs
254 #+end_quote
255
256 [[https://github.com/jwiegley/use-package][use-package]] is an awesome utility for managing and configuring
257 packages (in our case especially the latter) in a neatly organized way
258 and without compromising on performance.
259
260 #+begin_src emacs-lisp
261 (require 'use-package)
262 (if nil ; set to t when need to debug init
263 (setq use-package-verbose t
264 use-package-expand-minimally nil
265 use-package-compute-statistics t
266 debug-on-error t)
267 (setq use-package-verbose nil
268 use-package-expand-minimally t))
269 #+end_src
270
271 *** Epkg
272
273 #+begin_quote
274 Browse the Emacsmirror package database
275 #+end_quote
276
277 Epkg provides access to a local copy of the [[https://emacsmirror.net][Emacsmirror]] package
278 database, low-level functions for querying the database, and a
279 =package.el=-like user interface for browsing the available packages.
280
281 #+begin_src emacs-lisp
282 (use-package epkg
283 :defer t
284 :bind
285 (("C-c b d" . epkg-describe-package)
286 ("C-c b p" . epkg-list-packages)
287 ("C-c b u" . epkg-update)))
288 #+end_src
289
290 ** No littering in =~/.emacs.d=
291
292 #+begin_quote
293 Help keeping ~/.emacs.d clean
294 #+end_quote
295
296 By default, even for Emacs' built-in packages, the configuration files
297 and persistent data are all over the place. Use =no-littering= to help
298 contain the mess.
299
300 #+begin_src emacs-lisp
301 (use-package no-littering
302 :demand t
303 :config
304 (savehist-mode 1)
305 (add-to-list 'savehist-additional-variables 'kill-ring)
306 (save-place-mode 1)
307 (setq auto-save-file-name-transforms
308 `((".*" ,(no-littering-expand-var-file-name "auto-save/") t))))
309 #+end_src
310
311 ** Custom file (=custom.el=)
312
313 I'm not planning on using the custom file much, but even so, I
314 definitely don't want it mixing with =init.el=. So, here; let's give
315 it it's own file. While at it, treat themes as safe.
316
317 #+begin_src emacs-lisp
318 (use-package custom
319 :no-require t
320 :config
321 (setq custom-file (no-littering-expand-etc-file-name "custom.el"))
322 (when (file-exists-p custom-file)
323 (load custom-file))
324 (setf custom-safe-themes t))
325 #+end_src
326
327 ** Secrets file
328
329 Load the secrets file if it exists, otherwise show a warning.
330
331 #+begin_src emacs-lisp
332 (with-demoted-errors
333 (load (no-littering-expand-etc-file-name "secrets")))
334 #+end_src
335
336 ** Better =$PATH= handling
337
338 Let's use [[https://github.com/purcell/exec-path-from-shell][exec-path-from-shell]] to make Emacs use the =$PATH= as set up
339 in my shell.
340
341 #+begin_src emacs-lisp
342 (use-package exec-path-from-shell
343 :defer 1
344 :init
345 (setq exec-path-from-shell-check-startup-files nil)
346 :config
347 (exec-path-from-shell-initialize)
348 ;; while we're at it, let's fix access to our running ssh-agent
349 (exec-path-from-shell-copy-env "SSH_AGENT_PID")
350 (exec-path-from-shell-copy-env "SSH_AUTH_SOCK"))
351 #+end_src
352
353 ** COMMENT Only one custom theme at a time
354
355 #+begin_src emacs-lisp
356 (defadvice load-theme (before clear-previous-themes activate)
357 "Clear existing theme settings instead of layering them"
358 (mapc #'disable-theme custom-enabled-themes))
359 #+end_src
360
361 ** Server
362
363 Start server if not already running. Alternatively, can be done by
364 issuing =emacs --daemon= in the terminal, which can be automated with
365 a systemd service or using =brew services start emacs= on macOS. I use
366 Emacs as my window manager (via EXWM), so I always start Emacs on
367 login; so starting the server from inside Emacs is good enough for me.
368
369 See [[https://www.gnu.org/software/emacs/manual/html_node/emacs/Emacs-Server.html#Emacs-Server][Using Emacs as a Server]].
370
371 #+begin_src emacs-lisp
372 (use-package server
373 :defer 1
374 :config (or (server-running-p) (server-mode)))
375 #+end_src
376
377 ** COMMENT Unicode support
378
379 Font stack with better unicode support, around =Ubuntu Mono= and
380 =Hack=.
381
382 #+begin_src emacs-lisp :tangle no
383 (dolist (ft (fontset-list))
384 (set-fontset-font
385 ft
386 'unicode
387 (font-spec :name "Source Code Pro" :size 14))
388 (set-fontset-font
389 ft
390 'unicode
391 (font-spec :name "DejaVu Sans Mono")
392 nil
393 'append)
394 ;; (set-fontset-font
395 ;; ft
396 ;; 'unicode
397 ;; (font-spec
398 ;; :name "Symbola monospacified for DejaVu Sans Mono")
399 ;; nil
400 ;; 'append)
401 ;; (set-fontset-font
402 ;; ft
403 ;; #x2115 ; ℕ
404 ;; (font-spec :name "DejaVu Sans Mono")
405 ;; nil
406 ;; 'append)
407 (set-fontset-font
408 ft
409 (cons ?Α ?ω)
410 (font-spec :name "DejaVu Sans Mono" :size 14)
411 nil
412 'prepend))
413 #+end_src
414
415 ** Gentler font resizing
416
417 #+begin_src emacs-lisp
418 (setq text-scale-mode-step 1.05)
419 #+end_src
420
421 ** Focus follows mouse
422
423 I’d like focus to follow the mouse when I move the cursor from one
424 window to the next.
425
426 #+begin_src emacs-lisp
427 (setq mouse-autoselect-window t)
428 #+end_src
429
430 Let’s define a function to conveniently disable this for certain
431 buffers and/or modes.
432
433 #+begin_src emacs-lisp
434 (defun amin--no-mouse-autoselect-window ()
435 (make-local-variable 'mouse-autoselect-window)
436 (setq mouse-autoselect-window nil))
437 #+end_src
438
439 ** Libraries
440
441 #+begin_src emacs-lisp
442 (require 'cl-lib)
443 (require 'subr-x)
444 #+end_src
445
446 ** Useful utilities
447
448 #+begin_src emacs-lisp
449 (defun amin-enlist (exp)
450 "Return EXP wrapped in a list, or as-is if already a list."
451 (if (listp exp) exp (list exp)))
452
453 ; from https://github.com/hlissner/doom-emacs/commit/589108fdb270f24a98ba6209f6955fe41530b3ef
454 (defmacro after! (features &rest body)
455 "A smart wrapper around `with-eval-after-load'. Supresses warnings during
456 compilation."
457 (declare (indent defun) (debug t))
458 (list (if (or (not (bound-and-true-p byte-compile-current-file))
459 (dolist (next (amin-enlist features))
460 (if (symbolp next)
461 (require next nil :no-error)
462 (load next :no-message :no-error))))
463 #'progn
464 #'with-no-warnings)
465 (cond ((symbolp features)
466 `(eval-after-load ',features '(progn ,@body)))
467 ((and (consp features)
468 (memq (car features) '(:or :any)))
469 `(progn
470 ,@(cl-loop for next in (cdr features)
471 collect `(after! ,next ,@body))))
472 ((and (consp features)
473 (memq (car features) '(:and :all)))
474 (dolist (next (cdr features))
475 (setq body `(after! ,next ,@body)))
476 body)
477 ((listp features)
478 `(after! (:all ,@features) ,@body)))))
479 #+end_src
480
481 Convenience macro for =setq='ing multiple variables to the same value:
482
483 #+begin_src emacs-lisp
484 (defmacro setq-every! (value &rest vars)
485 "Set all the variables from VARS to value VALUE."
486 (declare (indent defun) (debug t))
487 `(progn ,@(mapcar (lambda (x) (list 'setq x value)) vars)))
488 #+end_src
489
490 * Core
491 :PROPERTIES:
492 :CUSTOM_ID: core
493 :END:
494
495 ** Defaults
496
497 *** Time and battery in mode-line
498
499 Enable displaying time and battery in the mode-line, since I'm not
500 using the Xfce panel anymore. Also, I don't need to see the load
501 average on a regular basis, so disable that.
502
503 Note: using =i3status= on sway at the moment, so disabling this.
504
505 #+begin_src emacs-lisp :tangle no
506 (use-package time
507 :init
508 (setq display-time-default-load-average nil)
509 :config
510 (display-time-mode))
511
512 (use-package battery
513 :config
514 (display-battery-mode))
515 #+end_src
516
517 *** Smaller fringe
518
519 Might want to set the fringe to a smaller value, especially if using
520 EXWM. I'm fine with the default for now.
521
522 #+begin_src emacs-lisp
523 ;; (fringe-mode '(3 . 1))
524 (fringe-mode nil)
525 #+end_src
526
527 *** Disable disabled commands
528
529 Emacs disables some commands by default that could persumably be
530 confusing for novice users. Let's disable that.
531
532 #+begin_src emacs-lisp
533 (setq disabled-command-function nil)
534 #+end_src
535
536 *** Kill-ring
537
538 Save what I copy into clipboard from other applications into Emacs'
539 kill-ring, which would allow me to still be able to easily access it
540 in case I kill (cut or copy) something else inside Emacs before
541 yanking (pasting) what I'd originally intended to.
542
543 #+begin_src emacs-lisp
544 (setq save-interprogram-paste-before-kill t)
545 #+end_src
546
547 *** Minibuffer
548
549 #+begin_src emacs-lisp
550 (setq enable-recursive-minibuffers t
551 resize-mini-windows t)
552 #+end_src
553
554 *** Lazy-person-friendly yes/no prompts
555
556 Lazy people would prefer to type fewer keystrokes, especially for yes
557 or no questions. I'm lazy.
558
559 #+begin_src emacs-lisp
560 (defalias 'yes-or-no-p #'y-or-n-p)
561 #+end_src
562
563 *** Startup screen and =*scratch*=
564
565 Firstly, let Emacs know that I'd like to have =*scratch*= as my
566 startup buffer.
567
568 #+begin_src emacs-lisp
569 (setq initial-buffer-choice t)
570 #+end_src
571
572 Now let's customize the =*scratch*= buffer a bit. First off, I don't
573 need the default hint.
574
575 #+begin_src emacs-lisp
576 (setq initial-scratch-message nil)
577 #+end_src
578
579 Also, let's use Text mode as the major mode, in case I want to
580 customize it (=*scratch*='s default major mode, Fundamental mode,
581 can't really be customized).
582
583 #+begin_src emacs-lisp
584 (setq initial-major-mode 'text-mode)
585 #+end_src
586
587 Inhibit the buffer list when more than 2 files are loaded.
588
589 #+begin_src emacs-lisp
590 (setq inhibit-startup-buffer-menu t)
591 #+end_src
592
593 I don't really need to see the startup screen or echo area message
594 either.
595
596 #+begin_src emacs-lisp
597 (advice-add #'display-startup-echo-area-message :override #'ignore)
598 (setq inhibit-startup-screen t
599 inhibit-startup-echo-area-message user-login-name)
600 #+end_src
601
602 *** More useful frame titles
603
604 Show either the file name or the buffer name (in case the buffer isn't
605 visiting a file). Borrowed from Emacs Prelude.
606
607 #+begin_src emacs-lisp
608 (setq frame-title-format
609 '("" invocation-name " - "
610 (:eval (if (buffer-file-name)
611 (abbreviate-file-name (buffer-file-name))
612 "%b"))))
613 #+end_src
614
615 *** Backups
616
617 Emacs' default backup settings aren't that great. Let's use more
618 sensible options. See documentation for the ~make-backup-file~
619 variable.
620
621 #+begin_src emacs-lisp
622 (setq backup-by-copying t
623 version-control t
624 delete-old-versions t)
625 #+end_src
626
627 *** Auto revert
628
629 Enable automatic reloading of changed buffers and files.
630
631 #+begin_src emacs-lisp
632 (global-auto-revert-mode 1)
633 (setq auto-revert-verbose nil
634 global-auto-revert-non-file-buffers nil)
635 #+end_src
636
637 *** Always use space for indentation
638
639 #+begin_src emacs-lisp
640 (setq-default
641 indent-tabs-mode nil
642 require-final-newline t
643 tab-width 4)
644 #+end_src
645
646 *** Winner mode
647
648 Enable =winner-mode=.
649
650 #+begin_src emacs-lisp
651 (winner-mode 1)
652 #+end_src
653
654 *** Close =*compilation*= on success
655
656 #+begin_src emacs-lisp
657 (setq compilation-exit-message-function
658 (lambda (status code msg)
659 "Close the compilation window if successful."
660 ;; if M-x compile exits with 0
661 (when (and (eq status 'exit) (zerop code))
662 (bury-buffer)
663 (delete-window (get-buffer-window (get-buffer "*compilation*"))))
664 ;; return the result of compilation-exit-message-function
665 (cons msg code)))
666 #+end_src
667
668 *** Search for non-ASCII characters
669
670 I’d like non-ASCII characters such as ‘’“”«»‹›áⓐ𝒶 to be selected when
671 I search for their ASCII counterpart. Shoutout to [[http://endlessparentheses.com/new-in-emacs-25-1-easily-search-non-ascii-characters.html][endlessparentheses]]
672 for this.
673
674 #+begin_src emacs-lisp
675 (setq search-default-mode #'char-fold-to-regexp)
676
677 ;; uncomment to extend this behaviour to query-replace
678 ;; (setq replace-char-fold t)
679 #+end_src
680
681 ** Bindings
682
683 #+begin_src emacs-lisp
684 (bind-keys
685 ("s-c e b" . eval-buffer)
686 ("s-c e r" . eval-region)
687
688 ("s-p" . beginning-of-buffer)
689 ("s-n" . end-of-buffer))
690 #+end_src
691
692 ** Packages
693
694 The packages in this section are absolutely essential to my everyday
695 workflow, and they play key roles in how I do my computing. They
696 immensely enhance the Emacs experience for me; both using Emacs, and
697 customizing it.
698
699 *** [[https://github.com/emacscollective/auto-compile][auto-compile]]
700
701 #+begin_src emacs-lisp
702 (use-package auto-compile
703 :demand t
704 :config
705 (auto-compile-on-load-mode)
706 (auto-compile-on-save-mode)
707 (setq auto-compile-display-buffer nil
708 auto-compile-mode-line-counter t
709 auto-compile-source-recreate-deletes-dest t
710 auto-compile-toggle-deletes-nonlib-dest t
711 auto-compile-update-autoloads t)
712 (add-hook 'auto-compile-inhibit-compile-hook
713 'auto-compile-inhibit-compile-detached-git-head))
714 #+end_src
715
716 *** [[https://github.com/noctuid/general.el][general]]
717
718 #+begin_src emacs-lisp
719 (use-package general
720 :demand t
721 :config
722 (general-evil-setup t)
723 (general-override-mode)
724
725 (general-create-definer
726 amin--leader-keys
727 :keymaps 'override
728 :states '(emacs normal visual motion insert)
729 :non-normal-prefix "M-m"
730 :prefix "SPC"))
731 #+end_src
732
733 *** [[https://github.com/emacs-evil/evil][evil]]
734
735 #+begin_src emacs-lisp
736 (use-package evil
737 :demand t
738 ;; :hook (org-src-mode . evil-motion-state)
739 :config
740 (evil-mode 1)
741 (general-swap-key nil '(normal motion) ";" ":")
742
743 (setq evil-want-visual-char-semi-exclusive t
744 evil-cross-lines t)
745
746 ;; custom mode state mappings
747 (dolist (mspair '((ebdb-mode . emacs)
748 (term-mode . emacs)
749 (helpful-mode . motion)
750 (magit-blame-mode . motion)
751 (view-mode . motion)))
752 (evil-set-initial-state (car mspair) (cdr mspair)))
753
754 ;; fix tab and indentation in src blocks inside org-mode buffer
755 ;; also see https://git.sr.ht/~bandali/dotfiles/commit/0e2ffd584aafdd4cf256bcdf2473f01c3aaaed55
756 (unbind-key "TAB" evil-motion-state-map)
757
758 (unbind-key "C-d" evil-insert-state-map)
759 (unbind-key "C-v" evil-insert-state-map)
760 (unbind-key "C-y" evil-insert-state-map)
761 (unbind-key "C-a" evil-insert-state-map)
762 (unbind-key "C-e" evil-insert-state-map)
763 (unbind-key "C-p" evil-insert-state-map)
764 (unbind-key "C-n" evil-insert-state-map)
765 (unbind-key "C-k" evil-insert-state-map)
766 (bind-keys
767 :map evil-insert-state-map
768 ("C-k" . kill-line)
769 ("C-S-k" . evil-insert-digraph)
770 :map evil-motion-state-map
771 ([down-mouse-1] . nil)))
772 #+end_src
773
774 #+begin_src emacs-lisp
775 (use-package evil-escape
776 :after evil
777 :init
778 (setq evil-escape-excluded-states '(normal visual multiedit emacs motion)
779 evil-escape-excluded-major-modes '(neotree-mode)
780 evil-escape-key-sequence "jk"
781 evil-escape-delay 0.25)
782 ;; :general
783 ;; (:states '(insert replace visual operator)
784 ;; "C-g" #'evil-escape)
785 :config
786 (evil-escape-mode 1)
787 ;; no `evil-escape' in minibuffer
788 (push #'minibufferp evil-escape-inhibit-functions))
789 #+end_src
790
791 #+begin_src emacs-lisp
792 (use-package evil-nerd-commenter
793 :after evil
794 :general
795 (nmap
796 "gc" 'evilnc-comment-operator
797 "gy" 'evilnc-copy-and-comment-lines))
798 #+end_src
799
800 #+begin_src emacs-lisp
801 (use-package evil-surround
802 :after evil
803 :general
804 (omap
805 "s" 'evil-surround-edit
806 "S" 'evil-Surround-edit)
807 (vmap
808 "S" 'evil-surround-region
809 "gS" 'evil-Surround-region))
810 #+end_src
811
812 #+begin_src emacs-lisp
813 (amin--leader-keys
814 "/" '(:ignore t :wk "search")
815
816 "a" '(:ignore t :wk "apps")
817 "a i" 'ielm
818
819 "a s" '(:ignore t :wk "shells/terms")
820
821 "b" '(:ignore t :wk "buffers")
822 "b k" 'kill-this-buffer
823 "b s" 'save-buffer
824
825 "e" '(:ignore t :wk "eval")
826 "e b" 'eval-buffer
827 "e r" 'eval-region
828
829 "f" '(:ignore t :wk "files")
830
831 "F" '(:ignore t :wk "frames")
832 "F m" 'make-frame-command
833 "F d" 'delete-frame
834 "F D" 'delete-other-frames
835
836 "h" '(:ignore t :wk "help(ful)")
837 "h c" 'describe-char
838 "h f" 'describe-function
839 "h F" 'describe-face
840 "h H" 'view-hello-file
841 "h i" 'info
842 "h k" 'describe-key
843 "h l" 'view-lossage
844 "h v" 'describe-variable
845
846 "o" 'other-window
847
848 "w" '(:ignore t :wk "window")
849 "w o" 'other-window
850 "w 0" 'delete-window
851 "w 1" 'delete-other-windows
852 "w 2" 'split-window-below
853 "w 3" 'split-window-right
854 "w u" 'winner-undo
855 "w r" 'winner-redo
856
857 "q" '(:ignore t :wk "quit")
858 "q q" 'save-buffers-kill-terminal)
859 #+end_src
860
861 *** [[https://orgmode.org/][Org mode]]
862
863 #+begin_quote
864 Org mode is for keeping notes, maintaining TODO lists, planning
865 projects, and authoring documents with a fast and effective plain-text
866 system.
867 #+end_quote
868
869 In short, my favourite way of life.
870
871 #+begin_src emacs-lisp
872 (use-package org
873 :defer 1
874 :general
875 (amin--leader-keys
876 :states 'normal
877 :keymaps 'org-mode-map
878 "'" 'org-edit-special)
879 (amin--leader-keys
880 :definer 'minor-mode
881 :states 'normal
882 :keymaps 'org-src-mode
883 "'" 'org-edit-src-exit
884 "k" 'org-edit-src-abort)
885 (general-define-key
886 :definer 'minor-mode
887 :states 'normal
888 :keymaps 'org-src-mode
889 "q" 'org-edit-src-exit)
890 :config
891 (setq org-src-tab-acts-natively t
892 org-src-preserve-indentation nil
893 org-edit-src-content-indentation 0
894 org-email-link-description-format "Email %c: %s" ; %.30s
895 org-highlight-latex-and-related '(entities)
896 org-log-done 'time)
897 (add-to-list 'org-structure-template-alist '("L" . "src emacs-lisp") t)
898 (after! org-src
899 (define-key org-src-mode-map [remap evil-write] 'org-edit-src-save)
900 (define-key org-src-mode-map [remap evil-save-and-close]
901 (lambda () (interactive)
902 (org-edit-src-save)
903 (org-edit-src-exit)))
904 (define-key org-src-mode-map [remap evil-save-modified-and-close]
905 (lambda () (interactive)
906 (org-edit-src-save)
907 (org-edit-src-exit)))
908 (define-key org-src-mode-map [remap evil-quit] 'org-edit-src-abort))
909 (font-lock-add-keywords
910 'org-mode
911 '(("[ \t]*\\(#\\+\\(BEGIN\\|END\\|begin\\|end\\)_\\(\\S-+\\)\\)[ \t]*\\([^\n:]*\\)"
912 (1 '(:foreground "#5a5b5a" :background "#292b2b") t) ; directive
913 (3 '(:foreground "#81a2be" :background "#292b2b") t) ; kind
914 (4 '(:foreground "#c5c8c6") t))) ; title
915 t)
916 :bind (:map org-mode-map ("M-L" . org-insert-last-stored-link))
917 :hook ((org-mode . org-indent-mode)
918 (org-mode . auto-fill-mode)
919 (org-mode . flyspell-mode))
920 :custom
921 (org-latex-packages-alist '(("" "listings") ("" "color")))
922 :custom-face
923 '(org-block-begin-line ((t (:foreground "#5a5b5a" :background "#1d1f21"))))
924 '(org-block ((t (:background "#1d1f21"))))
925 '(org-latex-and-related ((t (:foreground "#b294bb")))))
926
927 (use-package ox-latex
928 :after ox
929 :config
930 (setq org-latex-listings 'listings
931 ;; org-latex-prefer-user-labels t
932 )
933 (add-to-list 'org-latex-packages-alist '("" "listings"))
934 (add-to-list 'org-latex-packages-alist '("" "color"))
935 (add-to-list 'org-latex-classes
936 '("IEEEtran" "\\documentclass[11pt]{IEEEtran}"
937 ("\\section{%s}" . "\\section*{%s}")
938 ("\\subsection{%s}" . "\\subsection*{%s}")
939 ("\\subsubsection{%s}" . "\\subsubsection*{%s}")
940 ("\\paragraph{%s}" . "\\paragraph*{%s}")
941 ("\\subparagraph{%s}" . "\\subparagraph*{%s}"))
942 t))
943
944 (use-package ox-beamer
945 :after ox)
946
947 (use-package ob-tangle
948 :general
949 (amin--leader-keys
950 :states 'normal
951 :keymaps 'org-mode-map
952 "b t" 'org-babel-tangle))
953
954 (use-package orgalist
955 :after message
956 :hook (message-mode . orgalist-mode))
957 #+end_src
958
959 **** asynchronous tangle
960
961 =amin/async-babel-tangle= is a function closely inspired by [[https://github.com/dieggsy/dotfiles/tree/cc10edf7701958eff1cd94d4081da544d882a28c/emacs.d#dotfiles][dieggsy's
962 d/async-babel-tangle]] which uses [[https://github.com/jwiegley/emacs-async][async]] to asynchronously tangle an org
963 file.
964
965 #+begin_src emacs-lisp
966 (after! org
967 (defvar amin-show-async-tangle-results nil
968 "Keep *emacs* async buffers around for later inspection.")
969
970 (defvar amin-show-async-tangle-time nil
971 "Show the time spent tangling the file.")
972
973 (defvar amin-async-tangle-post-compile "make ti"
974 "If non-nil, pass to `compile' after successful tangle.")
975
976 (defun amin/async-babel-tangle ()
977 "Tangle org file asynchronously."
978 (interactive)
979 (let* ((file-tangle-start-time (current-time))
980 (file (buffer-file-name))
981 (file-nodir (file-name-nondirectory file))
982 (async-quiet-switch "-q"))
983 (async-start
984 `(lambda ()
985 (require 'org)
986 (org-babel-tangle-file ,file))
987 (unless amin-show-async-tangle-results
988 `(lambda (result)
989 (if result
990 (progn
991 (message "Tangled %s%s"
992 ,file-nodir
993 (if amin-show-async-tangle-time
994 (format " (%.3fs)"
995 (float-time (time-subtract (current-time)
996 ',file-tangle-start-time)))
997 ""))
998 (when amin-async-tangle-post-compile
999 (compile amin-async-tangle-post-compile)))
1000 (message "Tangling %s failed" ,file-nodir))))))))
1001
1002 (add-to-list
1003 'safe-local-variable-values
1004 '(eval add-hook 'after-save-hook #'amin/async-babel-tangle 'append 'local))
1005 #+end_src
1006
1007 *** [[https://magit.vc/][Magit]]
1008
1009 #+begin_quote
1010 It's Magit! A Git porcelain inside Emacs.
1011 #+end_quote
1012
1013 Not just how I do git, but /the/ way to do git.
1014
1015 #+begin_src emacs-lisp
1016 (use-package magit
1017 :defer 1
1018 :general
1019 (amin--leader-keys
1020 "g s" 'magit-status
1021 "g l" 'magit-log-buffer-file)
1022 :bind ("s-g" . magit-status)
1023 :config
1024 (magit-add-section-hook 'magit-status-sections-hook
1025 'magit-insert-modules
1026 'magit-insert-stashes
1027 'append)
1028 (setq
1029 magit-repository-directories '(("~/.emacs.d/" . 0)
1030 ("~/src/git/" . 1)))
1031 (nconc magit-section-initial-visibility-alist
1032 '(([unpulled status] . show)
1033 ([unpushed status] . show)))
1034 :custom-face (magit-diff-file-heading ((t (:weight normal)))))
1035 #+end_src
1036
1037 *** [[https://github.com/abo-abo/swiper][Ivy]] (and friends)
1038
1039 #+begin_quote
1040 Ivy - a generic completion frontend for Emacs, Swiper - isearch with
1041 an overview, and more. Oh, man!
1042 #+end_quote
1043
1044 There's no way I could top that, so I won't attempt to.
1045
1046 **** Ivy
1047
1048 #+begin_src emacs-lisp
1049 (use-package ivy
1050 :defer 1
1051 :general (amin--leader-keys "," 'ivy-switch-buffer)
1052 :bind
1053 (:map ivy-minibuffer-map
1054 ([escape] . keyboard-escape-quit)
1055 ([S-up] . ivy-previous-history-element)
1056 ([S-down] . ivy-next-history-element)
1057 ("DEL" . ivy-backward-delete-char))
1058 :config
1059 (setq ivy-wrap t)
1060 (ivy-mode 1)
1061 ;; :custom-face
1062 ;; (ivy-minibuffer-match-face-2 ((t (:background "#e99ce8" :weight semi-bold))))
1063 ;; (ivy-minibuffer-match-face-3 ((t (:background "#bbbbff" :weight semi-bold))))
1064 ;; (ivy-minibuffer-match-face-4 ((t (:background "#ffbbff" :weight semi-bold))))
1065 )
1066 #+end_src
1067
1068 **** Swiper
1069
1070 #+begin_src emacs-lisp
1071 (use-package swiper
1072 :general (:states '(normal motion) "/" 'swiper)
1073 :bind (("C-s" . swiper)
1074 ("C-r" . swiper)))
1075 #+end_src
1076
1077 **** Counsel
1078
1079 #+begin_src emacs-lisp
1080 (use-package counsel
1081 :defer 1
1082 :general
1083 (amin--leader-keys
1084 "r" 'counsel-recentf
1085 "SPC" 'counsel-M-x
1086 "." 'counsel-find-file)
1087 :bind (([remap execute-extended-command] . counsel-M-x)
1088 ([remap find-file] . counsel-find-file)
1089 ("s-r" . counsel-recentf)
1090 ("C-c x" . counsel-M-x)
1091 ("C-c f ." . counsel-find-file)
1092 :map minibuffer-local-map
1093 ("C-r" . counsel-minibuffer-history))
1094 :config
1095 (counsel-mode 1)
1096 (defalias 'locate #'counsel-locate))
1097 #+end_src
1098
1099 *** eshell
1100
1101 #+begin_src emacs-lisp
1102 (use-package eshell
1103 :defer 1
1104 :commands eshell
1105 :config
1106 (eval-when-compile (defvar eshell-prompt-regexp))
1107 (defun amin/eshell-quit-or-delete-char (arg)
1108 (interactive "p")
1109 (if (and (eolp) (looking-back eshell-prompt-regexp nil))
1110 (eshell-life-is-too-much)
1111 (delete-char arg)))
1112
1113 (defun amin/eshell-clear ()
1114 (interactive)
1115 (let ((inhibit-read-only t))
1116 (erase-buffer))
1117 (eshell-send-input))
1118
1119 (defun amin|eshell-setup ()
1120 (make-local-variable 'company-idle-delay)
1121 (setq company-idle-delay nil)
1122 (bind-keys :map eshell-mode-map
1123 ("C-d" . amin/eshell-quit-or-delete-char)
1124 ("C-S-l" . amin/eshell-clear)
1125 ("M-r" . counsel-esh-history)
1126 ([tab] . company-complete)))
1127
1128 :hook (eshell-mode . amin|eshell-setup)
1129 :custom
1130 (eshell-hist-ignoredups t)
1131 (eshell-input-filter 'eshell-input-filter-initial-space))
1132 #+end_src
1133
1134 *** Ibuffer
1135
1136 #+begin_src emacs-lisp
1137 (use-package ibuffer
1138 :defer t
1139 :general (amin--leader-keys "b b" 'ibuffer-other-window)
1140 :bind
1141 (("C-x C-b" . ibuffer-other-window)
1142 :map ibuffer-mode-map
1143 ("P" . ibuffer-backward-filter-group)
1144 ("N" . ibuffer-forward-filter-group)
1145 ("M-p" . ibuffer-do-print)
1146 ("M-n" . ibuffer-do-shell-command-pipe-replace))
1147 :config
1148 ;; Use human readable Size column instead of original one
1149 (define-ibuffer-column size-h
1150 (:name "Size" :inline t)
1151 (cond
1152 ((> (buffer-size) 1000000) (format "%7.1fM" (/ (buffer-size) 1000000.0)))
1153 ((> (buffer-size) 100000) (format "%7.0fk" (/ (buffer-size) 1000.0)))
1154 ((> (buffer-size) 1000) (format "%7.1fk" (/ (buffer-size) 1000.0)))
1155 (t (format "%8d" (buffer-size)))))
1156 :custom
1157 (ibuffer-saved-filter-groups
1158 '(("default"
1159 ("dired" (mode . dired-mode))
1160 ("org" (mode . org-mode))
1161 ("web"
1162 (or
1163 (mode . web-mode)
1164 (mode . css-mode)
1165 (mode . scss-mode)
1166 (mode . js2-mode)))
1167 ("shell"
1168 (or
1169 (mode . eshell-mode)
1170 (mode . shell-mode)))
1171 ("notmuch" (name . "\*notmuch\*"))
1172 ("programming"
1173 (or
1174 (mode . python-mode)
1175 (mode . c++-mode)
1176 (mode . emacs-lisp-mode)))
1177 ("emacs"
1178 (or
1179 (name . "^\\*scratch\\*$")
1180 (name . "^\\*Messages\\*$")))
1181 ("slack"
1182 (or
1183 (name . "^\\*Slack*"))))))
1184 (ibuffer-formats
1185 '((mark modified read-only locked " "
1186 (name 18 18 :left :elide)
1187 " "
1188 (size-h 9 -1 :right)
1189 " "
1190 (mode 16 16 :left :elide)
1191 " " filename-and-process)
1192 (mark " "
1193 (name 16 -1)
1194 " " filename)))
1195 :hook (ibuffer . (lambda () (ibuffer-switch-to-saved-filter-groups "default"))))
1196 #+end_src
1197
1198 *** Outline
1199
1200 #+begin_src emacs-lisp
1201 (use-package outline
1202 :defer t
1203 :hook (prog-mode . outline-minor-mode)
1204 :bind
1205 (:map
1206 outline-minor-mode-map
1207 ("<s-tab>" . outline-toggle-children)
1208 ("M-p" . outline-previous-visible-heading)
1209 ("M-n" . outline-next-visible-heading)
1210 :prefix-map amin--outline-prefix-map
1211 :prefix "s-o"
1212 ("TAB" . outline-toggle-children)
1213 ("a" . outline-hide-body)
1214 ("H" . outline-hide-body)
1215 ("S" . outline-show-all)
1216 ("h" . outline-hide-subtree)
1217 ("s" . outline-show-subtree)))
1218 #+end_src
1219
1220 * Borg's =layer/essentials=
1221
1222 TODO: break this giant source block down into individual org sections.
1223
1224 #+begin_src emacs-lisp
1225 (use-package dash
1226 :config (dash-enable-font-lock))
1227
1228 (use-package diff-hl
1229 :config
1230 (setq diff-hl-draw-borders nil)
1231 (global-diff-hl-mode)
1232 (add-hook 'magit-post-refresh-hook 'diff-hl-magit-post-refresh t))
1233
1234 (use-package dired
1235 :defer t
1236 :config (setq dired-listing-switches "-alh"))
1237
1238 (use-package eldoc
1239 :when (version< "25" emacs-version)
1240 :config (global-eldoc-mode))
1241
1242 (use-package help
1243 :defer t
1244 :config
1245 (temp-buffer-resize-mode)
1246 (setq help-window-select t))
1247
1248 (progn ; `isearch'
1249 (setq isearch-allow-scroll t))
1250
1251 (use-package lisp-mode
1252 :config
1253 (add-hook 'emacs-lisp-mode-hook 'outline-minor-mode)
1254 (add-hook 'emacs-lisp-mode-hook 'reveal-mode)
1255 (defun indent-spaces-mode ()
1256 (setq indent-tabs-mode nil))
1257 (add-hook 'lisp-interaction-mode-hook #'indent-spaces-mode))
1258
1259 (use-package man
1260 :defer t
1261 :config (setq Man-width 80))
1262
1263 (use-package paren
1264 :config (show-paren-mode))
1265
1266 (use-package prog-mode
1267 :config (global-prettify-symbols-mode)
1268 (defun indicate-buffer-boundaries-left ()
1269 (setq indicate-buffer-boundaries 'left))
1270 (add-hook 'prog-mode-hook #'indicate-buffer-boundaries-left))
1271
1272 (use-package recentf
1273 :defer 0.5
1274 :config
1275 (add-to-list 'recentf-exclude "^/\\(?:ssh\\|su\\|sudo\\)?:")
1276 (setq recentf-max-saved-items 40))
1277
1278 (use-package savehist
1279 :config (savehist-mode))
1280
1281 (use-package saveplace
1282 :when (version< "25" emacs-version)
1283 :config (save-place-mode))
1284
1285 (use-package simple
1286 :config (column-number-mode))
1287
1288 (progn ; `text-mode'
1289 (add-hook 'text-mode-hook #'indicate-buffer-boundaries-left)
1290 (add-hook 'text-mode-hook #'abbrev-mode))
1291
1292 (use-package tramp
1293 :defer t
1294 :config
1295 (add-to-list 'tramp-default-proxies-alist '(nil "\\`root\\'" "/ssh:%h:"))
1296 (add-to-list 'tramp-default-proxies-alist '("localhost" nil nil))
1297 (add-to-list 'tramp-default-proxies-alist
1298 (list (regexp-quote (system-name)) nil nil)))
1299
1300 (use-package undo-tree
1301 :config
1302 (global-undo-tree-mode -1))
1303 ;; :bind (("C-?" . undo-tree-undo)
1304 ;; ("M-_" . undo-tree-redo))
1305 ;; :config
1306 ;; (global-undo-tree-mode)
1307 ;; (setq undo-tree-mode-lighter ""
1308 ;; undo-tree-auto-save-history t))
1309 #+end_src
1310
1311 * Editing
1312
1313 ** Company
1314
1315 #+begin_src emacs-lisp
1316 (use-package company
1317 :defer 1
1318 :bind
1319 (:map company-active-map
1320 ([tab] . company-complete-common-or-cycle)
1321 ([escape] . company-abort))
1322 :custom
1323 (company-minimum-prefix-length 1)
1324 (company-selection-wrap-around t)
1325 (company-dabbrev-char-regexp "\\sw\\|\\s_\\|[-_]")
1326 (company-dabbrev-downcase nil)
1327 (company-dabbrev-ignore-case nil)
1328 :config
1329 (global-company-mode t))
1330 #+end_src
1331
1332 * Syntax and spell checking
1333 #+begin_src emacs-lisp
1334 (use-package flycheck
1335 :defer 3
1336 :hook (prog-mode . flycheck-mode)
1337 :bind
1338 (:map flycheck-mode-map
1339 ("M-P" . flycheck-previous-error)
1340 ("M-N" . flycheck-next-error))
1341 :config
1342 ;; Use the load-path from running Emacs when checking elisp files
1343 (setq flycheck-emacs-lisp-load-path 'inherit)
1344
1345 ;; Only flycheck when I actually save the buffer
1346 (setq flycheck-check-syntax-automatically '(mode-enabled save)))
1347
1348 ;; http://endlessparentheses.com/ispell-and-apostrophes.html
1349 (use-package ispell
1350 :defer 3
1351 :config
1352 ;; ’ can be part of a word
1353 (setq ispell-local-dictionary-alist
1354 `((nil "[[:alpha:]]" "[^[:alpha:]]"
1355 "['\x2019]" nil ("-B") nil utf-8)))
1356 ;; don't send ’ to the subprocess
1357 (defun endless/replace-apostrophe (args)
1358 (cons (replace-regexp-in-string
1359 "’" "'" (car args))
1360 (cdr args)))
1361 (advice-add #'ispell-send-string :filter-args
1362 #'endless/replace-apostrophe)
1363
1364 ;; convert ' back to ’ from the subprocess
1365 (defun endless/replace-quote (args)
1366 (if (not (derived-mode-p 'org-mode))
1367 args
1368 (cons (replace-regexp-in-string
1369 "'" "’" (car args))
1370 (cdr args))))
1371 (advice-add #'ispell-parse-output :filter-args
1372 #'endless/replace-quote))
1373 #+end_src
1374 * Programming modes
1375
1376 ** [[http://alloytools.org][Alloy]] (with [[https://github.com/dwwmmn/alloy-mode][alloy-mode]])
1377
1378 #+begin_src emacs-lisp
1379 (use-package alloy-mode
1380 :defer t
1381 :config (setq alloy-basic-offset 2))
1382 #+end_src
1383
1384 ** [[https://coq.inria.fr][Coq]] (with [[https://github.com/ProofGeneral/PG][Proof General]])
1385
1386 #+begin_src emacs-lisp
1387 (use-package proof-site ; Proof General
1388 :defer t
1389 :load-path "lib/proof-site/generic/")
1390 #+end_src
1391
1392 ** [[https://leanprover.github.io][Lean]] (with [[https://github.com/leanprover/lean-mode][lean-mode]])
1393
1394 #+begin_src emacs-lisp
1395 (eval-when-compile (defvar lean-mode-map))
1396 (use-package lean-mode
1397 :defer 1
1398 :bind (:map lean-mode-map
1399 ("S-SPC" . company-complete))
1400 :config
1401 (require 'lean-input)
1402 (setq default-input-method "Lean"
1403 lean-input-tweak-all '(lean-input-compose
1404 (lean-input-prepend "/")
1405 (lean-input-nonempty))
1406 lean-input-user-translations '(("/" "/")))
1407 (lean-input-setup))
1408 #+end_src
1409
1410 ** Haskell
1411
1412 *** [[https://github.com/haskell/haskell-mode][haskell-mode]]
1413
1414 #+begin_src emacs-lisp
1415 (use-package haskell-mode
1416 :defer t
1417 :config
1418 (setq haskell-indentation-layout-offset 4
1419 haskell-indentation-left-offset 4
1420 flycheck-checker 'haskell-hlint
1421 flycheck-disabled-checkers '(haskell-stack-ghc haskell-ghc)))
1422 #+end_src
1423
1424 *** [[https://github.com/jyp/dante][dante]]
1425
1426 #+begin_src emacs-lisp
1427 (use-package dante
1428 :after haskell-mode
1429 :commands dante-mode
1430 :hook (haskell-mode . dante-mode))
1431 #+end_src
1432
1433 *** [[https://github.com/mpickering/hlint-refactor-mode][hlint-refactor]]
1434
1435 Emacs bindings for [[https://github.com/ndmitchell/hlint][hlint]]'s refactor option. This requires the refact
1436 executable from [[https://github.com/mpickering/apply-refact][apply-refact]].
1437
1438 #+begin_src emacs-lisp
1439 (use-package hlint-refactor
1440 :after haskell-mode
1441 :bind (:map hlint-refactor-mode-map
1442 ("C-c l b" . hlint-refactor-refactor-buffer)
1443 ("C-c l r" . hlint-refactor-refactor-at-point))
1444 :hook (haskell-mode . hlint-refactor-mode))
1445 #+end_src
1446
1447 *** [[https://github.com/flycheck/flycheck-haskell][flycheck-haskell]]
1448
1449 #+begin_src emacs-lisp
1450 (use-package flycheck-haskell
1451 :after haskell-mode)
1452 #+end_src
1453
1454 *** [[https://github.com/ndmitchell/hlint/blob/20e116a043f2073c57b17b24ae6364b5e433ba7e/data/hs-lint.el][hs-lint.el]]
1455 :PROPERTIES:
1456 :header-args+: :tangle lisp/hs-lint.el :mkdirp yes
1457 :END:
1458
1459 Currently using =flycheck-haskell= with the =haskell-hlint= checker
1460 instead.
1461
1462 #+begin_src emacs-lisp :tangle no
1463 ;;; hs-lint.el --- minor mode for HLint code checking
1464
1465 ;; Copyright 2009 (C) Alex Ott
1466 ;;
1467 ;; Author: Alex Ott <alexott@gmail.com>
1468 ;; Keywords: haskell, lint, HLint
1469 ;; Requirements:
1470 ;; Status: distributed under terms of GPL2 or above
1471
1472 ;; Typical message from HLint looks like:
1473 ;;
1474 ;; /Users/ott/projects/lang-exp/haskell/test.hs:52:1: Eta reduce
1475 ;; Found:
1476 ;; count1 p l = length (filter p l)
1477 ;; Why not:
1478 ;; count1 p = length . filter p
1479
1480
1481 (require 'compile)
1482
1483 (defgroup hs-lint nil
1484 "Run HLint as inferior of Emacs, parse error messages."
1485 :group 'tools
1486 :group 'haskell)
1487
1488 (defcustom hs-lint-command "hlint"
1489 "The default hs-lint command for \\[hlint]."
1490 :type 'string
1491 :group 'hs-lint)
1492
1493 (defcustom hs-lint-save-files t
1494 "Save modified files when run HLint or no (ask user)"
1495 :type 'boolean
1496 :group 'hs-lint)
1497
1498 (defcustom hs-lint-replace-with-suggestions nil
1499 "Replace user's code with suggested replacements"
1500 :type 'boolean
1501 :group 'hs-lint)
1502
1503 (defcustom hs-lint-replace-without-ask nil
1504 "Replace user's code with suggested replacements automatically"
1505 :type 'boolean
1506 :group 'hs-lint)
1507
1508 (defun hs-lint-process-setup ()
1509 "Setup compilation variables and buffer for `hlint'."
1510 (run-hooks 'hs-lint-setup-hook))
1511
1512 ;; regex for replace suggestions
1513 ;;
1514 ;; ^\(.*?\):\([0-9]+\):\([0-9]+\): .*
1515 ;; Found:
1516 ;; \s +\(.*\)
1517 ;; Why not:
1518 ;; \s +\(.*\)
1519
1520 (defvar hs-lint-regex
1521 "^\\(.*?\\):\\([0-9]+\\):\\([0-9]+\\): .*[\n\C-m]Found:[\n\C-m]\\s +\\(.*\\)[\n\C-m]Why not:[\n\C-m]\\s +\\(.*\\)[\n\C-m]"
1522 "Regex for HLint messages")
1523
1524 (defun make-short-string (str maxlen)
1525 (if (< (length str) maxlen)
1526 str
1527 (concat (substring str 0 (- maxlen 3)) "...")))
1528
1529 (defun hs-lint-replace-suggestions ()
1530 "Perform actual replacement of suggestions"
1531 (goto-char (point-min))
1532 (while (re-search-forward hs-lint-regex nil t)
1533 (let* ((fname (match-string 1))
1534 (fline (string-to-number (match-string 2)))
1535 (old-code (match-string 4))
1536 (new-code (match-string 5))
1537 (msg (concat "Replace '" (make-short-string old-code 30)
1538 "' with '" (make-short-string new-code 30) "'"))
1539 (bline 0)
1540 (eline 0)
1541 (spos 0)
1542 (new-old-code ""))
1543 (save-excursion
1544 (switch-to-buffer (get-file-buffer fname))
1545 (goto-char (point-min))
1546 (forward-line (1- fline))
1547 (beginning-of-line)
1548 (setf bline (point))
1549 (when (or hs-lint-replace-without-ask
1550 (yes-or-no-p msg))
1551 (end-of-line)
1552 (setf eline (point))
1553 (beginning-of-line)
1554 (setf old-code (regexp-quote old-code))
1555 (while (string-match "\\\\ " old-code spos)
1556 (setf new-old-code (concat new-old-code
1557 (substring old-code spos (match-beginning 0))
1558 "\\ *"))
1559 (setf spos (match-end 0)))
1560 (setf new-old-code (concat new-old-code (substring old-code spos)))
1561 (remove-text-properties bline eline '(composition nil))
1562 (when (re-search-forward new-old-code eline t)
1563 (replace-match new-code nil t)))))))
1564
1565 (defun hs-lint-finish-hook (buf msg)
1566 "Function, that is executed at the end of HLint execution"
1567 (if hs-lint-replace-with-suggestions
1568 (hs-lint-replace-suggestions)
1569 (next-error 1 t)))
1570
1571 (define-compilation-mode hs-lint-mode "HLint"
1572 "Mode for check Haskell source code."
1573 (set (make-local-variable 'compilation-process-setup-function)
1574 'hs-lint-process-setup)
1575 (set (make-local-variable 'compilation-disable-input) t)
1576 (set (make-local-variable 'compilation-scroll-output) nil)
1577 (set (make-local-variable 'compilation-finish-functions)
1578 (list 'hs-lint-finish-hook))
1579 )
1580
1581 (defun hs-lint ()
1582 "Run HLint for current buffer with haskell source"
1583 (interactive)
1584 (save-some-buffers hs-lint-save-files)
1585 (compilation-start (concat hs-lint-command " \"" buffer-file-name "\"")
1586 'hs-lint-mode))
1587
1588 (provide 'hs-lint)
1589 ;;; hs-lint.el ends here
1590 #+end_src
1591
1592 #+begin_src emacs-lisp :tangle no
1593 (use-package hs-lint
1594 :load-path "lisp/"
1595 :bind (:map haskell-mode-map
1596 ("C-c l l" . hs-lint)))
1597 #+end_src
1598
1599 ** Web dev
1600
1601 *** SGML and HTML
1602
1603 #+begin_src emacs-lisp
1604 (use-package sgml-mode
1605 :defer t
1606 :config
1607 (setq sgml-basic-offset 2))
1608 #+end_src
1609
1610 *** CSS and SCSS
1611
1612 #+begin_src emacs-lisp
1613 (use-package css-mode
1614 :defer t
1615 :config
1616 (setq css-indent-offset 2))
1617 #+end_src
1618
1619 *** Web mode
1620
1621 #+begin_src emacs-lisp
1622 (use-package web-mode
1623 :defer t
1624 :mode "\\.html\\'"
1625 :config
1626 (setq-every! 2
1627 web-mode-code-indent-offset
1628 web-mode-css-indent-offset
1629 web-mode-markup-indent-offset))
1630 #+end_src
1631
1632 *** Emmet mode
1633
1634 #+begin_src emacs-lisp
1635 (use-package emmet-mode
1636 :after (:any web-mode css-mode sgml-mode)
1637 :bind* (("C-)" . emmet-next-edit-point)
1638 ("C-(" . emmet-prev-edit-point))
1639 :config
1640 (unbind-key "C-j" emmet-mode-keymap)
1641 (setq emmet-move-cursor-between-quotes t)
1642 :hook (web-mode css-mode html-mode sgml-mode))
1643 #+end_src
1644
1645 ** Nix
1646
1647 #+begin_src emacs-lisp
1648 (use-package nix-mode
1649 :defer t
1650 :mode "\\.nix\\'")
1651 #+end_src
1652
1653 ** Java
1654
1655 *** meghanada
1656
1657 #+begin_src emacs-lisp :tangle no
1658 (use-package meghanada
1659 :bind
1660 (:map meghanada-mode-map
1661 (("C-M-o" . meghanada-optimize-import)
1662 ("C-M-t" . meghanada-import-all)))
1663 :hook (java-mode . meghanada-mode))
1664 #+end_src
1665
1666 *** lsp-java
1667
1668 #+begin_comment
1669 dependencies:
1670
1671 ace-window
1672 avy
1673 bui
1674 company-lsp
1675 dap-mode
1676 lsp-java
1677 lsp-mode
1678 lsp-ui
1679 pfuture
1680 tree-mode
1681 treemacs
1682 #+end_comment
1683
1684 #+begin_src emacs-lisp :tangle no
1685 (use-package treemacs
1686 :config (setq treemacs-never-persist t))
1687
1688 (use-package yasnippet
1689 :config
1690 ;; (yas-global-mode)
1691 )
1692
1693 (use-package lsp-mode
1694 :init (setq lsp-eldoc-render-all nil
1695 lsp-highlight-symbol-at-point nil)
1696 )
1697
1698 (use-package hydra)
1699
1700 (use-package company-lsp
1701 :after company
1702 :config
1703 (setq company-lsp-cache-candidates t
1704 company-lsp-async t))
1705
1706 (use-package lsp-ui
1707 :config
1708 (setq lsp-ui-sideline-update-mode 'point))
1709
1710 (use-package lsp-java
1711 :config
1712 (add-hook 'java-mode-hook
1713 (lambda ()
1714 (setq-local company-backends (list 'company-lsp))))
1715
1716 (add-hook 'java-mode-hook 'lsp-java-enable)
1717 (add-hook 'java-mode-hook 'flycheck-mode)
1718 (add-hook 'java-mode-hook 'company-mode)
1719 (add-hook 'java-mode-hook 'lsp-ui-mode))
1720
1721 (use-package dap-mode
1722 :after lsp-mode
1723 :config
1724 (dap-mode t)
1725 (dap-ui-mode t))
1726
1727 (use-package dap-java
1728 :after (lsp-java))
1729
1730 (use-package lsp-java-treemacs
1731 :after (treemacs))
1732 #+end_src
1733
1734 * Emacs Enhancements
1735
1736 ** [[https://github.com/justbur/emacs-which-key][which-key]]
1737
1738 #+begin_quote
1739 Emacs package that displays available keybindings in popup
1740 #+end_quote
1741
1742 #+begin_src emacs-lisp
1743 (use-package which-key
1744 :defer 1
1745 :config (which-key-mode))
1746 #+end_src
1747
1748 ** theme
1749
1750 #+begin_src emacs-lisp
1751 (add-to-list 'custom-theme-load-path "~/.emacs.d/lisp")
1752 (load-theme 'tangomod t)
1753 #+end_src
1754
1755 ** doom-modeline
1756
1757 #+begin_src emacs-lisp
1758 (use-package doom-modeline
1759 :demand t
1760 :config (setq doom-modeline-height 32)
1761 :hook (after-init . doom-modeline-init))
1762 #+end_src
1763
1764 ** doom-themes
1765
1766 #+begin_src emacs-lisp
1767 (use-package doom-themes)
1768 #+end_src
1769
1770 ** theme helper functions
1771
1772 #+begin_src emacs-lisp
1773 (defun amin/lights-on ()
1774 "Enable my favourite light theme."
1775 (interactive)
1776 (progn
1777 (mapc #'disable-theme custom-enabled-themes)
1778 (load-theme 'tangomod t)))
1779
1780 (defun amin/lights-off ()
1781 "Go dark."
1782 (interactive)
1783 (progn
1784 (mapc #'disable-theme custom-enabled-themes)
1785 (load-theme 'doom-tomorrow-night t)))
1786
1787 (amin--leader-keys
1788 "t" '(:ignore t :wk "theme")
1789 "t d" 'amin/lights-off
1790 "t l" 'amin/lights-on)
1791 #+end_src
1792
1793 ** [[https://github.com/bbatsov/crux][crux]]
1794
1795 #+begin_src emacs-lisp
1796 (use-package crux
1797 :defer 1
1798 :general
1799 (amin--leader-keys
1800 "b K" 'crux-kill-other-buffers
1801 "c d" 'crux-duplicate-current-line-or-region
1802 "c D" 'crux-duplicate-and-comment-current-line-or-region
1803 "f c" 'crux-copy-file-preserve-attributes
1804 "f d" 'crux-delete-file-and-buffer
1805 "f r" 'crux-rename-file-and-buffer)
1806 :bind (("C-c d" . crux-duplicate-current-line-or-region)
1807 ("C-c D" . crux-duplicate-and-comment-current-line-or-region)
1808 ("C-S-j" . crux-top-join-line)
1809 ("C-c j" . crux-top-join-line)))
1810 #+end_src
1811
1812 ** [[https://github.com/alezost/mwim.el][mwim]]
1813
1814 #+begin_src emacs-lisp
1815 (use-package mwim
1816 :general
1817 (:states '(normal visual)
1818 "0" 'mwim-beginning-of-code-or-line
1819 "$" 'mwim-end-of-code-or-line)
1820 :bind (("C-a" . mwim-beginning-of-code-or-line)
1821 ("C-e" . mwim-end-of-code-or-line)
1822 ("<home>" . mwim-beginning-of-line-or-code)
1823 ("<end>" . mwim-end-of-line-or-code)))
1824 #+end_src
1825
1826 ** projectile
1827
1828 #+begin_src emacs-lisp
1829 (use-package projectile
1830 :defer t
1831 :bind-keymap ("C-c p" . projectile-command-map)
1832 :config
1833 (projectile-mode)
1834
1835 (defun my-projectile-invalidate-cache (&rest _args)
1836 ;; ignore the args to `magit-checkout'
1837 (projectile-invalidate-cache nil))
1838
1839 (eval-after-load 'magit-branch
1840 '(progn
1841 (advice-add 'magit-checkout
1842 :after #'my-projectile-invalidate-cache)
1843 (advice-add 'magit-branch-and-checkout
1844 :after #'my-projectile-invalidate-cache))))
1845 #+end_src
1846
1847 ** [[https://github.com/Wilfred/helpful][helpful]]
1848
1849 #+begin_src emacs-lisp
1850 (use-package helpful
1851 :defer 1
1852 :general
1853 (amin--leader-keys
1854 "h h" '(:ignore t :wk "helpful")
1855 "h h c" 'helpful-command
1856 "h h f" 'helpful-callable ; helpful-function
1857 "h h v" 'helpful-variable
1858 "h h k" 'helpful-key
1859 "h h p" 'helpful-at-point))
1860 #+end_src
1861
1862 ** [[https://github.com/knu/shell-toggle.el][shell-toggle]]
1863
1864 #+begin_src emacs-lisp
1865 (use-package shell-toggle
1866 :after eshell
1867 :general (amin--leader-keys "a s e" 'amin/shell-toggle)
1868 :bind ("C-c e" . amin/shell-toggle)
1869 :config
1870 (defun amin/shell-toggle (make-cd)
1871 "Toggle between the shell buffer and whatever buffer you are editing.
1872 With a prefix argument MAKE-CD also insert a \"cd DIR\" command
1873 into the shell, where DIR is the directory of the current buffer.
1874
1875 When called in the shell buffer returns you to the buffer you were editing
1876 before calling this the first time.
1877
1878 Options: `shell-toggle-goto-eob'"
1879 (interactive "P")
1880 ;; Try to decide on one of three possibilities:
1881 ;; If not in shell-buffer, switch to it.
1882 ;; If in shell-buffer, return to state before going to the shell-buffer
1883 (if (eq (current-buffer) shell-toggle-shell-buffer)
1884 (shell-toggle-buffer-return-from-shell)
1885 (progn
1886 (shell-toggle-buffer-goto-shell make-cd)
1887 (if shell-toggle-full-screen-window-only (delete-other-windows)))))
1888
1889 ;; override to split horizontally instead
1890 (defun shell-toggle-buffer-switch-to-other-window ()
1891 "Switch to other window.
1892 If the current window is the only window in the current frame,
1893 create a new window and switch to it.
1894
1895 \(This is less intrusive to the current window configuration than
1896 `switch-buffer-other-window')"
1897 (let ((this-window (selected-window)))
1898 (other-window 1)
1899 ;; If we did not switch window then we only have one window and need to
1900 ;; create a new one.
1901 (if (eq this-window (selected-window))
1902 (progn
1903 (split-window-horizontally)
1904 (other-window 1)))))
1905
1906 :custom
1907 (shell-toggle-launch-shell 'shell-toggle-eshell))
1908 #+end_src
1909
1910 ** [[https://github.com/EricCrosson/unkillable-scratch][unkillable-scratch]]
1911
1912 Make =*scratch*= and =*Messages*= unkillable.
1913
1914 #+begin_src emacs-lisp
1915 (use-package unkillable-scratch
1916 :defer 3
1917 :config
1918 (unkillable-scratch 1)
1919 :custom
1920 (unkillable-scratch-behavior 'do-nothing)
1921 (unkillable-buffers '("^\\*scratch\\*$" "^\\*Messages\\*$")))
1922 #+end_src
1923
1924 ** [[https://github.com/davep/boxquote.el][boxquote.el]]
1925
1926 #+begin_example
1927 ,----
1928 | make pretty boxed quotes like this
1929 `----
1930 #+end_example
1931
1932 #+begin_src emacs-lisp
1933 (use-package boxquote
1934 :defer 3
1935 :bind
1936 (:prefix-map amin--boxquote-prefix-map
1937 :prefix "C-c q"
1938 ("b" . boxquote-buffer)
1939 ("B" . boxquote-insert-buffer)
1940 ("d" . boxquote-defun)
1941 ("F" . boxquote-insert-file)
1942 ("hf" . boxquote-describe-function)
1943 ("hk" . boxquote-describe-key)
1944 ("hv" . boxquote-describe-variable)
1945 ("hw" . boxquote-where-is)
1946 ("k" . boxquote-kill)
1947 ("p" . boxquote-paragraph)
1948 ("q" . boxquote-boxquote)
1949 ("r" . boxquote-region)
1950 ("s" . boxquote-shell-command)
1951 ("t" . boxquote-text)
1952 ("T" . boxquote-title)
1953 ("u" . boxquote-unbox)
1954 ("U" . boxquote-unbox-region)
1955 ("y" . boxquote-yank)
1956 ("M-q" . boxquote-fill-paragraph)
1957 ("M-w" . boxquote-kill-ring-save)))
1958 #+end_src
1959
1960 Also see [[https://www.emacswiki.org/emacs/rebox2][rebox2]].
1961
1962 ** COMMENT [[https://github.com/DarthFennec/highlight-indent-guides][highlight-indent-guides]] :ARCHIVE:
1963
1964 #+begin_src emacs-lisp
1965 (use-package highlight-indent-guides
1966 :defer 3
1967 :hook ((prog-mode . highlight-indent-guides-mode)
1968 ;; (org-mode . highlight-indent-guides-mode)
1969 )
1970 :config
1971 (setq highlight-indent-guides-character ?\|)
1972 (setq highlight-indent-guides-auto-enabled nil)
1973 (setq highlight-indent-guides-method 'character)
1974 (setq highlight-indent-guides-responsive 'top)
1975 (set-face-foreground 'highlight-indent-guides-character-face "gainsboro")
1976 (set-face-foreground 'highlight-indent-guides-top-character-face "grey40")) ; grey13 is nice too
1977 #+end_src
1978
1979 ** pdf-tools
1980
1981 #+begin_src emacs-lisp
1982 (use-package pdf-tools
1983 :defer t
1984 :magic ("%PDF" . pdf-view-mode)
1985 :config
1986 (setq pdf-view-resize-factor 1.05)
1987 (pdf-tools-install)
1988 :bind
1989 (:map pdf-view-mode-map
1990 ("C-s" . isearch-forward)
1991 ("C-r" . isearch-backward)
1992 ("j" . pdf-view-next-line-or-next-page)
1993 ("k" . pdf-view-previous-line-or-previous-page)
1994 ("h" . image-backward-hscroll)
1995 ("l" . image-forward-hscroll)))
1996 #+end_src
1997
1998 ** anzu
1999
2000 #+begin_src emacs-lisp
2001 (use-package anzu)
2002 #+end_src
2003
2004 ** typo.el
2005
2006 #+begin_src emacs-lisp
2007 (use-package typo
2008 :defer 2
2009 :config
2010 (typo-global-mode 1)
2011 :hook (text-mode . typo-mode))
2012 #+end_src
2013
2014 ** hl-todo
2015
2016 #+begin_src emacs-lisp
2017 (use-package hl-todo
2018 :defer 4
2019 :config
2020 (global-hl-todo-mode))
2021 #+end_src
2022
2023 ** shrink-path
2024
2025 #+begin_src emacs-lisp
2026 (use-package shrink-path
2027 :after eshell
2028 :config
2029 (setq eshell-prompt-regexp "\\(.*\n\\)*λ "
2030 eshell-prompt-function #'+eshell/prompt)
2031
2032 (defun +eshell/prompt ()
2033 (let ((base/dir (shrink-path-prompt default-directory)))
2034 (concat (propertize (car base/dir)
2035 'face 'font-lock-comment-face)
2036 (propertize (cdr base/dir)
2037 'face 'font-lock-constant-face)
2038 (propertize (+eshell--current-git-branch)
2039 'face 'font-lock-function-name-face)
2040 "\n"
2041 (propertize "λ" 'face 'eshell-prompt-face)
2042 ;; needed for the input text to not have prompt face
2043 (propertize " " 'face 'default))))
2044
2045 (defun +eshell--current-git-branch ()
2046 (let ((branch (car (loop for match in (split-string (shell-command-to-string "git branch") "\n")
2047 when (string-match "^\*" match)
2048 collect match))))
2049 (if (not (eq branch nil))
2050 (concat " " (substring branch 2))
2051 ""))))
2052 #+end_src
2053
2054 ** COMMENT slack :ARCHIVE:
2055
2056 Hopefully temporary.
2057
2058 #+begin_src emacs-lisp
2059 (use-package slack
2060 :commands (slack-start)
2061 :init
2062 (eval-when-compile ; silence the byte-compiler
2063 (defvar url-http-data nil)
2064 (defvar url-http-extra-headers nil)
2065 (defvar url-http-method nil)
2066 (defvar url-callback-function nil)
2067 (defvar url-callback-arguments nil)
2068 (defvar oauth--token-data nil))
2069 (setq slack-buffer-emojify t
2070 slack-prefer-current-team t)
2071 :config
2072 (slack-register-team
2073 :name "uw-apv"
2074 :default t
2075 :client-id uw-apv-client-id
2076 :client-secret uw-apv-client-secret
2077 :token uw-apv-token
2078 :subscribed-channels '(general)
2079 :full-and-display-names t)
2080 (slack-register-team
2081 :name "watform"
2082 :default nil
2083 :client-id watform-client-id
2084 :client-secret watform-client-secret
2085 :token watform-token
2086 :subscribed-channels '(general)
2087 :full-and-display-names t)
2088 (add-to-list 'swiper-font-lock-exclude 'slack-message-buffer-mode t)
2089 (setq lui-time-stamp-format "[%Y-%m-%d %H:%M:%S]"
2090 lui-time-stamp-only-when-changed-p t
2091 lui-time-stamp-position 'right)
2092 :bind
2093 (("C-c s s" . slack-start)
2094 ("C-c s u" . slack-select-unread-rooms)
2095 ("C-c s b" . slack-select-rooms)
2096 ("C-c s t" . slack-change-current-team)
2097 ("C-c s c" . slack-ws-close)
2098 :map slack-mode-map
2099 ("M-p" . slack-buffer-goto-prev-message)
2100 ("M-n" . slack-buffer-goto-next-message)
2101 ("C-c e" . slack-message-edit)
2102 ("C-c k" . slack-message-delete)
2103 ("C-c C-k" . slack-channel-leave)
2104 ("C-c r a" . slack-message-add-reaction)
2105 ("C-c r r" . slack-message-remove-reaction)
2106 ("C-c r s" . slack-message-show-reaction-users)
2107 ("C-c p l" . slack-room-pins-list)
2108 ("C-c p a" . slack-message-pins-add)
2109 ("C-c p r" . slack-message-pins-remove)
2110 ("@" . slack-message-embed-mention)
2111 ("#" . slack-message-embed-channel)))
2112
2113 (use-package alert
2114 :commands (alert)
2115 :init
2116 (setq alert-default-style 'notifier))
2117 #+end_src
2118
2119 ** COMMENT magithub :ARCHIVE:
2120
2121 For when I /have to/ use GH.
2122
2123 #+begin_src emacs-lisp
2124 (use-package magithub
2125 :after magit
2126 :config
2127 (magithub-feature-autoinject t)
2128 (setq magithub-clone-default-directory "~/src/git"))
2129 #+end_src
2130
2131 ** [[https://github.com/peterwvj/eshell-up][eshell-up]]
2132
2133 #+begin_src emacs-lisp
2134 (use-package eshell-up
2135 :after eshell)
2136 #+end_src
2137
2138 ** multi-term
2139
2140 #+begin_src emacs-lisp
2141 (use-package multi-term
2142 :defer 1
2143 :general (amin--leader-keys
2144 "a s m" 'multi-term
2145 "a s p" 'multi-term-dedicated-toggle)
2146 :bind ("C-c C-j" . term-line-mode)
2147 :config
2148 (setq multi-term-program "/bin/screen"
2149 ;; TODO: add separate bindings for connecting to existing
2150 ;; session vs. always creating a new one
2151 multi-term-dedicated-select-after-open-p t
2152 multi-term-dedicated-window-height 20
2153 multi-term-dedicated-max-window-height 30
2154 term-bind-key-alist
2155 '(("C-c C-c" . term-interrupt-subjob)
2156 ("C-c C-e" . term-send-esc)
2157 ("C-k" . kill-line)
2158 ("C-y" . term-paste)
2159 ("M-f" . term-send-forward-word)
2160 ("M-b" . term-send-backward-word)
2161 ("M-p" . term-send-up)
2162 ("M-n" . term-send-down)
2163 ("<C-backspace>" . term-send-backward-kill-word)
2164 ("<M-DEL>" . term-send-backward-kill-word)
2165 ("M-d" . term-send-delete-word)
2166 ("M-," . term-send-raw)
2167 ("M-." . comint-dynamic-complete))
2168 term-unbind-key-alist
2169 '("C-z" "C-x" "C-c" "C-h" "C-y" "<ESC>")))
2170 #+end_src
2171
2172 * Email
2173
2174 #+begin_src emacs-lisp
2175 (defvar amin-maildir (expand-file-name "~/mail/"))
2176 (after! recentf
2177 (add-to-list 'recentf-exclude amin-maildir))
2178 #+end_src
2179
2180 ** Gnus
2181
2182 #+begin_src emacs-lisp
2183 (setq
2184 amin-gnus-init-file (no-littering-expand-etc-file-name "gnus")
2185 mail-user-agent 'gnus-user-agent
2186 read-mail-command 'gnus)
2187
2188 (use-package gnus
2189 :general
2190 (amin--leader-keys
2191 "m" 'gnus
2192 "M" 'gnus-unplugged)
2193 :bind (("s-m" . gnus)
2194 ("s-M" . gnus-unplugged))
2195 :init
2196 (setq
2197 gnus-select-method '(nnnil "")
2198 gnus-secondary-select-methods
2199 '((nnimap "amin"
2200 (nnimap-stream plain)
2201 (nnimap-address "127.0.0.1")
2202 (nnimap-server-port 143)
2203 (nnimap-authenticator plain)
2204 (nnimap-user "amin@aminb.org"))
2205 (nnimap "uwaterloo"
2206 (nnimap-stream plain)
2207 (nnimap-address "127.0.0.1")
2208 (nnimap-server-port 143)
2209 (nnimap-authenticator plain)
2210 (nnimap-user "abandali@uwaterloo.ca")))
2211 gnus-message-archive-group "nnimap+amin:Sent"
2212 gnus-parameters
2213 '(("gnu.*"
2214 (gcc-self . t)))
2215 gnus-large-newsgroup 50
2216 gnus-home-directory (no-littering-expand-var-file-name "gnus/")
2217 gnus-directory (concat gnus-home-directory "news/")
2218 message-directory (concat gnus-home-directory "mail/")
2219 nndraft-directory (concat gnus-home-directory "drafts/")
2220 gnus-save-newsrc-file nil
2221 gnus-read-newsrc-file nil
2222 gnus-interactive-exit nil
2223 gnus-gcc-mark-as-read t))
2224
2225 (use-package gnus-art
2226 :config
2227 (setq
2228 gnus-visible-headers
2229 (concat gnus-visible-headers "\\|^List-Id:\\|^X-RT-Originator:\\|^User-Agent:")
2230 gnus-sorted-header-list
2231 '("^From:" "^Subject:" "^Summary:" "^Keywords:"
2232 "^Followup-To:" "^To:" "^Cc:" "X-RT-Originator"
2233 "^Newsgroups:" "List-Id:" "^Organization:"
2234 "^User-Agent:" "^Date:")
2235 ;; local-lapsed article dates
2236 ;; from https://www.emacswiki.org/emacs/GnusFormatting#toc11
2237 gnus-article-date-headers '(user-defined)
2238 gnus-article-time-format
2239 (lambda (time)
2240 (let* ((date (format-time-string "%a, %d %b %Y %T %z" time))
2241 (local (article-make-date-line date 'local))
2242 (combined-lapsed (article-make-date-line date
2243 'combined-lapsed))
2244 (lapsed (progn
2245 (string-match " (.+" combined-lapsed)
2246 (match-string 0 combined-lapsed))))
2247 (concat local lapsed))))
2248 (bind-keys
2249 :map gnus-article-mode-map
2250 ("r" . gnus-article-reply-with-original)
2251 ("R" . gnus-article-wide-reply-with-original)
2252 ("M-L" . org-store-link)))
2253
2254 (use-package gnus-sum
2255 :bind (:map gnus-summary-mode-map
2256 :prefix-map amin--gnus-summary-prefix-map
2257 :prefix "v"
2258 ("r" . gnus-summary-reply)
2259 ("w" . gnus-summary-wide-reply)
2260 ("v" . gnus-summary-show-raw-article))
2261 :config
2262 (bind-keys
2263 :map gnus-summary-mode-map
2264 ("r" . gnus-summary-reply-with-original)
2265 ("R" . gnus-summary-wide-reply-with-original)
2266 ("M-L" . org-store-link))
2267 :hook (gnus-summary-mode . amin--no-mouse-autoselect-window))
2268
2269 (use-package gnus-msg
2270 :config
2271 (setq gnus-posting-styles
2272 '((".*"
2273 (address "amin@aminb.org")
2274 (body "\nBest,\namin\n")
2275 (eval (setq amin--message-cite-say-hi t)))
2276 ("gnu.*"
2277 (address "bandali@gnu.org"))
2278 ((header "subject" "ThankCRM")
2279 (to "webmasters-comment@gnu.org")
2280 (body "\nAdded to 2018supporters.html.\n\nMoving to campaigns.\n\n-amin\n")
2281 (eval (setq amin--message-cite-say-hi nil)))
2282 ("nnimap\\+uwaterloo:.*"
2283 (address "abandali@uwaterloo.ca")
2284 (gcc "\"nnimap+uwaterloo:Sent Items\"")))))
2285
2286 (use-package gnus-topic
2287 :hook (gnus-group-mode . gnus-topic-mode))
2288
2289 (use-package gnus-agent
2290 :config
2291 (setq gnus-agent-synchronize-flags 'ask)
2292 :hook (gnus-group-mode . gnus-agent-mode))
2293
2294 (use-package gnus-group
2295 :config
2296 (setq gnus-permanently-visible-groups "\\((INBOX\\|gnu$\\)"))
2297
2298 (use-package mm-decode
2299 :config
2300 (setq mm-discouraged-alternatives '("text/html" "text/richtext")))
2301 #+end_src
2302
2303 ** sendmail
2304
2305 #+begin_src emacs-lisp
2306 (use-package sendmail
2307 :config
2308 (setq sendmail-program "/usr/bin/msmtp"
2309 ;; message-sendmail-extra-arguments '("-v" "-d")
2310 mail-specify-envelope-from t
2311 mail-envelope-from 'header))
2312 #+end_src
2313
2314 ** message
2315
2316 #+begin_src emacs-lisp
2317 (use-package message
2318 :config
2319 (defconst amin--message-cite-style-format "On %Y-%m-%d %l:%M %p, %N wrote:")
2320 (defconst message-cite-style-bandali
2321 '((message-cite-function 'message-cite-original)
2322 (message-citation-line-function 'message-insert-formatted-citation-line)
2323 (message-cite-reply-position 'traditional)
2324 (message-yank-prefix "> ")
2325 (message-yank-cited-prefix ">")
2326 (message-yank-empty-prefix ">")
2327 (message-citation-line-format
2328 (if amin--message-cite-say-hi
2329 (concat "Hi %F,\n\n" amin--message-cite-style-format)
2330 amin--message-cite-style-format)))
2331 "Citation style based on Mozilla Thunderbird's. Use with message-cite-style.")
2332 (setq message-cite-style 'message-cite-style-bandali
2333 message-kill-buffer-on-exit t
2334 message-send-mail-function 'message-send-mail-with-sendmail
2335 message-sendmail-envelope-from 'header
2336 message-dont-reply-to-names
2337 "\\(\\(.*@aminb\\.org\\)\\|\\(amin@bandali\\.me\\)\\|\\(\\(aminb?\\|mab\\|bandali\\)@gnu\\.org\\)\\|\\(\\(m\\|a\\(min\\.\\)?\\)bandali@uwaterloo\\.ca\\)\\)"
2338 message-user-fqdn "aminb.org")
2339 :hook (;; (message-setup . mml-secure-message-sign-pgpmime)
2340 (message-mode . flyspell-mode)
2341 (message-mode . (lambda ()
2342 ;; (setq fill-column 65
2343 ;; message-fill-column 65)
2344 (make-local-variable 'company-idle-delay)
2345 (setq company-idle-delay 0.2))))
2346 ;; :custom-face
2347 ;; (message-header-subject ((t (:foreground "#111" :weight semi-bold))))
2348 ;; (message-header-to ((t (:foreground "#111" :weight normal))))
2349 ;; (message-header-cc ((t (:foreground "#333" :weight normal))))
2350 )
2351
2352 (after! mml-sec
2353 (setq mml-secure-openpgp-encrypt-to-self t
2354 mml-secure-openpgp-sign-with-sender t))
2355 #+end_src
2356
2357 ** footnote
2358
2359 Convenient footnotes in =message-mode=.
2360
2361 #+begin_src emacs-lisp
2362 (use-package footnote
2363 :after message
2364 :bind
2365 (:map message-mode-map
2366 :prefix-map amin--footnote-prefix-map
2367 :prefix "C-c f"
2368 ("a" . footnote-add-footnote)
2369 ("b" . footnote-back-to-message)
2370 ("c" . footnote-cycle-style)
2371 ("d" . footnote-delete-footnote)
2372 ("g" . footnote-goto-footnote)
2373 ("r" . footnote-renumber-footnotes)
2374 ("s" . footnote-set-style))
2375 :config
2376 (setq footnote-start-tag ""
2377 footnote-end-tag ""
2378 footnote-style 'unicode))
2379 #+end_src
2380
2381 ** bbdb
2382
2383 Manually install bbdb (=lisp/bbdb= copied from an ELPA-based setup),
2384 because installing it from source on Emacs 27 using the following
2385 submodule configuration for some reason doesn’t work and results in
2386 very strange errors when using any of the functions.
2387
2388 #+begin_src conf :tangle no
2389 [submodule "bbdb"]
2390 path = lib/bbdb
2391 url = https://git.savannah.nongnu.org/git/bbdb.git
2392 load-path = lisp
2393 info-path = doc
2394 build-step = ./autogen.sh
2395 build-step = ./configure
2396 build-step = make
2397 build-step = make install
2398 #+end_src
2399
2400 I tried using =borg-elpa= instead of doing it like this, but it added
2401 2 seconds to my startup time, which is unacceptable to me.
2402
2403 #+begin_src emacs-lisp
2404 (use-package bbdb
2405 :load-path "lisp/bbdb"
2406 :init
2407 (load (expand-file-name "lisp/bbdb/bbdb-autoloads.el" user-emacs-directory))
2408 ;; (bbdb-mua-auto-update-init 'message)
2409 (setq bbdb-mua-auto-update-p 'query
2410 bbdb-complete-mail nil)
2411 (bbdb-initialize 'gnus 'message))
2412 #+end_src
2413
2414 ** COMMENT message-x
2415
2416 #+begin_src emacs-lisp
2417 (use-package message-x
2418 :custom
2419 (message-x-completion-alist
2420 (quote
2421 (("\\([rR]esent-\\|[rR]eply-\\)?[tT]o:\\|[bB]?[cC][cC]:" . gnus-harvest-find-address)
2422 ((if
2423 (boundp
2424 (quote message-newgroups-header-regexp))
2425 message-newgroups-header-regexp message-newsgroups-header-regexp)
2426 . message-expand-group)))))
2427 #+end_src
2428
2429 ** COMMENT gnus-harvest
2430
2431 #+begin_src emacs-lisp
2432 (use-package gnus-harvest
2433 :commands gnus-harvest-install
2434 :demand t
2435 :config
2436 (if (featurep 'message-x)
2437 (gnus-harvest-install 'message-x)
2438 (gnus-harvest-install)))
2439 #+end_src
2440
2441 * Blogging
2442 ** [[https://ox-hugo.scripter.co][ox-hugo]]
2443
2444 #+begin_src emacs-lisp
2445 (use-package ox-hugo
2446 :after ox)
2447
2448 (use-package ox-hugo-auto-export
2449 :load-path "lib/ox-hugo")
2450 #+end_src
2451
2452 * Post initialization
2453 :PROPERTIES:
2454 :CUSTOM_ID: post-initialization
2455 :END:
2456
2457 Display how long it took to load the init file.
2458
2459 #+begin_src emacs-lisp
2460 (message "Loading %s...done (%.3fs)" user-init-file
2461 (float-time (time-subtract (current-time)
2462 amin--before-user-init-time)))
2463 #+end_src
2464
2465 * Footer
2466 :PROPERTIES:
2467 :CUSTOM_ID: footer
2468 :END:
2469
2470 #+begin_src emacs-lisp :comments none
2471 ;;; init.el ends here
2472 #+end_src
2473
2474 * COMMENT Local Variables :ARCHIVE:
2475 # Local Variables:
2476 # eval: (add-hook 'after-save-hook #'amin/async-babel-tangle 'append 'local)
2477 # End: