Puzzmo Blog
-
Install Hugo
On a Mac with Homebrew, you can run
brew install hugo
. -
Clone this repo
git clone https://github.com/puzzmo-com/blog.puzzmo.com cd blog.puzzmo.com
-
Run the server
hugo server
-
Open the site in your browser: http://localhost:1313/
Use the CLI:
hugo new posts/[year]/[month]/[day]/[post name]/index.md
A C&P example which does the dates for you:
hugo new posts/$(date +%Y)/$(date +%m)/$(date +%d)/my-post/index.md
Then just change my-post
to be a cool URL!
Right now, via tags:
+++
title = 'How the Puzzmo API handles integrations on a per-game basis'
date = 2024-04-08T12:00:32Z
authors = ["orta"]
tags = ["tech", "api", "plugins"]
theme = "outlook-hayesy-beta"
+++
This post would appear in 3 sections: tech, api and plugins. Which have their own url: https://blog.puzzmo.com/tags/tech/
It uses Hugo as a static site generator, it was chosen because it is is simple to install and run locally and shouldn't break over a very long time period (the Artsy blog I used to write on once or twice a month was Jekyll and required a lot of custom work to get useful features but those eventually started slowing the system down and getting ruby set up is a pain).