Literate emacs config as a webpage

A fun new project

With unclear readership, I’m starting my tech blog about emacs, python, and machine learning. I hope that others enjoy my tips and perspective, but I’m mostly excited to gain some skills around web technologies and social media (not the instagram kind).

For a few years, I’ve been sharing my emacs configuration on github. I make this public, but its real use is that I can clone and track this across different machines. Less than a year ago, I migrated to literate elisp so that I could weave comments in with the lisp code. Who doesn’t love an excuse to learn org mode a little better?

Most recently, I played with github actions to release a tangled version of the entire configuration code, and I share it on this website as a project. Take a look, there are about 10 years of tinkering in that one document. Tinkering from grad school, through a postdoc, and continued as a professional.

Already good for

  • Easily reviewable and consumable
  • Syncs with the latest commit of the `main` github branch
  • Web searchable

Todos

  • Add better comments to the code and explanations about what I like and don't like
  • Make org export whether a code block is loaded at run time or not. Many of the blocks seen in the web page are vestigial, and not loaded at startup
  • Explain how I made scripts and github actions to sync the project document to the latest export of literate elisp
  • Learn footnotes in Jekyll to ape David Foster Wallace
  • Make the web page re-build on every release action of the config repo
  • Find a way to link to subsections of the web version from blog posts



Enjoy Reading This Article?

Here are some more articles you might like to read next:

  • Unison Sync in Emacs
  • Studying Eigenvalues of Rotation Group Matrices
  • Why we can interpret softmax scores as probabilities
  • Indicating which blocks are loaded in webpage literate elisp
  • Hosting my CV with github actions