jwogrady Work, evidence, and what I make of it
Technical reference

The theme, and where it ends

What Spectrum renders, what this site owns, and how the pinned theme is updated.

jwogrady

The theme is hugo-spectrum, vendored as a git submodule at themes/hugo-spectrum.

What it does and does not own

It owns presentation. It carries no content types, no taxonomy and no URL structure — those are declared in hugo.toml here. That is why the [taxonomies] and [menus] blocks live in this repo.

The homepage selects the configured Journal section (posts here). Lab Notes have a separate section and chronological log layout. Both use the same publication typography, metadata and subject indexes, but the homepage and its RSS feed remain Journal-only. Tags, archives and projects can include both writing types and label the records explicitly.

Config it will not build without

timeZone = 'America/Chicago'
[params.spectrum]
  timezone = 'America/Chicago'   # must equal the above

Unset, Hugo uses the build machine’s zone, and the same commit renders different times on a laptop and in CI. The theme fails the build rather than let that happen.

Cloning this repo

git clone --recurse-submodules <url>

Without --recurse-submodules the themes/ directory is empty and the build fails in a way that reads like a content problem. To fix an existing clone:

git submodule update --init --recursive

Updating the theme

cd themes/hugo-spectrum && git pull origin master && cd -
git add themes/hugo-spectrum && git commit -m "chore: update theme"

The submodule pins a commit. Nothing changes until that pin moves.

Overriding it

Project files beat theme files at the same path. layouts/page.html here wins over themes/hugo-spectrum/layouts/page.html entirely — there is no merging, so an override is a fork of that one file and stops receiving theme updates to it. Override as little as possible.

The params it actually reads

accentHue used to be documented here as “one knob, the whole palette derives from it”. The theme does not read it. It appears once in the theme’s own hugo.toml and in no layout, partial or stylesheet, so setting it in this repo changes nothing. It has been removed from this page rather than left to mislead the next person who wants to change the colour.

The palette is chosen by name:

[params.spectrum]
  palette = ''      # '' for the default, 'ultraviolet' for the preset

Everything under params.spectrum the theme reads, as of hugo-spectrum v0.7.0 — grep the layouts before trusting this list, it is a snapshot:

Key What it does
owner, standfirst, copyright, footerNote Masthead and footer text
palette, theme, css Presentation selection
timezone, zones, tz The clock, and the zone every date renders in
entryAside Keeps the clock, spectrum and archive beside a flat entry
tagHueSpan, tagBandCeiling, tagRotate, tagRotateSeconds How the subject index colours and cycles
banners, disallow Page banners; robots exclusions
themeCredit The credit line in the footer
journalSection, labSection The Journal collection and the working-log section; defaults posts, lab-notes

The Docs section opts into preview rows with previews = true. Images come from explicit preview, cover or featured_image fields, in that order. No image means a typographic plate, not a broken image or a made-up cover. The theme resizes local raster images; it does not fetch remote images or convert downloadable documents.