jwogrady Work, evidence, and what I make of it

Lab Notes

The working notebook. Short observations, experiments, configuration discoveries, troubleshooting notes, and open questions — dated to the minute, kept rough on purpose.

Lab Notes are source material. Where a note’s experience turned into something a reader can carry outside the tool, the resulting Journal article will cite the notes beneath it. Where the record stays a record, it stays here.

resolves JRN 26-015

Two config directories, and I would have edited the wrong one

Lab note

Two config directories

  • I sat down to add the editor settings I’d written up in JRN 26-008 and found ~/.config/zed/ sitting there — existing, correctly named, and completely empty.

    Terminal output: zero files in ~/.config/zed, while the Windows AppData Zed folder holds settings.json, snippets and themes, and five installed extensions.
    Zero files on the Linux side. Everything on the Windows side.Screenshot
  • Zero files.

  • Meanwhile AppData/Roaming/Zed/ has the settings.json I’ve apparently been editing all along, and AppData/Local/Zed/extensions/installed has five extensions I don’t remember installing individually.

zed wsl silent-failure

resolves JRN 26-014

The feature I chose the theme for does not work on one post

Lab note

Why I picked this theme

  • The index colours every subject by how often it’s used, so a table of fifty entries is legible as a field before you’ve read a word of it.
  • That’s why I picked this theme.
  • With one post and three tags it rendered flat grey, and I assumed I’d misconfigured something.

Why it looked flat

  • I hadn’t. Reading the partial explained it in about four lines:

spectrum taxonomy information-design

resolves JRN 26-013

1,784,655 bytes to 36,616, by moving one file

Lab note

Evidence

  • The desktop screenshot is 6664 × 2168 and 1.74 MB.
  • It was being served at full size into a column about 672px wide.
  • Every byte past that width was downloaded and thrown away.

The fix

  • What surprised me is that the fix isn’t a setting. It’s where the file lives.

  • From this:

    content/posts/first-try.md
    assets/my-virtual-desktop-setup.png
    
  • to this:

    content/posts/first-try/index.md
    content/posts/first-try/my-virtual-desktop-setup.png
    
  • That’s a page bundle, and inside one the image stops being a loose asset and becomes a page resource — reachable via .Page.Resources.Get, carrying its own front matter for alt text and caption and credit, and eligible for .Resize.

hugo asset-pipeline performance

resolves JRN 26-011

A theme that refuses to build, and why I came around to it

Lab note

What happened

  • The theme hard-fails with no timeZone in config.
  • Not a warning — a failed build, on a line I hadn’t written yet.
  • My first reaction was irritation, and I want to record that honestly, because I’ve been on the other side of this argument.
  • A library that refuses to start over a missing config line is infuriating in the moment.

What it’s preventing

  • Then I worked out what it’s preventing.

spectrum silent-failure conventions

resolves JRN 26-010

I installed the theme and the theme did not appear

Lab note

Install

  • One command:

    $ git submodule add https://github.com/jwogrady/hugo-spectrum themes/hugo-spectrum
    
  • Submodule rather than Hugo Modules, because Modules wants a go.mod and this theme doesn’t ship one.

  • The submodule pins a commit, which means a checkout a year from now builds the same site as today.

  • I like that property a lot.

What I found

  • Then I rebuilt and got my own handmade templates back.
  • The scaffold baseof.html and page.html I’d written an hour earlier were still sitting in layouts/.
  • Five files were quietly overriding a theme I’d just installed, and the build was perfectly happy about it.

A project file at the same path beats the theme’s entirely. Not merged, not layered — replaced.

hugo spectrum git submodules