Setting Up My Blog

- 4 minutes read

Introduction

For the past few days, I’ve been working on a project where one of the features is authentication and authorization using OpenID Connect, and Keycloak is the service that was chosen to perform this role.

Today, I was trying to find some resources explaining how to use Keycloak properly, because I implemented everything and wanted to see if there were some improvements I could make. I came across this post after some research on google.

While this post didn’t really help me find what I was looking for, I noticed that the blog it was part of was hosted on github pages (due to the github.io domain). So naturally, I branched off my current course of action and looked at the repository of the blog’s owner and I discovered that it was created using Hugo.

I was very intrigued by how seemingly easy Hugo makes it to create static websites so I got the idea of using it to make my own blog, and here we are!
P.S.: I did compare different Static Site Generators ( Gatsby, Jekyll, Next.js, Hugo, Eleventy/11ty, Zola ) they all seemed quite similar, and while Hugo did have quite a bit of criticism in the sources I checked, I still chose it, mostly because I already got familiar with it by checking out the repository of the blog I stumbled upon.

How I set it up

The setup process was pretty straightforward, I just followed the instructions in:

I did encounter some new concepts like:

Anyways, I’m not exactly sure what I wanna do with this blog, but it was a fun experience just setting it up!

Quick references

Commands

# Adding the submodule repository
git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke

# Create a new post
hugo new posts/<post-name>.md
hugo new content posts/<post-name>.md

# Start live server with drafts enabled
hugo server -D
hugo server --buildDrafts

# After cloning a repository with a submodule
git submodule update --init --recursive