Website Renovation
Introduction
I recently rebuilt my website using Org Mode. I also added to the scope of this site to include my personal notes and dot files.
What was wrong with the old site?
My previous static site generator was written in Go and used TOML for the markup. While I felt it was easy enough to make posts with that system, org mode markup is just much more suited to writing.
I also had started learning about literate programming as a method to help retain information I learn and it opened my eyes to the possibilities of org mode files. Org Babel in particular allowed me to unify both my code and documentation into a single file. Being able to use org mode files to generate tables and charts from code really seems like a killer app.
Lastly I started using Emacs for everything so using org mode started make even more sense.
How does the new site work?
The new site is a git repo with various org files organized into folders. Currently I have folders for blog posts, config files and general notes. The notes and blog posts are actually stored in a separate git repo that I use git submodule to embed. The details on how org will build this site are stored in an org file that is part of my notes. That file contains the CSS and Emacs Lisp code that is used to publish this site. I use org-babel-tangle to build the CSS file and build-site.el. Once the site has been built I make a tarball out of the public folder and upload it to sourcehut.