ngublag.com

A personal blog built with Hakyll, a static site generator written in Haskell.

Prerequisites

You need GHCup to install the Haskell toolchain (GHC and Cabal):

curl --proto '=https' --tlsv1.2 -sSf https://get-ghcup.haskell.org | sh

Setting Up

Install GHC and Cabal:

ghcup install ghc
ghcup install cabal

Any recent GHC 9.x and Cabal 3.x will work.

Alternative: Nix

If you prefer Nix, the repo includes a shell.nix that provisions GHC 8.8.3, Cabal, Hakyll, and ghcid:

nix-shell

Building the Site

# Build the site executable
cabal v2-build

# Generate the static site
cabal v2-run site build

The compiled site will be output to the _site/ directory.

Creating a New Blog Post

Blog posts are stored in the posts/ directory and follow the naming convention:

YYYY-MM-DD-post-title.md

or

YYYY-MM-DD-post-title.markdown

Post Format

Create a new file in posts/ with YAML frontmatter:

---
title: "Your Post Title"
---

Your post content here written in Markdown.

After creating a new post, rebuild the site:

cabal v2-run site build

Development

Watch for changes and rebuild automatically:

cabal v2-run site watch

Deployment

Deploy to production server (requires NGUBLAG_PEM_KEY environment variable):

./deploy.sh

This uses rsync to sync the _site/ directory to the remote server.

Project Structure

.
├── site.hs              # Main Hakyll configuration
├── ngublag-com.cabal    # Cabal package file
├── shell.nix            # Nix shell configuration
├── posts/               # Blog posts
├── templates/           # HTML templates
├── css/                 # Stylesheets
├── images/              # Images
├── js/                  # JavaScript files
└── _site/               # Generated site (build output)