Blog  Talks  Resources  Reading List

How to make this blog

Disclaimer: When written, this blog was using a different theme. The same principles still apply.

For a long time, I thought creating a personal website was too intimidating, too cumbersome, or too much trouble. When I read other people’s blogs, the authors never mentioned how they made the blog, which made me think it was effortless for them.

No more! Certainly every blog is different, but here’s how I made this one.

If I can do it, you (yes you!) can make a blog too.

Envy is a great motivator

If you’re nervous about working with code, feel free to check out Medium or Wordpress. But if you want more freedom—to make things simpler or more complicated—read on.

Thanks to open source communities, we can now shamelessly rip off other people’s blogs. In particular, Jekyll has become a popular static site generator useful for building websites out of Markdown and sharing them with others.

This Lagom template is courtesy of Matt Swanson, an Indiana software engineer.

I chose Matt’s template because of a few key factors:

  1. it’s beautiful
  2. more specifically, clean, readable format
  3. the ability to list all blog posts on one page
  4. clear instructions on how to install the blog

The last one is particularly important since previous attempts to set up a blog derailed based on unclear instructions. We all start somewhere, and if you don’t have a good guide, you’ll end up with a half-built website.

Look around the web for other Jekyll themes you like. All Jekyll sites have similar installation instructions; the best way to motivate yourself through the agony that is front-end development is to have a beautiful website that you’re working towards.

Start “borrowing”

Let’s start stealing! I mean, downloading through open source. Note that we are assuming that you have Github at this point.

If any part of that went wrong, don’t be afraid to Google the problem since thousands of people have probably ahd the same problem.

In the spirit of transparency, here are a list of problems I ran into at this point

The fun part

At this point, you have a working website on your local computer. I’ll pause here for you to do a little dance.

You now get to make the website more “you.” Love orange? Change the theme color to orange. Most of the customizations you want are in _data/theme.yml like name, accent color, and social media links.

You might also want to change the sidebar in _includes/sidebar.html to add your bio and a logo. Because graphic design completely bores me, I uploaded a doodle of a robot reading a book instead.

Beyond the basic changes, you can consider more advanced modifications

Bring it online

There are a couple ways to take this beautiful site that exists on your computer onto the internet. One option here is to deploy it using Github Pages, which is easy and free. Simply rename the repository on Github to be, and you’ll be able to see your site live.

Another slightly more pro-option is to host it on your own domain. That’s what is doing for me. It is not free ($12/year for me) and a tiny bit harder.


And that’s it! In the end, web development and deploying your website is not difficult for the brain, just difficult for the patience. You will have your website crash or deviate from these “simple” instructions. Don’t be afraid to take a deep breath or even start from the beginning.

Now that you’ve made a website, nothing can stop you.

Written on Jul 28, 2017.