Programming-related ideas and writings.

How This Site is Made

Mar 16, 2024

I provide this page here in case you are wondering how this site is made. It's fairly simple, but requires some explanation.

I'm a web developer by trade, but I think much of the industry has fallen victim to overkill, over-engineering, and bloat. I don't want to learn another framework. I don't want to figure out another templating system. I don't want to fiddle around with a static site generator. Don't get me wrong, some of the stuff out there is great, but at the end of the day, this site just has to display requested content and allow me to update it quickly and regularly.

Currently, all content on this site is static. The blog articles are written in markdown. The pages are written in plain HTML. I use Tailwind for styling because it's just that easy. There's a small script that generates the blog HTML from markdown files, and the site is currently hosted by GitHub Pages.

Blog Posts

Posts are written in markdown and converted to HTML with marked. The conversion is part of the build process and the rendered HTML files get placed in docs/blog.

I use a simple template page where each blog post is fed into. What's nice about this is that, by wrapping the template page in a blog-page CSS class, I can easily target the rendered blog post HTML for styling like so:

.blog-page h1 {
  @apply text-4xl font-bold py-2;

.blog-page h2 {
  @apply text-2xl font-bold py-2;

.blog-page a {
  @apply text-blue-500;