This Website 🌐

I love typesetting tools. In my experience, I have used and written articles and papers using the following list of tools: LaTeX, groff, markdown, Org-Mode, asciidoctor, HTML, plain text. I had to decompress Word files and wrestle with raw XML files there, what a trip that was.

You might be interested in how this website is built. Basically, the whole of this website is a collection of Org Mode files, couple of sed scripts, some shell, and a master makefile. Makefile converts my raw org mode files into asciidoctor with pandoc, sed scripts modify the asciidoctor files, then asciidoctor binary is called to generate HTML, and another sed script to modify the generated files, like adding CSS and some custom meta tags.

The repository is hosted on Github. source branch is the one that contains all the source org files, on every commit push, a github workflow is triggered that runs everything above and deploys the generated website to master branch, where it triggers Github Pages to build the branch and deploy it here.

Below is a good flow graph of files and operations. Just to solidify the structure of the website, here is the source org file for this webpage.

Leave a Comment