diff --git a/docs/index.html b/docs/index.html index 8552567..6d454f2 100644 --- a/docs/index.html +++ b/docs/index.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + Emacs configuration @@ -23,184 +23,184 @@

Emacs configuration

Table of Contents

@@ -209,27 +209,27 @@

Table of Contents

Currently tailored for GNU Emacs 29.1.

-
-

1. todo-list

+
+

1. todo-list

-
-

1.1. TODO get smooth scrolling working

+
+

1.1. TODO get smooth scrolling working

-
-

1.2. TODO get search working with 12.3

+
+

1.2. TODO get search working with 12.3

See the following issue, which is probably related: politza/pdf-tools#528 What would be the correct `use-package` declaration?

-
-

1.3. SOMEDAY explore additional key themes for lispyville (see 9.2.3)

+
+

1.3. SOMEDAY explore additional key themes for lispyville (see 9.2.3)

-
-

2. Useful resources

+
+

2. Useful resources

-
-

3. Early init file

+
+

3. Early init file

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

3. Early init file

-
-

4. Package management

+
+

4. Package management

-
-

4.1. init.el header

+
+

4.1. init.el header

;;; init.el --- Personal configuration file -*- lexical-binding: t; no-byte-compile: t; -*-
@@ -288,8 +288,8 @@ 

4.1. init.el

-
-

4.2. straight.el

+
+

4.2. straight.el

-
-

4.2.1. Bootstrap straight.el

+
+

4.2.1. Bootstrap straight.el

(setq straight-use-package-by-default t) ;; have use-package use straight.el by default.
@@ -356,12 +356,12 @@ 

4.2.1. Bootstrap

-
-

5. Emacs

+
+

5. Emacs

-
-

5.1. Variables

+
+

5.1. Variables

