integralist.co.uk

A technical blog featuring a bespoke Static Site Generator written in Go.

[!TIP] Can also be accessed via integralist.netlify.app

Architecture

This project uses a custom SSG to convert Markdown files into a high-performance, SEO-friendly static website.

• Frontend: Vanilla HTML and CSS (no frameworks, no JavaScript).
• Backend: Custom SSG written in Go (v1.26+), utilizing github.com/gomarkdown/markdown.
• Templates: Standard Go html/template.
• Deployment: Automatically built and hosted on Netlify.

Getting Started

Prerequisites

• Go 1.26 or higher
• Make

Local Development

1. Build the site:

   make build
   

   This compiles the SSG and generates the static files into the public/ directory.

2. Preview the site:

   make serve
   

   This builds the site and starts a local development server at http://localhost:8080.

3. Run tests:

   make test
   

4. Clean build artifacts:

   make clean
   

Project Structure

• assets/: CSS, images, and HTML templates. -…