blog.puzzmo.com

Puzzmo Blog

How to get started

1. Install Hugo

   On a Mac with Homebrew, you can run brew install hugo.

2. Clone this repo

   git clone https://github.com/puzzmo-com/blog.puzzmo.com
   cd blog.puzzmo.com

3. Run the server

   hugo server -D

4. Open the site in your browser: http://localhost:1313/

How to make a new post

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 change my-post to be a cool URL. Next: set up the metadata at the top of the index.md to include your name, the tags and the theme.

+ authors = ["orta"]
+ tags = ["changelog"]
+ theme = "puzzmo-light"

You can see the themes here.

How do we handle separate sections?

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/

This blog

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).