All I wanted to do this morning was to add a class to an image in Hugo. At first I thought I needed to override my theme’s image-render hook, but then I learned that could use the built-in Markdown attributes. It required a new setting or two1, but worked great for adding a style to images in a single post. In lists, however, the styles are applied to the paragraph above the image, even with wrapStandAloneImageWithinParagraph set to false. I couldn’t figure it out, so I just put the paragraph after the images. Not a solution, but solved the problem in this case. This will happen again, I’m sure. Normally, I’d just use raw HTML for this, but the image pipeline in Hugo “bundles” wouldn’t work, and I need that.
Speaking of raw HTML. Have you noticed how we’re too willing to jump through all sorts of hoops in Markdown just to avoid writing a little HTML.
A dream of competence, too closely confronted.
I spent hours today working on better blockquotes and other tweaks to my theme. Then, suddenly, I couldn’t find half of my changes. Some combination of git branches and bad hugo module updates and the whole thing was hosed. Then I noticed my theme’s default branch was “master”, which shouldn’t be the case. No clue how that happened. Also, some of the experimental features I was tinkering with (using claude) leaked into the main branch. Took me more than an hour to fix things. At this moment I’m feeling like I should’ve stuck with Ghost. 😒
It was so much fun yesterday working on a BBEdit-based workflow with Hugo. Then, today it was ruined by the theme mess I made.
Namely,
wrapStandAloneImageWithinParagraph: falseand some block settings. ↩︎
