Example 11: Include Templates

Source Types for Template Rendering

Template rendering works with two source types: TOML files and directory sources. Each section below was rendered from a subdirectory of source-types/ through blocks/source-type.html.

Directory subdirectories

Use directory subdirectories when each item has multiple files of mixed types — a markdown description, an HTML snippet, a plain-text value. Each subdirectory becomes one rendered item, with files in that subdirectory available as tokens inside the template.

[[step]]
  emoji = "👐"
  path = "source-types/"
  processing = "include"
  template = "blocks/source-type.html"
  options = ["trim-trailing-space"]

TOML sections

Use TOML sections when your data is structured and named — product catalogs, team directories, FAQs. Each `[section-name]` in the file becomes one rendered item, with section fields available as tokens inside the template.

[[step]]
  emoji = "🃏"
  path = "data/scenarios.toml"
  processing = "include"
  template = "blocks/scenario-card.html"

The Full Config

The config snippets above each come from the actual ssi-config.toml for this site. The complete configuration lives in site/ssi-config.toml — it shows all eight steps and the step ordering that makes the two-pass token resolution work.