static sites

Musings and tutorials about building websites using static site generators (SSG) and what is commonly referred to as the jamstack.

Tutorials for leveling-up your Jekyll skills can be found in my Mastering Jekyll series of guides.

URLs and links in Jekyll

How Jekyll uses URLs and how to link posts, pages, assets, and other resources together.
read more →

Jekyll’s site.url and baseurl

Learn what Jekyll's site url and baseurl variables are and how to properly set them with relative_url and absolute_url filters to avoid broken links and 404 errors.
read more →

Twenty Nineteen

First time doing a year in review post. The statistics contained are just for fun as there's nothing to compare them against yet.
read more →

Autumn refresh

Using CSS Grid Layout Module to redesign a Jekyll site and further improve performance and accessibility.
read more →

Optimizing and automating my Jekyll site build

Lessons learned from building, optimizing, and deploying a huge static site with everyone's favorite SSG — Jekyll.
read more →

Styling language specific code blocks with Jekyll

Interesting styling possibilities with Kramdown syntax highlighted code blocks in Jekyll.
read more →

Accessing static files in Jekyll

Learn how to use static files with Jekyll to create a gallery of images automatically without a plugin.
read more →

Improving Staticman comments on a Jekyll site

How to use Staticman to add threaded comments and reply notifications to a static-based Jekyll site.
read more →

HTML inside Kramdown table cells with Jekyll

The question of how to write a list inside of a table cell with Kramdown recently came up in a thread on Jekyll Talk — prompting me to look…

read more →

Using SSI to detect cookies

In my never ending quest to micro-optimize the hell out of my site, I ran into a snag when trying to use SSI directives to improve the loading of critical CSS and cached stylesheets.
read more →

Adding comments to a Jekyll site with Staticman

Uninstall Disqus and learn how to add a static-based commenting system to Jekyll with Staticman.
read more →

How I'm using Jekyll in 2016

Documenting my approach to using Jekyll, how that's evolved over the years, and web development learnings I've picked up along the way.
read more →

Building a living style guide with Jekyll

How I used Jekyll to build a living style guide and pattern library for Made Mistakes.
read more →

Going static: Using Jekyll without a CMS

Migrating Made Mistakes from a Wordpress powered website back to its static file roots using Jekyll without a CMS.
read more →