1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
|
;;; init.el --- my emacs configuration -*- lexical-binding: t; -*-
(add-to-list 'load-path (expand-file-name (concat user-emacs-directory "site-lisp")))
(setq garbage-collection-messages t)
(add-hook 'emacs-startup-hook
#'(lambda ()
(message (format "Initialised in %s seconds with %s garbage collections." (emacs-init-time) gcs-done))
;;; reset garbage collector
(setq
gc-cons-threshold 800000
gc-cons-percentage 0.2)))
(setopt user-mail-address "noa@gaiwan.org")
;; properly distinguish these chords from their ascii legacy
(define-key input-decode-map [?\C-m] [C-m])
(require 'tubthumping-theme)
(load-theme 'tubthumping t)
;; I make my caps lock a menu key, so i can open the command palette with it
(define-key context-menu-mode-map (kbd "<menu>") nil)
(global-unset-key (kbd "M-x"))
(global-set-key (kbd "<menu>") 'execute-extended-command)
(setopt minibuffer-depth-indicate-mode t)
;;; Minibuffer candidate completion
;; Vertico is a package for a nice minibuffer completion experience. It displays a vertical list of candidates. It integrates well with the emacs ecosystem and lets me use other packages that also play nicely.
(use-package vertico :ensure t)
(setopt vertico-mode t)
;; We want vertico to take up a maximum of 12 lines on the display. My screen is quite small, so that's fine, but if i had a bigger screen, i might want to look into setting a percentage or increasing this.
(setopt vertico-count 12)
(setopt vertico-group-format #("%s " 0 3 (face vertico-group-title)))
;; We also want to be able to jump to the bottom of the list by moving up from the top of the list, and the opposite. I've rarely made use of this functionality and i don't know if it's actually a best practice from an interaction perspective, but i'm going to keep it on until it causes an issue for me.
(setopt vertico-cycle t)
;; Multiform mode will allow us to set different layouts for different completion categories. For example, after pressing a prefix key, i can press C-h to view a list of all possible following keys. For this, i want vertico to display a grid of choices, rather than one completion per line.
(setopt vertico-multiform-mode t)
;; And of course, i want to be able to interact with vertico with the mouse.
(setopt vertico-mouse-mode t)
;; When completing a filename, i want to be able to easily delete directories in one fell swoop, instead of character by character or word by word. Usually C-<backspace> would be fine, but if directories have a hyphen or space in their name, i have to press multiple times, which is almost never desirable.
(bind-key (kbd "RET") #'vertico-directory-enter 'vertico-map)
(bind-key (kbd "<backspace>") #'vertico-directory-delete-char 'vertico-map)
(bind-key (kbd "<C-<backspace>") #'vertico-directory-delete-word 'vertico-map)
;; If i type ~/ etc in a find-file prompt, get rid of the preceding directory names for a cleaner look.
(add-hook 'rfn-eshadow-update-overlay-hook #'vertico-directory-tidy)
(setopt read-buffer-completion-ignore-case t)
(setopt read-file-name-completion-ignore-case t)
(setopt completion-ignore-case t)
(use-package orderless :ensure t)
(setopt completion-styles '(orderless basic))
(setopt completion-category-defaults nil)
(setopt completion-category-overrides '((file (styles partial-completion))))
(setopt confirm-nonexistent-file-or-buffer 'after-completion)
;;; Replace the mode line with a header line
;; First, we set the mode line to nil. On my graphical display, this collapses it so all i get is a thin black line separating the buffer from the echo area.
(setq-default mode-line-format nil)
;; But the mode line still holds some useful information that i want to see. I would rather that be in the header line, because to me it makes sense for this kind of metadata to be /above/ the buffer it is describing.
;; First, in white on black text, i want the information about the state of the file. This will show three hyphens in the top left corner of the header line. The first two hyphens mean that the file is both writable and unchanged. If the buffer has been changed, they will change to two asterisks. If the buffer is read only, they will change two percentage symbols. And if the buffer is read only and has been changed, the first will change to a percentage symbol, and the second will change to an asterisk. The final hyphen represents that the file is local, specifically that the default-directory variable is local. If it is remote, an at symbol will be displayed instead.
;; Next, we want to display the buffer name. For buffers which belong to files, this will usually be the file name, but it is likely to be something more informative for special buffers.
;; Below that, show a line and column coördinate. There are special minor modes that will enable or disable this for the default mode line, but i ignore that and put the formatting code here directly. The docstring for the mode-line-format variable suggests that the column might not be displayed correctly in some situations without enabling the minor mode, but i haven't noticed that yet so i don't bother. This column number is zero-indexed; a capital c would make it one-indexed. For now i stick with zero-indexed as that's the emacs default and i'm not sure which is better. I guess it makes a bit more sense that the first character on a line is labeled "1".
;; I don't know exactly what the final variable covers, so i keep it here so that if something shows up i know that it gets put here. Because i have a global mode line in my tab bar, some of the things that would otherwise be here (like the time, battery percentage, and notifications for chat buffers) don't show up.
;; Copy the code from mode-line-format-right-align so that i can use it. This is an emacs 30 feature, which i don't run yet. In the future, i'll be able to remove this.
(defcustom mode-line-right-align-edge 'window
"Where function `mode-line-format-right-align' should align to.
Internally, that function uses `:align-to' in a display property,
so aligns to the left edge of the given area. See info node
`(elisp)Pixel Specification'.
Must be set to a symbol. Acceptable values are:
- `window': align to extreme right of window, regardless of margins
or fringes
- `right-fringe': align to right-fringe
- `right-margin': align to right-margin"
:type '(choice (const right-margin)
(const right-fringe)
(const window))
:group 'mode-line
:version "30.1")
(defun mode--line-format-right-align ()
"Right-align all following mode-line constructs.
When the symbol `mode-line-format-right-align' appears in
`mode-line-format', return a string of one space, with a display
property to make it appear long enough to align anything after
that symbol to the right of the rendered mode line. Exactly how
far to the right is controlled by `mode-line-right-align-edge'.
It is important that the symbol `mode-line-format-right-align' be
included in `mode-line-format' (and not another similar construct
such as `(:eval (mode-line-format-right-align)'). This is because
the symbol `mode-line-format-right-align' is processed by
`format-mode-line' as a variable."
(let* ((rest (cdr (memq 'mode-line-format-right-align
mode-line-format)))
(rest-str (format-mode-line `("" ,@rest)))
(rest-width (string-pixel-width rest-str)))
(propertize " " 'display
;; The `right' spec doesn't work on TTY frames
;; when windows are split horizontally (bug#59620)
(if (and (display-graphic-p)
(not (eq mode-line-right-align-edge 'window)))
`(space :align-to (- ,mode-line-right-align-edge
(,rest-width)))
`(space :align-to (,(- (window-pixel-width)
(window-scroll-bar-width)
(window-right-divider-width)
(* (or (cdr (window-margins)) 1)
(frame-char-width))
;; Manually account for value of
;; `mode-line-right-align-edge' even
;; when display is non-graphical
(pcase mode-line-right-align-edge
('right-margin
(or (cdr (window-margins)) 0))
('right-fringe
;; what here?
(or (cadr (window-fringes)) 0))
(_ 0))
rest-width)))))))
(defvar mode-line-format-right-align '(:eval (mode--line-format-right-align))
"Mode line construct to right align all following constructs.")
(put 'mode-line-format-right-align 'risky-local-variable t)
(setq-default header-line-format
'("%b:%l,%c "
mode-line-format-right-align
"%1*%1+%1@"))
(defun pulse-line (&rest _)
"Pulse the current line."
(pulse-momentary-highlight-one-line (point)))
(dolist (command '(scroll-up-command scroll-down-command recenter-top-bottom other-window))
(advice-add command :after #'pulse-line))
;;; Jabber
(use-package jabber :ensure t)
;; I don't actually use xmpp as xmpp that much. But i do use it to connect to irc, and this package lets me do that. Unfortunately, it's not a particularly well-behaved package; by default it clobbers some keybindings and floods the echo area with unhelpful messages.
(setopt jabber-account-list '(("noa@hmm.st")))
;; So now what we're going to do is get it to stop showing a bunch of channels in the mode line, because there will always be new activity and i want to drop in when i feel like it, and not always have a reminder of that fact. The defun below is copied from jabber-activity-show-p-default but with an extra condition plopped in.
(defcustom noa/jabber-activity-dont-show
'("#tildetown%town@irc.hmm.st"
"#meta%tilde.chat@irc.hmm.st"
"hmm@conference.hmm.st")
"List of JIDs not to show in the modeline."
:group 'jabber-activity)(defun noa/jabber-activity-show-p (jid)
"Return non-nil if JID should be hidden.
A JID should be hidden when there is an invisible buffer for JID,
when JID is not in `noa/jabber-activity-dont-show',
and when JID is not in `jabber-activity-banned'."
(let ((buffer (jabber-activity-find-buffer-name jid)))
(and (buffer-live-p buffer)
(not (get-buffer-window buffer 'visible))
(not (cl-dolist (entry jabber-activity-banned)
(when (string-match entry jid)
(cl-return t))))
(not (cl-dolist (entry noa/jabber-activity-dont-show)
(when (string-match entry jid)
(cl-return t)))))))(setopt jabber-activity-show-p #'noa/jabber-activity-show-p)
;; I'm on a laptop, so whenever i shut it i get disconnected. Jabber can query auth-source for my password, so automatically reconnecting is useful and doesn't need me to do anything.
(setopt jabber-auto-reconnect t)
;; Because my xmpp server supports message history, i don't need to worry about exiting without seeing all messages, as they'll be there when i get back.
(setopt jabber-activity-query-unread nil)
;; The default buffer names are a bit ugly to look at, so i change them to a similar format as eww. Which is still pretty ugly, welcome to emacs
(setopt jabber-chat-buffer-format "*%n | jabber*"
jabber-groupchat-buffer-format "*%n | jabber*")
;; As alluded to above, jabber.el also has a terrible terrible habit of sending a message to the echo area for every change in online state of my contacts, and every single message in any channel. Obviously this gets very annoying, especially if i'm using the minibuffer at that time. Thank you to acdw for pointing me towards these helpful hooks to remove.
(remove-hook 'jabber-alert-muc-hooks #'jabber-muc-echo)
(remove-hook 'jabber-alert-presence-hooks #'jabber-presence-echo)
;; Also stop jabber from clobbering the dired-jump binding and instead use something on C-c like a good child.
(with-eval-after-load 'jabber
(keymap-global-set "C-x C-j" #'dired-jump))
;; Finally, have a binding to jump to a buffer in which there's been some new activity. Better than always using switch-to-buffer to get there.
(keymap-global-set "C-c C-j" #'jabber-activity-switch-to)
(use-package nov :ensure t)
(add-to-list 'auto-mode-alist '("\\.epub\\'" . nov-mode))
;;; Spellcheck
(use-package jinx :ensure t)
(setopt global-jinx-mode t)
(keymap-global-set "M-$" #'jinx-correct)
(keymap-global-set "C-M-$" #'jinx-languages)
(add-to-list 'vertico-multiform-categories
'(jinx grid (vertico-grid-annotate . 20)))
(defun jinx--add-to-abbrev (overlay word)
"Add abbreviation to `global-abbrev-table'.
The misspelled word is taken from OVERLAY. WORD is the corrected word."
(let ((abbrev (buffer-substring-no-properties
(overlay-start overlay)
(overlay-end overlay))))
(message "Abbrev: %s -> %s" abbrev word)
(define-abbrev global-abbrev-table abbrev word)))
(advice-add 'jinx--correct-replace :before #'jinx--add-to-abbrev)
;;; Completing-read everywhere with consult
;; Consult is a package to provide navigation commands that take advantage of completing-read. I set up a nice completing-read environment earlier with vertico. There are a lot of commands built in to consult, and it's possible to define more. But i use it very simply.
(use-package consult :ensure t)
;; Consult buffer can be used instead of the default buffer menu. It lists recently used files and bookmarks as well as open buffers.
(global-set-key [remap switch-to-buffer] #'consult-buffer) ;; also contains file history, etc
(global-set-key [remap yank-pop] #'consult-yank-pop) ;; like normal yank-pop but with live preview
(global-set-key [remap goto-line] #'consult-goto-line)
(global-set-key [remap imenu] #'consult-imenu)
(bind-key [remap imenu] #'consult-org-heading #'org-mode-map)
(global-set-key [remap info] #'consult-info)
;;; Embark: sort of like right click, but better
;; I've only recently started making use of embark and i definitely need to experiment with it more. Essentially it lets you execute actions based on what kind of thing is selected, either at the point in the buffer, or in an already open completion buffer.
(use-package embark :ensure t)
(global-set-key (kbd "C-<menu>") #'embark-act)
(global-set-key (kbd "C-<return>") #'embark-export)
(global-set-key (kbd "M-.") #'embark-dwim)
;; Embark indicators give us visual indication of what embark will do. The minimal indicator puts a message in the echo area. The highlight indicator highlights the region in the buffer that is being acted on. The isearch indicator does the same for when there are multiple regions to be acted on. If we want to see how we can act on the region, we can press C-h.
(setopt embark-indicators '(embark-minimal-indicator
embark-highlight-indicator
embark-isearch-highlight-indicator))
;; As mentioned in the vertico configuration above, we can set vertico to use a different layout when completing different things. In this case, we set embark to take control of showing bindings help and of the prefix help, which is pressing C-h after pressing a prefix. Then we ensure we get a grid layout, so that we can see more commands on screen at a time.
(global-set-key [remap describe-bindings] #'embark-bindings)
(setopt prefix-help-command #'embark-prefix-help-command)
(add-to-list 'vertico-multiform-categories '(embark-keybinding grid))
;; Because i use consult, it's recommended to have this package installed.
(use-package embark-consult :ensure t)
(add-hook 'embark-collect-mode-hook #'consult-preview-at-point-mode)
;;; Annotations for completing-read
;; Marginalia provides us with annotations for candidates in completing read functions. This is things like docstrings for functions, file permissions in find-file, and so on. It's a small quality of life improvement.
(use-package marginalia :ensure t)
(setopt marginalia-mode t)
;; We want to always show the relative age of a file. By default, files which haven't been modified for more than two weeks will display an absolute date.
(setopt marginalia-max-relative-age most-positive-fixnum)
;; My keyboard has a tab key and an i key. For legacy reasons, by default emacs converts C-i to mean the same thing as the tab key, but i don't really want that. The tab key is called <tab> and it gets translated to TAB. C-i is TAB, but i'd rather it by C-i. That's what this decode line does.
(define-key input-decode-map [?\C-i] [C-i])
;; Now that tab and C-i are properly distinguished, i can bind C-i to completion at point.
(global-set-key (kbd "<C-i>") 'completion-at-point)
;; I also want to make the completion at point function a bit more friendly than the default, so i ask consult to provide the completion functionality.
(setopt completion-in-region-function 'consult-completion-in-region)
;; select the help window so that i can easily close it again with q
(setopt help-window-select t)
(setopt switch-to-buffer-obey-display-actions t)
;; (use-package org-fc
;; :disabled
;; :ensure t
;; :custom
;; (org-fc-directories (expand-file-name "~/data/notes/")))
;; If we enable this, emphasis markers will be hidden for a more word processor feel. This has the downside of meaning you have to delete a hidden character to get rid of bold or italic text. I don't have much of a problem with seeing the emphasis markers so i'm willing to put up with any aesthetic shortcomings for a better user experience. The package org-appear solves this by hiding them, but showing them when the point is over them, but i don't think having a whole package just for that is worth it.
(setopt org-hide-emphasis-markers nil)
(setopt org-startup-with-inline-images t)
(setopt org-image-actual-width '(300))
(setopt org-auto-align-tags nil)
(setopt org-tags-column 0)
(setopt org-catch-invisible-edits 'show-and-error)
(setopt org-special-ctrl-a/e t)
(setopt org-insert-heading-respect-content t)
(setopt org-ellipsis "…")
(setopt org-display-custom-times t)
(setopt org-time-stamp-custom-formats '("%Y-%m-%d" . "%Y-%m-%d %H:%M"))
(setopt org-extend-today-until 4)
(setopt org-adapt-indentation nil)
(setopt org-log-done 'time)
(setopt org-return-follows-link t)
(setopt org-agenda-files '("~/data/notes/notes.org"))
(setopt org-capture-bookmark nil)
(setopt org-capture-templates '(("j" "Journal" entry (file+olp+datetree "~/data/notes/notes.org") "* %?\n" :empty-lines 1)
("w" "Website" entry (file+olp+datetree "~/data/notes/notes.org") "* %a\n%?\n" :empty-lines 1)
("c" "Contact" entry (file+olp+datetree "~/data/notes/notes.org")
"* %^{Name}
:PROPERTIES:
:ADDRESS: %^{Address}
:BIRTHDAY: %^{yyyy-mm-dd}
:EMAIL: %^{EMAIL}p
:NOTE: %^{NOTE}
:END:"
:empty-lines 1)
))
(setopt org-agenda-block-separator ?─)
(setopt org-agenda-time-grid '((daily today require-timed)
(800 1000 1200 1400 1600 1800 2000)
" ┄┄┄┄┄ " "┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄"))
(setopt org-agenda-current-time-string
"◀── now ─────────────────────────────────────────────────")
;; Make org html export more pleasant by default
(setopt org-export-with-smart-quotes t)
(setopt org-export-with-entities nil)
(setopt org-export-headline-levels 5)
(setopt org-export-with-toc nil)
(setopt org-export-section-numbers nil)
(setopt org-html-doctype "html5")
(setopt org-html-html5-fancy t)
(setopt org-html-container-element "section")
(setopt org-html-divs '((preamble "header" "preamble")
(content "main" "content")
(postamble "footer" "postamble")))
(setopt org-export-with-sub-superscripts t)
(setopt org-html-head-include-default-style nil
org-html-head-include-scripts nil
org-html-validation-link ""
org-html-indent t)
(global-set-key (kbd "C-c c") #'org-capture)
(global-set-key (kbd "C-c a") #'org-agenda)
(use-package org-modern :ensure t)
(add-hook 'org-mode-hook #'org-modern-mode)
;; (add-hook 'org-agenda-finalize-hook #'org-modern-agenda)
;; There are three ways to make bullet lists in org mode, which seems a bit excessive to me. I almost always only use the hyphen, but i like my bullet points to look like bullets, so here i overwrite the hyphen display to show a bullet point. While i'm at it, i overwrite the others too, because they are functionally identical so should probably look the same too.
(setopt org-modern-list '((?+ . " • ")
(?- . " • ")
(?* . " • ")))
(setopt org-modern-timestamp nil)
(setopt org-modern-star nil)
(setopt org-modern-keyword nil)
(setopt org-modern-checkbox '((88 . "☑")
(45 . #("□–" 0 2
(composition
((2)))))
(32 . "□")))
(setopt org-modern-table nil)
(defun read-file-as-string (filename)
"Read file contents from FILENAME."
(with-temp-buffer
(insert-file-contents filename)
(buffer-string)))
(setq noa/website-header (read-file-as-string "/home/noa/projects/org-website/templates/header.html"))
(setq noa/website-footer (read-file-as-string "/home/noa/projects/org-website/templates/footer.html"))
;; The index page generation functions were taken from Dennis Ogbe. Thank you!
(defun my-blog-parse-sitemap-list (l)
"Convert the sitemap list in to a list of filenames."
;; LIST looks like:
;; (unordered ("[[file:uses.org][Things i use]]") ("[[file:media.org][Media Diary]]") ("[[file:tanklobsters.org][Tank lobsters]]"))
(mapcar #'(lambda (i)
(let ((link (with-temp-buffer
(let ((org-inhibit-startup nil))
(insert (car i))
(org-mode)
(goto-char (point-min))
(org-element-link-parser)))))
(when link
(plist-get (cadr link) :path))))
(cdr l)))
(defun my-blog-sort-article-list (l p)
"sort the article list anti-chronologically."
(sort l #'(lambda (a b)
(let ((date-a (org-publish-find-date a p))
(date-b (org-publish-find-date b p)))
(not (time-less-p date-a date-b))))))
(defun noa/naive-org-first-paragraph (file)
"Naively returns the first paragraph of FILE.
The way that the first paragraph is determined is to assume that there will be an org metadata block beforehand, so look for the first two consecutive newlines and mark the following paragraph."
(with-temp-buffer
(insert-file-contents file)
(goto-char (point-min))
(re-search-forward "\n\n")
(mark-paragraph)
(let ((beg (mark))
(end (point)))
(buffer-substring beg end))))
(defun noa/website-sitemap (title list)
"Generate the index page for my website."
;; LIST looks like:
;; (unordered ("[[file:uses.org][Things i use]]") ("[[file:media.org][Media Diary]]") ("[[file:tanklobsters.org][Tank lobsters]]"))
(with-temp-buffer
;; mangle the parsed list given to us into a plain lisp list of files
(let* ((filenames (my-blog-parse-sitemap-list list))
(project-plist (assoc "website-pages" org-publish-project-alist))
(articles (my-blog-sort-article-list filenames project-plist)))
(message (concat "PLIST: " (plist-get project-plist :base-directory)))
(insert "Several parts of this website are broken as i wrangle with the monstrosity that is programming in emacs lisp. The content should still be fine, but for further cosmetics please hold <3\n\n")
(dolist (file filenames)
(let* ((abspath (file-name-concat "/home/noa/data/share" file))
;; (abspath (file-name-concat (plist-get project-plist :base-directory) file))
(relpath (file-relative-name abspath "/home/noa/data/share"))
(title (org-publish-find-title file project-plist))
(date (format-time-string (car org-time-stamp-formats) (org-publish-find-date file project-plist)))
(preview (noa/naive-org-first-paragraph abspath)))
(insert (concat "* [[file:" relpath "][" title "]]\n"))
(insert (concat
"*" date ":*"
preview))
(insert "\n")))
;; insert a title and save
(insert "#+TITLE: noa.pub\n")
(buffer-string))))
(setq org-publish-project-alist
`(("website"
:components ("website-pages" "website-assets"))
("website-pages"
:publishing-function org-html-publish-to-html
:base-directory "/home/noa/data/share"
:publishing-directory "/home/noa/projects/org-website"
:base-extension "org"
:with-drawers t
:html-link-home "/"
:html-head "<link rel=\"icon\" href=\"data:image/svg+xml,<svg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 100 100%22><text y=%22.9em%22 font-size=%2290%22>𰻝</text></svg>\">"
:html-head-include-default-style nil
:html-head-include-scripts nil
:html-doctype "html5"
;; :html-validation-link nil
:html-preamble ""
:html-postamble ,noa/website-footer
:html-home/up-format ""
:html-link-up ""
:html-html5-fancy t
:html-indent t
:html-head "<link rel=\"stylesheet\" type=\"text/css\" href=\"love.css\" />
<meta name=\"color-scheme\" content=\"light dark\">"
:auto-sitemap t
:sitemap-filename "/home/noa/projects/org-website/index.org"
:sitemap-title "noa.pub"
:sitemap-style list
;; :sitemap-format-entry
:sitemap-function noa/website-sitemap
:sitemap-sort-folders ignore
:sitemap-sort-files anti-chronologically
:sitemap-ignore-case t)
("website-assets"
:publishing-function org-publish-attachment
:base-directory "/home/noa/data/share"
:publishing-directory "/home/noa/projects/org-website"
:base-extension "css\\|js\\|png|\\jpg"
:recursive t)))
;;; Make wide windows narrow with visual-fill-column
(use-package visual-fill-column :ensure t)
(setopt visual-fill-column-enable-sensible-window-split t)
(setopt visual-fill-column-center-text t)
(advice-add 'text-scale-adjust :after #'visual-fill-column-adjust)
(add-hook 'text-mode-hook #'visual-line-fill-column-mode)
(add-hook 'eww-after-render-hook #'visual-line-fill-column-mode)
(add-hook 'nov-post-html-render-hook #'visual-line-fill-column-mode)
(add-hook 'mu4e-view-mode-hook #'visual-line-fill-column-mode)
;; This works... fine. However it's adapting the prefix, it doesn't indent nicely with proportional fonts, but you can't win them all.
(use-package adaptive-wrap :ensure t)
(add-hook 'visual-fill-column-mode-hook #'adaptive-wrap-prefix-mode)
(setopt ffap-file-name-with-spaces t)
(global-set-key [remap find-file] #'find-file-at-point)
(global-set-key [remap dired] #'dired-at-point)
(setopt browse-url-browser-function 'eww-browse-url
browse-url-secondary-browser-function 'browse-url-default-browser
url-cookie-trusted-urls '()
url-cookie-untrusted-urls '(".*")
shr-cookie-policy nil)
;; I don't want web pages to be able to specify their own colours, because i like the colours i already have set.
(setopt shr-use-colors nil)
(setopt shr-max-width nil)
;; We can set what the maximum size of an image in a window should be. This is a fraction of the total window width or height, and if the image would be bigger than this, it'll be resized to fit. It's useful to have it smaller because emacs still sort of chokes on scrolling when there are large images in a buffer. This is the default value of this option.
(setopt shr-max-image-proportion 0.9
shr-discard-aria-hidden t
;; The default name for the eww buffer is *eww*. This is unhelpful because it makes having more than one eww buffer open a bit of a chore to navigate. We can set it to 'url, 'title, or a function. I set it to 'title because marginalia already shows me the url. However, this means that i can't search for a url name when switching buffers. See the help for this variable for an example of a function which gives the page title and the url.
eww-auto-rename-buffer 'title)
;; Goto address mode makes urls and email address in a buffer clickable. I want these clickable links to look like links, because that's what they are. The two mouse face variables are what face is used on hover, which at the moment i ignore. It might also be worth setting them to 'highlight.
(setopt global-goto-address-mode t)
(setopt goto-address-mail-face 'link)
(setopt goto-address-mail-mouse-face 'highlight)
(setopt goto-address-url-face 'link)
(setopt goto-address-url-mouse-face 'highlight)
;; Abbrev mode expands one string into another string. I use it as a simple autocorrect mode. If i misspell a word, i run C-x a i g which will prompt me for what to expand the previous word into. I type the correct spelling, and whenever i make that mistake again, it will automatically be corrected. It's important to be careful not to set something that could be a typo for two words though, because otherwise it gets even more annoying. Luckily it's easy to update the abbrevs which are stored in ~/.config/emacs/abbrev_defs. M-x list-abbrevs is also a nice command which shows all the saved abbrevs and how many times they've been expanded.
(add-hook 'text-mode-hook #'abbrev-mode)
(setopt global-eldoc-mode t)
;; use a bar cursor and blink it and don't stop blinking it. i don't know how i feel about this yet to be honest, but it helps me know which window is active so for now i'm keeping it
(setopt
cursor-type 'bar
blink-cursor-mode -1
blink-cursor-interval 0.7)
;; Dired is a really nice package which, as with a lot of emacs, has some dodgy defaults. Here we round off some of the sharp edges to make it more enjoyable to use.
;; By default, dired permanently deletes files. But i have quite a bit of storage and also make bad decisions regularly, so it seems fitting to make use of the wonderful invention that is the trash. People who have used systems from the last forty years or so will likely be familiar with this innovation.
(setopt delete-by-moving-to-trash t)
;; It's not fun to be asked every time whether we want to delete a directory recursively. It's an understandable default for safety reasons, but because we are not deleting permanently but rather just moving to the trash, it's not such a concern.
(setopt dired-recursive-deletes 'always)
;; Recursive copying isn't even destructive, so i definitely don't want to be asked about that.
(setopt dired-recursive-copies 'always)
;; After we delete some files or directories, it makes sense to get rid of any buffers which are looking at those files or directories.
(setopt dired-clean-up-buffers-too nil)
;; With this set, if we have two dired buffers open next to one another, a rename operation in one will default to the directory shown in the other. In this way, we can pretend we are using some kind of norton commander like file browser instead of slumming it in emacs.
(setopt dired-dwim-target t)
;; These are some useful ls switches. We have to keep -l. To show dotfiles as well, we use -a. To sort numbers by number order instead of lumping together ones, twos, and so on, we use -v. Because we don't have colour, it's nice to have a clear indicator of what is a file and what is a directory, as well as other different things like symlinks which i never remember. By using -F, a forward slash is appended to every directory. And to get more easily understandable file sizes, we use -h, which will tell us the file size in kilobytes or megabytes rather than a huge number that means nothing to me. I won't explain the meaning of the long flag.
(setopt dired-listing-switches "-alvFh --group-directories-first")
;;; Indentation: tabs and whitespace settings
;; In general, my rules for inserting tabs are that the tab key should insert tabs. I personally prefer tabs to spaces, because tabs work reasonably well whatever font or tab width one chooses to set, whereas spaces are the same width for everyone, except when someone uses a proportional font in which case they are narrower than expected. Furthermore, people tend to use spaces for alignment, which looks bad when you can't rely on every character being the same width.
;; However, i'm in the minority, and fighting with the very complicated emacs indentation systems is simply not fun. That said, i refuse to use a monospaced font. Luckily the minority is more than one and someone has already done the hard work for me of writing a mode to make spaces for indentation work reasonably well with a proportional font. That mode is elastic-indent-mode, and it very simply makes leading whitespace characters the same width as the characters on the line above. It's a simple solution but most of the time it does what i want.
(require 'elastic-indent)
(add-hook 'prog-mode-hook #'elastic-indent-mode)
;; Previously i used a function to naïvely copy the whitespace from the line above. This is the way that vi, nano, and acme all implement auto-indentation. However, for now i'm experimenting with using the built-in indentation functions again. I'm leaving this defun here for posterity.
(defun noa/naive-return-and-indent ()
"Insert a newline and copy the indentation of the previous line, vi/nano style."
(interactive)
(open-line 1)
(let* ((start (progn (beginning-of-line) (point)))
(indent (progn (back-to-indentation) (point)))
(end (progn (end-of-line) (point)))
(whitespace (buffer-substring start indent)))
(delete-trailing-whitespace start end)
(beginning-of-line 2)
(insert whitespace)))
;; We will only be trying to indent at the start of a line, and sometimes we will want to insert a standard tab character. We can also set this option to 'complete, which will run completion at point if the region is already indented.
(setopt tab-always-indent nil)
;; Usually, we want indentation to be done with tabs. Some modes make more sense to use spaces to indent. Lisp is a particular example, and emacs's default behaviour of converting tabs into spaces is frankly horrific. I've taken the below code from acdw to use spaces in these modes.
(defvar space-indent-modes '(emacs-lisp-mode
lisp-interaction-mode
lisp-mode
scheme-mode
python-mode)
"Modes to indent with spaces, not tabs.")
(add-hook 'prog-mode-hook
(defun indent-tabs-mode-maybe ()
(setq indent-tabs-mode
(if (apply #'derived-mode-p space-indent-modes) nil t))))
;; I want to ensure that indentation is always correct. The builtin electric indent mode works /sometimes/, but the aggressive indent mode package is more reliable.
(use-package aggressive-indent :ensure t)
(setopt global-aggressive-indent-mode t)
;;; Interface
;; I want to make sure that various bits of the interface are hidden. but this isn't an "all gui chrome is useless" rampage. I personally think the scrollbar is useful, i like the visual indication it gives of how far i am through a file.
;; At the moment, explicitly disabling the menu bar and tool bar does nothing, because i already set there to be no lines displayed for the tool and menu bars in my early-init.el file.
;; (setopt
;; menu-bar-mode nil
;; tool-bar-mode nil
;; )
;; Tooltips are little popups next to the mouse cursor. I think this information is helpful, but i like it to appear in a more consistent position, because i find it frustrating when popups cover parts of the ui that i wanted to see. By disabling tooltip-mode, the contents that would be in a popup is instead shown in the echo area.
(setopt tooltip-mode nil)
;; I see no reason not to immediately show which chords in a key sequence i have already pressed. Emacs does, however, and instead of letting me set the value of echo-keystrokes to zero to wait zero seconds to show that information, it repurposes zero as a method of disabling the functionality altogether, and provides no special functionality for setting it to nil that would explain why that's not an acceptable method of disabling a feature. Instead, i have to deal with setting it to nearly zero, and luckily i can't tell the difference.
(setopt echo-keystrokes 0.1)
;; A useful feature when programming is to show matching parentheses. Show-paren-mode is a global mode. By default it runs in all buffers except those inheriting from special mode.
(setopt show-paren-mode t)
;; This variable means that if there is no non-whitespace character in between the point and the paren, it will be highlighted. It's useful to highlight parentheses if the point is at the start of the line and the paren is indented.
(setopt show-paren-when-point-in-periphery t)
;; By default, the point has to be after a paren for it to be highlighted. But often the point will be just inside, in which case it's also helpful for the pair to be highlighted.
(setopt show-paren-when-point-inside-paren t)
(setopt tab-bar-mode t)
(setopt tab-bar-format '(tab-bar-format-menu-bar
tab-bar-format-align-right
tab-bar-format-global))
(setopt global-font-lock-mode t)
(setopt font-lock-maximum-decoration nil)
(setopt inhibit-startup-screen t
mouse-drag-and-drop-region nil
mouse-yank-at-point t
;; deleting should be an explicit action
delete-selection-mode nil)
(global-set-key (kbd "C-t") 'tab-new)
;; shift click to select region with the mouse. This annoyingly rings the bell for an error
(global-unset-key (kbd "S-<down-mouse-1>"))
(global-set-key (kbd "S-<down-mouse-1>") 'mouse-save-then-kill)
;;; packages
(setopt package-archives
'(("gnu" . "https://elpa.gnu.org/packages/")
("nongnu" . "https://elpa.nongnu.org/nongnu/")
("melpa-stable" . "https://stable.melpa.org/packages/")
("melpa" . "https://melpa.org/packages/")))
;;; saving
;; backups are pointless in long emacs sessions imo, but autosaves are useful
(setopt remote-file-name-inhibit-auto-save t)
(setopt remote-file-name-inhibit-auto-save-visited t)
(setopt make-backup-files nil
backup-by-copying t
create-lockfiles nil
auto-save-mode 1
auto-save-interval 6 ;; every six keystrokes
auto-save-timeout 5 ;; every 5 seconds
auto-save-default t
auto-save-no-message t
save-silently t
version-control t
;; this will auto save to the current file
auto-save-visited-mode t)
(add-hook 'focus-out-hook (lambda () (interactive) (save-some-buffers t)))
(add-hook 'mouse-leave-buffer-hook (lambda () (interactive) (save-some-buffers t)))
;; (use-package keyfreq :ensure t)
;; (setopt keyfreq-mode t)
;; (setopt keyfreq-autosave-mode t)
;; (setopt keyfreq-excluded-regexp (rx (or "pixel-scroll-precision")))
;; C-l goes in order
(setopt recenter-positions '(top middle bottom))
;; Emacs uses choppy scrolling by default. If i scoll with my trackpad, it's nice to have it move tiny amounts at the same time as my fingers, which pixel-scroll-precision-mode allows for. This also has the benefit of making scrolling over images a little bit of a nicer experience.
(setopt pixel-scroll-precision-mode t
pixel-scroll-precision-use-momentum t)
;; (use-package smartscan)
;; (global-set-key (kbd "M-n") #'smartscan-symbol-go-forward)
;; (global-set-key (kbd "M-p") #'smartscan-symbol-go-backward)
(global-set-key (kbd "M-n") #'next-error)
(global-set-key (kbd "M-p") #'previous-error)
;;; sentences
(setopt sentence-end-double-space nil)
;; If i write a script, i will always run chmod +x after saving it. This command means i don't have to do that.
(add-hook 'after-save-hook #'executable-make-buffer-file-executable-if-script-p)
;; We are on a unix system, so it makes sense to end files in the unix system way. I'm surprised this isn't the default.
(setopt require-final-newline t)
(setopt window-min-height 1
window-combination-resize t
window-resize-pixelwise t
frame-resize-pixelwise t)
;;; history
(setopt history-length 250
kill-ring-max 25)
(setopt savehist-file "~/.config/emacs/savehist")
(setopt savehist-additional-variables
'(kill-ring
command-history
set-variable-value-history
custom-variable-history
query-replace-history
read-expression-history
minibuffer-history
read-char-history
face-name-history
bookmark-history
file-name-history))
(setopt savehist-mode t)
(setopt window-divider-mode t)
(setopt window-divider-default-right-width 1)
(setopt window-divider-default-bottom-width 1)
(setopt window-divider-default-places t)
;; Add prompt indicator to `completing-read-multiple'.
;; We display [CRM<separator>], e.g., [CRM,] if the separator is a comma.
(defun crm-indicator (args)
(cons (format "[CRM%s] %s"
(replace-regexp-in-string
"\\`\\[.*?]\\*\\|\\[.*?]\\*\\'" ""
crm-separator)
(car args))
(cdr args)))
(advice-add #'completing-read-multiple :filter-args #'crm-indicator)
;; Do not allow the cursor in the minibuffer prompt
(setopt minibuffer-prompt-properties
'(read-only t cursor-intangible t face minibuffer-prompt))
(add-hook 'minibuffer-setup-hook #'cursor-intangible-mode)
(setopt display-battery-mode t)
(setopt display-time-default-load-average nil)
(setopt display-time-24hr-format t)
(setopt display-time-mode t)
;; Support opening new minibuffers from inside existing minibuffers.
(setopt enable-recursive-minibuffers t)
(setopt debug-on-error t)
;; Hide commands in M-x which do not work in the current mode.
(setopt read-extended-command-predicate 'command-completion-default-include-p)
(setopt recentf-max-menu-items 25
recentf-save-file "~/.config/emacs/recentf"
recentf-mode 1
bookmark-default-file "~/.config/emacs/bookmarks")
;;; miscellaneous
(setopt save-place-mode 1)
(setenv "PAGER" "cat")
(setenv "TERM" "dumb")
(setenv "NO_COLOR")
(setenv "GPG_AGENT_INFO" nil)
;; The former means that when given a list of choices, we can use single character abbreviations to answer. The latter is a fancy way of defaliasing yes-or-no-p to y-or-n-p.
(setopt read-answer-short t)
(setopt use-short-answers t)
(setq disabled-command-function nil)
(setopt custom-file (make-temp-file "custom"))
(setq inhibit-startup-echo-area-message "noa") ;; #userfreedom
(setopt
uniquify-after-kill-buffer-p t
uniquify-buffer-name-style 'forward
uniquify-ignore-buffers-re "^\\*"
uniquify-separator "/")
(setopt
save-interprogram-paste-before-kill t
mouse-yank-at-point t
require-final-newline t
visible-bell t
load-prefer-newer t
ediff-window-setup-function 'ediff-setup-windows-plain)
;; (unless (server-running-p) (server-start)))
(setopt help-at-pt-display-when-idle t)
;;; Search in buffer
;; Isearch is good, but it has some rough edges. The easiest way forward was just to use ctrlf, which fixes most of them.
;; (use-package ctrlf :ensure t)
;; (global-set-key [remap isearch-forward] #'ctrlf-forward-default)
;; n(global-set-key [remap isearch-backward] #'ctrlf-backward-default)
;; (global-set-key [remap isearch-forward-regexp] #'ctrlf-forward-alternate)
;; (global-set-key [remap isearch-backward-regexp] #'ctrlf-backward-alternate)
;; (use-package casual-isearch :ensure t)
;; (define-key isearch-mode-map (kbd "<f2>") #'casual-isearch-tmenu)
(define-key isearch-mode-map (kbd "<f2>") #'cc-isearch-menu-transient)
;; It makes more sense to go to the start of the match, because i start searching where i want to be.
(defun isearch-exit-at-front ()
"always exit isearch, at the front of search match."
(interactive)
(isearch-exit)
(when isearch-forward
(goto-char isearch-other-end)))
(defun isearch-exit-at-end ()
"Always exit isearch, at the end of search match."
(interactive)
(isearch-exit)
(when (not isearch-forward)
(goto-char isearch-other-end)))
(define-key isearch-mode-map (kbd "<return>") #'isearch-exit-at-front)
(define-key isearch-mode-map (kbd "C-<return>") #'isearch-exit-at-end)
;; Make isearch always quit on C-g
(define-key isearch-mode-map (kbd "C-g") #'isearch-cancel)
(define-key isearch-mode-map (kbd "C-o") #'isearch-occur)
(setopt search-whitespace-regexp ".*?")
(setopt isearch-lax-whitespace t)
(setopt isearch-lazy-count t)
(setopt isearch-allow-motion t)
(setopt isearch-repeat-on-direction-change t)
(setopt isearch-wrap-pause 'no)
;; Make isearch use the minibuffer like a good normal program
(use-package isearch-mb :ensure t)
(setopt isearch-mb-mode t)
;; (add-hook 'occur-mode-hook #'hl-line-mode)
(global-set-key (kbd "M-o") 'other-window)
(global-set-key (kbd "C-x k") 'kill-this-buffer)
;; undo C-/
;; redo C-S-/
(setopt undo-no-redo t)
;;; Email: mu4e
(setopt mu4e-headers-skip-duplicates t)
(setopt mu4e-view-show-images t)
(setopt mu4e-view-show-addresses t)
;; In theory i like format flowed, but what i like even more is just not hard wrapping messages and dealing with hacks to get around that to begin with. If software supported soft wrapping at an arbitrary column, the world would be a better place.
(setopt mu4e-compose-format-flowed nil)
(setopt mu4e-change-filenames-when-moving t)
(setopt mu4e-use-fancy-chars nil)
(setopt mu4e-confirm-quit nil)
(setopt mu4e-headers-leave-behavior 'apply)
(setopt mu4e-headers-precise-alignment t)
(setopt mu4e-headers-fields '((:flags . 6)
(:from . 32)
(:subject)))
(setopt mu4e-search-threads nil)
(setopt mu4e-hide-index-messages t)
(setopt mu4e-get-mail-command "mbsync -c ~/.config/mbsyncrc fastmail")
(setopt mu4e-maildir "~/mail")
(setopt mu4e-drafts-folder "/Drafts")
(setopt mu4e-sent-folder "/Sent")
(setopt mu4e-refile-folder "/Archive")
(setopt mu4e-trash-folder "/Trash")
(setopt mu4e-bookmarks '((:name "Inbox" :query "maildir:/Inbox" :key ?i)
(:name "Feeds" :query "maildir:/Feeds" :key ?f)
(:name "Paper trail" :query "\"maildir:/Paper trail\"" :key ?p)))
;; function to move mails to trash
(with-eval-after-load 'mu4e
(bind-key (kbd "d") #'noa/move-to-trash 'mu4e-headers-mode-map)
(bind-key (kbd "d") #'noa/move-to-trash 'mu4e-view-mode-map)
(fset 'noa/move-to-trash "mTrash"))
;; The first string is for when fancy characters are disabled, and the second is for when they are enabled. But i set them all manually because some of the other characters are ugly in fancy mode, but i like my unicode thread icons.
(setq mu4e-headers-thread-connection-prefix '("│ " . "│ ")
mu4e-headers-thread-last-child-prefix '("└ " . "└ ")
mu4e-headers-thread-blank-prefix '(" " . " ")
mu4e-headers-thread-root-prefix '("□ " . "□ ")
mu4e-headers-thread-child-prefix '("│ " . "│ ")
mu4e-headers-thread-orphan-prefix '("♢ " . "♢ ")
mu4e-headers-thread-duplicate-prefix '("≡ " . "≡ ")
mu4e-headers-thread-first-child-prefix '("⚬ " . "⚬ ")
mu4e-headers-thread-single-orphan-prefix '("♢ " . "♢ "))
;; Setting this to nil stops auto-fill from being automatically enabled in message buffers.
(setopt message-fill-column nil)
;; (message-signature-file)
(setopt message-signature "~noa (https://noa.pub)
• I try to reply to formal emails in three sentences or fewer; excuse my brevity.
• I queue replies and batch send them at intervals; excuse my untimeliness.")
(global-set-key (kbd "M-z") 'zap-up-to-char)
(use-package markdown-mode
:ensure t
:mode ("\\.md\\'" . markdown-mode))
(use-package valign
:ensure t
:hook (markdown-mode . valign-mode)
:hook (org-mode . valign-mode)
:custom
(valign-fancy-bar t)
(valign-max-table-size 0))
;; This is my own version of fixed-pitch, which has some changes to it. No hooks are added by default. Updating the whitelist automatically applies the hooks. And there is no functionality for changing the cursor type.
(use-package fixed-pitch)
(setopt fixed-pitch-whitelist-hooks '(calendar-mode-hook
dired-mode-hook
ibuffer-mode-hook
magit-mode-hook
profiler-report-mode-hook
jabber-roster-mode-hook
mu4e-headers-mode-hook))
(setopt transient-align-variable-pitch t)
;; My current favourite font is sn pro, which feels like comic sans for grown ups. It's friendly but consistent and well thought out. However, it's also a proportional font, which obviously is the right way to do things, but emacs is very old and comes from a time before the innovation of legibility. As a result, there are some things that require a monospaced font, so i set one here. I chose go mono for two reasons: the first is because i think it looks really nice; the second is because it has serifs and is very visually distinct from sn pro, so i can notice and shame those buffers which require a fixed width font to operate properly.
(custom-set-faces
'(fixed-pitch ((t (:family "Go Mono" :height 110))))
'(variable-pitch ((t (:family "SN Pro" :height 110)))))
;; For some frustrating reason, emacs does not respect fontconfig font settings. What this means in practice is that emacs by default draws cjk characters with the korean variant. Luckily emacs has its own obscure and poorly documented way of doing things, so i can iterate over the relevant charsets and set the font specifically for those characters.
(dolist (charset '(han cjk-misc))
(set-fontset-font t charset (font-spec :family "Noto Sans CJK SC")))
;; Similar to the above, we have to manually set the font we want to be used for emoji. I like the cute style of the emoji in fsd emoji, but it doesn't have very good coverage, so we also set noto emoji as the backup. Note that noto emoji is not the same as noto color emoji, which uses coloured emoji. That's clearly against the vibe of this emacs!
(set-fontset-font
t 'emoji (font-spec :family "FSD Emoji") nil 'prepend)
(set-fontset-font
t 'emoji (font-spec :family "Noto Emoji") nil 'append)
;; While we're here, let's set up emoji input.
(use-package cape :ensure t)
(add-to-list 'vertico-multiform-categories
'(cape-emoji grid indexed (vertico-grid-annotate . 6)))
(global-set-key (kbd "C-.") #'cape-emoji)
;; Describe a key based on a string like "C-SPC"
(defun describe-key-shortcut (shortcut)
(interactive "MShortcut: ")
(describe-key (kbd shortcut)))
;; Update the calendar. We want weeks to start on a monday, the first day of the week. Holidays should be highlighted, and the date format should put the year first.
(setopt calendar-week-start-day 1
calendar-mark-holidays-flag t
calendar-date-style 'iso)
;; Multiple cursors are a nice feature because they are very interactive. However, i've always found the emacs implementation a bit too janky. Iedit implements one case where multiple cursors are used, which is to put a cursor at every same symbol in the buffer and edit them all, sort of like a real-time query-replace.
(use-package iedit :ensure t)
;;; Replace
;; Anzu provides real-time updates to the replacement string when running query-replace.
(use-package anzu :ensure t)
(global-set-key [remap query-replace] 'anzu-query-replace)
(global-set-key [remap query-replace-regexp] 'anzu-query-replace-regexp)
;; My computer has a small screen, so i find that it's more beneficial for me to split the frame into columns, so i get more context. However, splitting in this way only gives me a (window-width) of 61, so emacs will always split into vertically stacked windows. By setting this to 80, the first split should always be vertical.
(setopt split-width-threshold 80)
;; Define a handy function that allows me to do a full text search of every file in my home directory. For the most part, this works well; ripgrep avoids binary files. However, in some files with embedded images, it can add a lot of junk to the output.
(defun noa/consult-rg-home ()
(interactive)
(consult-ripgrep "~/"))
(global-set-key (kbd "<f5>") #'noa/consult-rg-home)
(setopt shell-file-name "/bin/sh")
(defun snarf-song (url)
(interactive "sYoutube url:")
(async-shell-command
(concat "yt-dlp -x --audio-format=mp3 -o "
(shell-quote-argument "~/media/music/%(title)s [%(id)s].%(ext)s")
" "
(shell-quote-argument url))))
;; Put a quote in the scratch buffer
(setopt cookie-file "~/data/quotes")
(setopt initial-scratch-message
(concat (with-temp-buffer
(emacs-lisp-mode)
(insert (cookie cookie-file))
(mark-whole-buffer)
(comment-region (mark) (point))
(buffer-substring (mark) (point)))
"\n\n"))
(use-package i-ching :ensure t)
;; Use pass from auth-source
(require 'auth-source-pass)
(add-to-list 'auth-sources 'password-store)
(auth-source-forget-all-cached)
|