Creating This Website
I wanted to create a super simple website that is easy to maintain and easy to add content to. You are reading this on the finished product, here is what makes it tick.
My searches started looking around for static website generators (I was hoping that I could run this without a database and all that jazz that normally gets dragged along) and stumbled upon Hugo whose GitHub README describes it as
A Fast and Flexible Static Site Generator built with love by bep , spf13 and friends in Go .
This immediately ticked a few boxes for me being a Go fan, being able to keep everything in version control and write my posts in markdown. I dived right in by following the Quick Start and was up and running in a couple of minutes. Very awesome developer experience.
After reading How to start a blog using Hugo I fiddled around with a few of the themes available, initially choosing anatole to get something up and running.
The basics
With my initial investigations running on my local machine, the time for continuous deployment had arrived! First step: Get the code into version control… For me this means creating repo on GitHub
and pushing my initial code to main
.
For the deployment of the website I decided to use Netlify . It’s awesome and has a great developer experience - essentially add the site, linking your repo on GitHub (or other supported version control), Hugo gets picked up automagically and after hitting Deploy Site! you will be up and running in less than a minute. There is a Step-by-Step Guide to get you on your way if you get stuck.
I gave my site a nice name (rick-roche) to test using rick-roche.netlify.app
immediately and pointed my domain to the Netlify name servers (DNS propagation time can take up to 72 hours) for this site to be live.
Finishing up
There were a few features I was looking for such as search, extended markdown for adding copyable code snippets and the ability to add tips and notes like I am used to doing when using Confluence for work. I found the LoveIt theme while browsing through the Hugo Themes which had everything I was looking for.
A few updates later (LoveIt has a lot of configurable options), code pushed to GitHub and an automatic deployment thanks to Netlify and you are looking at the results.
Allowing Hugo and Netlify to do the heavy lifting I have ended up with a website that
- uses an open-source web framework (I like to be able to see the code)
- allows me to easily write content using markdown
- has continuous deployment for rapid publishing
- my entire website can live in version control
References
I googled and read a bunch as I hacked my way through getting this site up. Here are links to the content that stood out!
- Hugo
- Hugo Themes (I used the awesome LoveIt theme
- Start a blog with Hugo
- Hugo best practices
- A Step-by-Step Guide: Deploying on Netlify
Featured image background by NihoNorway graphy on Unsplash .