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 likeMake 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 startupExplain 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: