Writing a SSG in Go

Overview

Ever since I read this article Writing a Static Blog Generator in Go by @zupzup a few years ago, I've been wanting to do the same.

After not doing it for a few years just like a lot of things in my life rn, I finally gave it a try.

What I Created

Here is the core package(SSG)

go install github.com/K-Sato1995/go-simple-ssg/simple-ssg-cli@latest 

simple-ssg-cli init 

./ ├── contents/ (Stores markdown files) ├── templates/ (Stores template html files and style files) ├── generated/ (Stores generated files) ├── go.mod ├── go.sum └── main.go 

go run main.go 

and here is a static site I created using the ssg.

https://go-simple-ssg.vercel.app

Structure

The core package mainly consists of two parts

• Generator: Generate static files based on Markdown and Templates(HTML) files.
• CLI: Allows anyone to bootstrap a project.

The core packages looks like this

./ ├── parser/ (Part that parses Markdown into HTML) │ ├── mdToHTML.go │ └── parseMetaData.go ├── builder/ (Part that generates static files based on the given md and templates) │ ├── bundleCss.go │ ├── copyStaticFiles.go │ ├── generateDetail.go │ └── generateList.go ├── simple-ssg-cli/ (CLI that allows anyone to bootstrap a project) ├─ example/ ├── config/ (Part that makes the project custamizable for users) └── engine.go 

To use it, install the simple-ssg-cli and execute the init command.

$ go install github.com/K-Sato1995/go-simple-ssg/simple-ssg-cli@latest $ simple-ssg-cli init 

Doing this will create a new project with the following structure:

./ ├── contents/ (Stores markdown files) ├── templates/ (Stores template html files and style files) ├── generated/ (Stores generated files) ├── go.mod ├── go.sum └── main.go 

Lastly, move to the newly created project and run it to build static contents and stuff.

$ cd your_project && go run main.go 

Random Thoughts

Doing this made me appreciate existing SSGs like Hugo and Next.js even more👏👏

Cool existing SSGs written in Go

• Hugo
• zupzup/blog-generator
• plentico/plenti
• darccio/zas
• zserge/zs