dpritchett.net HOWTO

This is the Hugo source for dpritchett.net.

Generated output is published from the public/ submodule, which points at git@github.com:dpritchett/dpritchett.github.io.git (see live repo here: https://github.com/dpritchett/dpritchett.github.io).

Setup

Install Hugo:

brew install hugo
hugo version

This repo expects Hugo 0.163.3.

Initialize the generated-site submodule:

git submodule update --init --recursive

Make A New Post

Create a draft:

hugo new content posts/my-post-title.md

Edit the front matter at the top of the file:

+++
title = "My Post Title"
date = 2026-07-02T15:45:00-05:00
draft = true
tags = ["example"]
categories = []
+++

Write Markdown below the front matter.

Preview drafts:

hugo server -D -t hugo-kiera

Publish the post by changing:

draft = false

Then run:

make smoke
make build

Edit Topbar Pages

Topbar pages are regular content pages with menu = "main" in their front matter.

Current pages:

• content/about/index.md
• content/book/index.md
• content/resume/index.md

Example front matter:

+++
draft = false
title = "About Me"
linkTitle = "About"
menu = "main"
meta = "false"
+++

title controls the page heading. linkTitle controls the nav label when present.

Edit Or Replace The Theme

The current theme is vendored at:

themes/hugo-kiera/

Important files:

• themes/hugo-kiera/layouts/partials/header.html
• themes/hugo-kiera/layouts/partials/footer.html
• themes/hugo-kiera/layouts/partials/meta.html
• themes/hugo-kiera/layouts/index.html
• themes/hugo-kiera/layouts/_default/single.html
• themes/hugo-kiera/static/css/styles.css

The active theme is selected in config.toml:

theme = "hugo-kiera"

If replacing the theme, update theme, then smoke test:

make smoke

Static Files

Static files go under:

static/

They are copied directly to the site root.

Examples:

• static/images/... becomes /images/...
• static/audio/smb2jazz.mp3 becomes /audio/smb2jazz.mp3
• static/learning/index.html becomes /learning/

Preview Generated Output

Build into public/:

make build

Serve the generated site exactly as it would be deployed:

python3 -m http.server 4173 --directory public

Open:

http://localhost:4173/

Deploy

Deploy only after reviewing the generated site:

make deploy

make deploy builds the site, commits and pushes public/, then commits and pushes the updated public submodule pointer in this repo.

Check GitHub Pages:

gh run list --repo dpritchett/dpritchett.github.io --limit 5