Super Simple Includes

Build your site, simply.

The also Field

Two separate include steps — one for header widgets, one for footer widgets — both respond to the same shared emoji alias via the also field. The page template uses only the shared alias tokens; it does not need to know which step provides which value.

The also setting tells a step to resolve tokens that begin with the alias emoji in addition to its own primary emoji. SSI tries each step in order; the first step that has a matching token wins. Tokens not found in any step generate a leftover warning (or are silently skipped with leftovers-okay).

On this page, the site-name token comes from header-blocks/site-name and the copyright token comes from footer-blocks/copyright — but the template uses the same alias emoji for both.

Config

[[step]]
  emoji = "📄"
  path = "pages/"
  processing = "page"
  
  # Header widgets — primary emoji, also responds to shared alias tokens.
  [[step]]
  emoji = "🔴"
  also = "🔄"
  path = "widgets/header-blocks/"
  processing = "include"
  type = "plain"
  options = ["inline", "leftovers-okay"]
  
  # Footer widgets — primary emoji, also responds to shared alias tokens.
  [[step]]
  emoji = "🔵"
  also = "🔄"
  path = "widgets/footer-blocks/"
  processing = "include"
  type = "plain"
  options = ["inline", "leftovers-okay"]
  
  [[step]]
  emoji = "🎨"
  path = "assets/"
  processing = "copy"