This document describes the architecture of the rocasta.com static site.
1. Technology Stack
Static Site Generator: Hugo (Extended) v0.164+
Theme: PaperMod (customised:
custom.css)Content Format: AsciiDoc (processed by Asciidoctor)
Deployment: GitHub Pages via GitHub Actions
Local Development: Hugo development server with live reload
2. Directory Structure
| Path | Purpose |
|---|---|
| Blog posts in AsciiDoc |
| Architecture and build documentation |
| About page |
| Static images served at |
| Git submodule for theme |
| Built site output (gitignored) |
3. Content Model
Each post is a standalone AsciiDoc file in content/posts/ with Hugo YAML front matter:
---
title: "Post Title"
date: 2026-07-07
tags: [tag1, tag2]
showToc: true
---Images are placed in static/images/<post-name>/ and referenced via image: macro with :imagesdir: pointing to /images/<post-name>.
AsciiDoc attributes that must be set per-post when using images:
:imagesdir: /images/<post-name>4. Theme Architecture
PaperMod provides:
Dark/light/auto theme toggle
Responsive design
Taxonomy support (tags, categories)
Table of contents
Code copy buttons
Social share buttons
The theme has been significantly modified in the In addition, the colour scheme has been modified to reflect the neovim |