About this website
Planted 02020-04-17
How I built this site and what runs it.
The first commit to this site was on July 3, 2019.
Jekyll
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.
Dev Environment
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.
Host
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?
Data Files
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
_data
directory 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:
booklist.yaml
links.yaml
principles.yaml
resources.yaml
Javascript
I have some leftover Javascript from the original Jekyll template I started with but other than the short script for my analytics tool of choice GoatCounter and the mobile menu navigation I don’t write any Javascript.
Since the original inspiration of this website was the MF website, I never planned on adding any external Javascript libraries.
Theme
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