https://letsblaze.thomaslaurenson.com/tags/page-bundles/Recent content in Page-Bundles on letsblazeHugoen-USTue, 07 Apr 2026 15:31:33 +1200https://letsblaze.thomaslaurenson.com/blog/working-with-images/Sun, 15 Feb 2026 00:00:00 +0000https://letsblaze.thomaslaurenson.com/blog/working-with-images/<p>letsblaze handles images with a custom render hook that adds <code>&lt;figure&gt;</code> and <code>&lt;figcaption&gt;</code> support and automatic dimension detection for page-bundle images.</p> <h2 id="page-bundles">Page bundles</h2> <p>The recommended way to use images is as page bundles — store the image alongside the content file:</p> <pre tabindex="0"><code>content/ blog/ working-with-images/ index.md ← this file hero.jpg ← image in the same directory</code></pre> <p>This is a leaf bundle. Hugo can read the image dimensions at build time and emit <code>width</code> and <code>height</code> attributes automatically, preventing layout shift (CLS).</p>