About this website
How I built this site and what runs it.
The first commit to this site was on July 3, 2019.
This site is built with the static site generator Jekyll. Static site generators are generally simple with no databases, comment moderation, or updates to manage—just your content. Jekyll is built with Ruby and utilizes Ruby gems. It keeps articles in either plain HTML or Markdown.
Jekyll is supposedly slower at scale compared to newer generators such as Hugo but it works plenty fine for me.
The dev environment setup is annoying for Ruby. Some gem not wanting to install or updates always leads to Googling multiple issues before figuring it out.
I use Google Chrome, VS Code, and Github Desktop on my 2018 MacBook Pro (Yes I am that lazy. It’s faster than changing the directory 5 times). I would like to set up some remote dev environment but I have yet to find an easy free solution to do so.
I host my website directly on Github Pages. Hosting this way means I don’t have to worry about payments but utilization will suffer if I need to scale distribution.
Did I mention it’s free?
I have four YAML data files: booklist, links, principles, and resources.
I wrote how I made a book list with only ISBNs because finding all that information is too annoying for me.
Jekyll supports YAML for it’s
_datadirectory and the structure is relatively simple. To add a book the only thing I need to find is the ISBN code. Everything else auto populates from that.”
Here’s a preview of how each YAML file is structured:
As a designer, the way this site is presented is an ever-changing portfolio piece of sorts. As such I prefer to not see any clones online. Feel free to take it as inspiration and make your spin on it.
This theme is also built in a needs-based hacky way that’s a hassle to replicate.
If I Had Time I Would
- Free and easy responsive images
- Redo inline styles and CSS (again)
- Recreate portfolio section