Layout

the poetr.ie gods • 2 August 2025

Layout Options

This site uses various layouts to present content in different styles. I’ve tried to set this up to allow some flexibility to what best suits the poem, but also it’s just a bit of experimentation to see what works best. At some stage we probably want to standardize on one or two of these layouts allowing minor variations to avoid the site looking a bit dishevelled.

1. banner layout:

  • Creates a banner image with title overlay
  • Image appears as a hero banner at the top
  • Title and metadata are overlaid on the image
  • Example: layout: banner

2. background layout:

  • Sets the image as a background for the entire post
  • Content appears over the background image
  • Supports opacity and blur settings
  • Example: layout: background

3. hero layout:

  • Displays a large hero image at the top of the content
  • Title appears normally (not overlaid on image)
  • Image caption appears below if provided
  • Example: layout: hero

4. featured layout:

  • Shows a featured image prominently
  • Similar to hero but with different styling
  • Example: layout: featured

5. featured-columns-left layout:

  • Two-column layout with image on left, text on right
  • Title appears above both columns
  • Example: layout: featured-columns-left

6. featured-columns-right layout:

  • Two-column layout with text on left, image on right
  • Title appears above both columns
  • Example: layout: featured-columns-right

7. columns layout:

  • Alias for featured-columns-left
  • Image on left, text on right
  • Example: layout: columns

8. Default layout (no layout specified):

  • Standard single-column layout
  • Title at top, content below
  • Images appear inline if included

Additional Image Options

For layouts that support images, you can also specify:

  • image.opacity: Control image transparency
  • image.blur: Add blur effect to background images
  • image.dark: Apply dark styling for better text contrast
  • image.alt: Alt text for accessibility
  • image.caption: Caption text below image

Most of the example poetry here uses layout: banner which creates the nice overlaid title effect you see on poems like “I dwell in Possibility”.