summaryrefslogtreecommitdiffhomepage
path: root/readme.org
blob: c0ce607497fada821d0195dbafefe23d982fcb6b (plain)
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
#+title: Emacs configuration and personal packages
#+PROPERTY: header-args :tangle ~/.emacs.d/init.el :comments yes :results silent

* Bootstrap
  This is the emacs standard init file, which will load (maybe
  tangled) [[./init.org][init.org]] the file, checking first whether a fresh tangle is
  needed.  Note that the rest of elisp tangling in init.org goes to a
  different file (namely, the one that is loaded by
  =~/.emacs.d/init.el=).  However, also note that if [[https://github.com/jingtaozf/literate-elisp/blob/master/literate-elisp.org][literate-elisp]] is
  installed, we load instead directly the org file.  It's because of
  that that we start by setting up packages.

  Here's the directory where a checkout of this repo live:

  #+begin_src emacs-lisp
    (defvar jao-emacs-dir (expand-file-name "~/etc/emacs"))
  #+end_src

  followed by package.el's initialisation:

  #+begin_src emacs-lisp
    (setq package-user-dir
          (expand-file-name (format "~/.emacs.d/elpa.%s" emacs-major-version))
          package-check-signature 'allow-unsigned)

    (require 'package)
    (dolist (a '(("melpa" . "https://melpa.org/packages/")
                 ("org" . "https://orgmode.org/elpa/")))
      (add-to-list 'package-archives a t))

    (package-initialize)
  #+end_src

  and a tangling helper:

  #+BEGIN_SRC emacs-lisp
    (defun jao-maybe-tangle (basename)
      (let ((el (expand-file-name (format "%s.el" basename) jao-emacs-dir))
            (org (expand-file-name (format "%s.org" basename) jao-emacs-dir)))
        (when (file-newer-than-file-p org el)
          (require 'ob-tangle)
          (org-babel-tangle-file org el))
        el))
  #+end_src

  Finally, we load either init.org or its tangled version from
  ~jao-emacs-dir~:

  #+begin_src emacs-lisp
    (if (require 'literate-elisp nil t)
        (literate-elisp-load-file (expand-file-name "init.org" jao-emacs-dir))
      (load-file (jao-maybe-tangle "init")))
  #+end_src

  You can tangle this readme to generate the minimal init.el file above.

* Configuration as a set of literate files

- [[./init.org][init.org]]: main configuration as a literate org file; it uses
  (besides lots of packages), many of my libraries in [[./lib][lib]], and loads
  on demand the other org files below.
- [[./org.org][org.org]] org mode configuration.
- [[./consult.org][consult.org]]: completion setup using selectrum, consult and friends.
- [[./counsel.org][counsel.org]]: completion setup using ivy, counsel and friends.
- [[./blog.org][blog.org]]: blogging using org-static-blog.
- [[./gnus.org][gnus.org]]: tangled to gnus.el automatically by init.org, so that it's
  ready for loading by Gnus.
- [[./w3m.org][w3m.org]]: configuration for emacs-w3m.
- [[./exwm.org][exwm.org]]: configuration for exwm, loaded when ~jao-exwmn-enable~ is
  called.