(defvar patrl/library-path "~/Dropbox (MIT)/library/"
@@ -382,8 +382,8 @@ 

5.1. Variables

-
-

5.2. Defaults

+
+

5.2. Defaults

-
-

5.3. Electric

+
+

5.3. Electric

(use-package electric
@@ -468,8 +468,8 @@ 

5.3. Electric

-
-

6. Keybindings

+
+

6. Keybindings

Mnemonic keybindings with SPC as the leader key, inspired by spacemacs and doom emacs. @@ -479,8 +479,8 @@

6. Keybindings

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

-
-

6.1. General

+
+

6.1. General

  • @@ -588,8 +588,8 @@

    6.1. General

-
-

6.2. Evil

+
+

6.2. Evil

-
-

6.2.1. Evil collection

+
+

6.2.1. Evil collection

(use-package evil-collection ;; evilifies a bunch of things
@@ -644,8 +644,8 @@ 

6.2.1. Evil collection

-
-

6.2.2. Evil commentary

+
+

6.2.2. Evil commentary

-
-

6.2.3. Evil surround

+
+

6.2.3. Evil surround

-
-

6.2.4. Evil goggles

+
+

6.2.4. Evil goggles

-
-

6.3. Avy

+
+

6.3. Avy

-
-

6.3.1. Link hint

+
+

6.3.1. Link hint

(use-package link-hint
@@ -782,8 +782,8 @@ 

6.3.1. Link hint

-
-

6.4. Which key

+
+

6.4. Which key

-
-

7. Appearance

+
+

7. Appearance

-
-

7.1. Mode line

+
+

7.1. Mode line

-
-

7.2. Icons

+
-
-

7.3. Olivetti

+
+

7.3. Olivetti

Add some margins (useful for writing prose). @@ -864,8 +864,8 @@

7.3. Olivetti

-
-

7.4. Fonts

+
+

7.4. Fonts

(defun patrl/setup-font-wolfe ()
@@ -898,8 +898,8 @@ 

7.4. Fonts

-
-

7.5. Themes

+
+

7.5. Themes

Visually distinguish between 'real' buffers and everything else. @@ -960,16 +960,16 @@

7.5. Themes

-
-

8. Organization

+
+

8. Organization

-
-

8.1. Buffer management

+
+

8.1. Buffer management

-
-

8.1.1. Popper

+
+

8.1.1. Popper

    -
  1. bufler
    +
  2. bufler
  3. -
  4. Projects
    +
  5. Projects

    Use built in project.el. @@ -1060,7 +1060,7 @@

    8.1.1. Popper

  6. -
  7. File management
    +
  8. File management

    Use built-in dired. @@ -1093,12 +1093,12 @@

    8.1.1. Popper

-
-

9. Languages

+
+

9. Languages

-
-

9.1. Lua

+
+

9.1. Lua

  • Lua-mode
  • @@ -1111,12 +1111,12 @@

    9.1. Lua

-
-

9.2. Lisp

+
+

9.2. Lisp

-
-

9.2.1. Fennel

+
+

9.2.1. Fennel

(use-package fennel-mode
@@ -1125,8 +1125,8 @@ 

9.2.1. Fennel

-
-

9.2.2. Sly

+
+

9.2.2. Sly

;; FIXME - compatibility with corfu
@@ -1135,8 +1135,8 @@ 

9.2.2. Sly

-
-

9.2.3. lispy

+
+

9.2.3. lispy

-
-

9.3. Org

+
+

9.3. Org

-
-

9.3.1. Org mode

+
+

9.3.1. Org mode

Resources: @@ -1271,8 +1271,8 @@

9.3.1. Org mode

-
-

9.3.2. Evil integration

+
+

9.3.2. Evil integration

(use-package evil-org
@@ -1285,8 +1285,8 @@ 

9.3.2. Evil integratio

-
-

9.3.3. Org-auctex

+
+

9.3.3. Org-auctex

Provides faster latex previews for org-mode. @@ -1306,8 +1306,8 @@

9.3.3. Org-auctex

-
-

9.3.4. Transclusion

+
+

9.3.4. Transclusion

-
-

9.3.5. Appear

+
-
-

9.3.6. Cliplink

+
+

9.3.6. Cliplink

(use-package org-cliplink
@@ -1357,8 +1357,8 @@ 

9.3.6. Cliplink

-
-

9.3.7. Org modern

+
+

9.3.7. Org modern

-
-

9.3.8. Org roam

+
+

9.3.8. Org roam

-
-

9.3.9. Export

+
+

9.3.9. Export

(use-package citeproc
@@ -1449,8 +1449,8 @@ 

9.3.9. Export

-
-

9.3.10. Highlighting

+
+

9.3.10. Highlighting

(use-package htmlize)
@@ -1458,8 +1458,8 @@ 

9.3.10. Highlighting

-
-

9.3.11. Org-noter

+
+

9.3.11. Org-noter

(use-package org-noter
@@ -1479,8 +1479,8 @@ 

9.3.11. Org-noter

-
-

9.4. js

+
+

9.4. js

(use-package js2-mode)
@@ -1488,8 +1488,8 @@ 

9.4. js

-
-

9.5. Rust

+
+

9.5. Rust

We'll use rust-analyzer by using rustic with eglot. @@ -1503,8 +1503,8 @@

9.5. Rust

-
-

9.6. TODO haskell

+
+

9.6. TODO haskell

  • Setup LSP
  • @@ -1523,7 +1523,7 @@

    9.6. 10.5.1 to convert dante's company backend to to a capf. +Note that the following uses 10.5.1 to convert dante's company backend to to a capf.

    @@ -1538,8 +1538,8 @@

    9.6. -

    9.7. racket

    +
    +

    9.7. racket

    (use-package racket-mode
    @@ -1555,8 +1555,8 @@ 

    9.7. racket

    -
    -

    9.8. nix

    +
    +

    9.8. nix

    (use-package nix-mode
    @@ -1566,8 +1566,8 @@ 

    9.8. nix

    -
    -

    9.9. SOMEDAY latex

    +
    +

    9.9. SOMEDAY latex

    Useful resources: @@ -1701,9 +1701,9 @@

    9.9. -
  • TODO add "citep" and "citealt" to the supported list of latex citation commands.
  • +
  • TODO add "citep" and "citealt" to the supported list of latex citation commands.
  • -
  • Engrave
    +
  • Engrave

    Uses emacs' font lock to highlight source code blocks in latex. @@ -1715,7 +1715,7 @@

    9.9. TODO latexmk
    +
  • TODO latexmk
    ;; FIXME
    @@ -1731,12 +1731,12 @@ 

    9.9. -

    9.9.1. Issues

    +
    +

    9.9.1. Issues

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

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

      9.9.1. Issues

    -
    -

    9.10. markdown

    +
    +

    9.10. markdown

    (use-package markdown-mode
    @@ -1773,15 +1773,15 @@ 

    9.10. markdown

    -
    -

    10. Completion

    +
    +

    10. Completion

    The completion framework I adopt exploits packages primarily developed by Daniel Mendler.

    -
    -

    10.1. Vertico with orderless and marginalia

    +
    +

    10.1. Vertico with orderless and marginalia

    -
    -

    10.2. Consult

    +
    +

    10.2. Consult

    -
    -

    10.3. Affe

    +
    -
    -

    10.4. Embark

    +
    +

    10.4. Embark

    (use-package embark
    @@ -1905,8 +1905,8 @@ 

    10.4. Embark

    -
    -

    10.5. Corfu

    +
    +

    10.5. Corfu

    A minimal ui for completion-in-region. @@ -1936,8 +1936,8 @@

    10.5. Corfu

    -
    -

    10.5.1. Cape

    +
    +

    10.5.1. Cape

    -
    -

    11. Checkers

    +
    +

    11. Checkers

    • Use flymake over flycheck.
    -
    -

    11.1. Flymake

    +
    +

    11.1. Flymake

    (use-package flymake
    @@ -2016,12 +2016,12 @@ 

    11.1. Flymake

    -
    -

    12. Tools

    +
    +

    12. Tools

    -
    -

    12.1. Recursion indicator

    +
    +

    12.1. Recursion indicator

    -
    -

    12.2. Regular expressions

    +
    +

    12.2. Regular expressions

    Use rx notation (S-expressions) as the default for constructing regular expressions in regex builder. @@ -2052,8 +2052,8 @@

    12.2. Regular expressi

    -
    -

    12.3. PDF tools

    +
    +

    12.3. PDF tools

    Because this uses natively-compiled code, I install this alongside emacs via nix. @@ -2063,13 +2063,23 @@

    12.3. PDF tools

    (use-package pdf-tools
       :straight (:type built-in)
       :mode ("\\.pdf\\'" . pdf-view-mode)
    -)
    +  :config
    +  (require 'pdf-tools)
    +  (require 'pdf-view)
    +  (require 'pdf-misc)
    +  (require 'pdf-occur)
    +  (require 'pdf-util)
    +  (require 'pdf-annot)
    +  (require 'pdf-info)
    +  (require 'pdf-isearch)
    +  (require 'pdf-history)
    +  (require 'pdf-links))
     
    -
    -

    12.4. Jinx

    +
    +

    12.4. Jinx

    -
    -

    12.5. Helpful

    +
    +

    12.5. Helpful

    (use-package helpful
    @@ -2104,8 +2114,8 @@ 

    12.5. Helpful

    -
    -

    12.6. Deadgrep

    +
    +

    12.6. Deadgrep

    -
    -

    12.7. Snippets

    +
    +

    12.7. Snippets

    -
    -

    12.7.1. Auto-activating snippets

    +
    +

    12.7.1. Auto-activating snippets

    (use-package aas
    @@ -2218,8 +2228,8 @@ 

    12.7.1. Auto-activatin

    -
    -

    12.7.2. TODO yasnippet

    +
    +

    12.7.2. TODO yasnippet

    Deprecate in favour of tempel. @@ -2235,8 +2245,8 @@

    12.7.2. -

    12.7.3. Tempel

    +
    +

    12.7.3. Tempel

    -
    -

    12.8. Web preview

    +
    +

    12.8. Web preview

    (use-package simple-httpd
    @@ -2274,8 +2284,8 @@ 

    12.8. Web preview

    -
    -

    12.9. Magit

    +
    +

    12.9. Magit

    (use-package magit
    @@ -2287,8 +2297,8 @@ 

    12.9. Magit

    -
    -

    12.10. Eshell

    +
    +

    12.10. Eshell

    (use-package eshell
    @@ -2300,12 +2310,12 @@ 

    12.10. Eshell

    -
    -

    12.11. Language servers

    +
    +

    12.11. Language servers

    -
    -

    12.11.1. LSP mode

    +
    +

    12.11.1. LSP mode

    Note I still need to set keybindings @@ -2339,8 +2349,8 @@

    12.11.1. LSP mode

    -
    -

    12.11.2. Eglot

    +
    +

    12.11.2. Eglot

    -
    -

    12.12. direnv

    +
    +

    12.12. direnv

    Essential, since I'm on NixOS. @@ -2373,8 +2383,8 @@

    12.12. direnv

    -
    -

    12.13. Kmonad

    +
    +

    12.13. Kmonad

    (use-package kbd-mode
    @@ -2383,12 +2393,12 @@ 

    12.13. Kmonad

    -
    -

    12.13.1. TODO disable flymake mode in kbd-mode

    +
    +

    12.13.1. TODO disable flymake mode in kbd-mode

    -
    -

    12.14. TODO Elfeed

    +
    +

    12.14. TODO Elfeed

    Resources: @@ -2430,8 +2440,8 @@

    12.14. -

    12.15. TODO Notmuch

    +
    +

    12.15. TODO Notmuch

    A gmail-focused notmuch setup, with lieer as the sync backend. @@ -2476,12 +2486,12 @@

    12.15. -

    12.15.1. TODO figure out why sent mail is saved to the home folder

    +
    +

    12.15.1. TODO figure out why sent mail is saved to the home folder

    -
    -

    12.15.2. consult-notmuch

    +
    +

    12.15.2. consult-notmuch

    Search emails interactively using consult. @@ -2501,12 +2511,12 @@

    12.15.2. consult-notmu

    -
    -

    13. Staging grounds

    +
    +

    13. Staging grounds

    -
    -

    13.1. Rainbow mode

    +
    +

    13.1. Rainbow mode

    (use-package rainbow-mode)
    @@ -2514,8 +2524,8 @@ 

    13.1. Rainbow mode

    -
    -

    13.2. Burly

    +
    +

    13.2. Burly

    (use-package burly
    @@ -2531,8 +2541,8 @@ 

    13.2. Burly

    -
    -

    13.3. Ebib

    +
    +

    13.3. Ebib

    • Ebib
    • @@ -2550,12 +2560,12 @@

      13.3. Ebib

    -
    -

    13.3.1. TODO add biblio support

    +
    +

    13.3.1. TODO add biblio support

    -
    -

    13.4. Tree-sitter

    +
    +

    13.4. Tree-sitter

    (use-package tree-sitter)
    @@ -2565,15 +2575,15 @@ 

    13.4. Tree-sitter

    -
    -

    14. Graveyard

    +
    +

    14. Graveyard

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

    -
    -

    14.1. Mastodon

    +
    +

    14.1. Mastodon

    (use-package mastodon
    @@ -2584,8 +2594,8 @@ 

    14.1. Mastodon

    -
    -

    14.2. 0x0

    +
    +

    14.2. 0x0

    (use-package 0x0
    @@ -2602,8 +2612,8 @@ 

    14.2. 0x0

    -
    -

    14.3. Org-re-reveal

    +
    +

    14.3. Org-re-reveal

    (use-package org-re-reveal)
    @@ -2611,8 +2621,8 @@ 

    14.3. Org-re-reveal

    -
    -

    14.4. Org-present

    +
    +

    14.4. Org-present

    (use-package org-present)
    @@ -2620,8 +2630,8 @@ 

    14.4. Org-present

    -
    -

    14.5. Sidebar

    +
    +

    14.5. Sidebar

    (use-package org-sidebar
    @@ -2631,8 +2641,8 @@ 

    14.5. Sidebar

    -
    -

    14.6. company

    +
    +

    14.6. company

    (use-package company
    @@ -2659,7 +2669,7 @@ 

    14.6. company

    Author: Patrick D. Elliott

    -

    Created: 2023-10-18 Wed 11:07

    +

    Created: 2023-10-27 Fri 11:43

    Validate

    diff --git a/init.el b/init.el index b665711..ea1c5e4 100644 --- a/init.el +++ b/init.el @@ -953,7 +953,17 @@ (use-package pdf-tools :straight (:type built-in) :mode ("\\.pdf\\'" . pdf-view-mode) -) + :config + (require 'pdf-tools) + (require 'pdf-view) + (require 'pdf-misc) + (require 'pdf-occur) + (require 'pdf-util) + (require 'pdf-annot) + (require 'pdf-info) + (require 'pdf-isearch) + (require 'pdf-history) + (require 'pdf-links)) (use-package jinx :straight (:type built-in)