Images and embeds

Two shortcodes live in layouts/shortcodes/. Both are mine, not the theme’s — the theme ships no shortcodes at all.

Images

{{< image src="my-screenshot.png" >}}

Resolves the name as a page resource first (a file sitting next to index.md in a bundle), then falls back to a global asset. It hands off to the theme’s own figure.html, so an inline image is styled identically to a featured one and gets the same treatment: anything wider than 1400px is resized and converted to WebP at q82.

Alt text, caption and credit come from the [[resources]] block in front matter, not from shortcode parameters.

Spotify

{{< spotify type="album" id="6mnGRO87UFiKOoHL3BezZ7" >}}

type is track, album, playlist, artist, show or episode. Height is chosen per type — 352 for a track, 452 for an album or playlist — and compact="true" gives the 152px bar.

Finding the id: from a share link like open.spotify.com/album/6mnGRO87UFiKOoHL3BezZ7?si=abc123, the id is the segment after the type. Drop the ?si= — it is a share-tracking parameter, not part of the address.

Raw HTML

markup.goldmark.renderer.unsafe = true is set in hugo.toml, so a pasted iframe works without a shortcode. It needs a blank line before and after it or Goldmark folds it into the adjacent paragraph.

Prefer the shortcode. A pasted iframe hardcodes a border radius and a height that will not match the next one you paste.