module

Sunstone::Docs::B_AUTHORING::DeckManifest

Deck Manifest Specification

Executive Summary & Key Topics

Topic Method / Anchor Description
Structure of deck.yml .topic_01_manifest_structure Root fields and global options in deck manifests.
Footer Template Tags .topic_02_template_tags Dynamic placeholders available in footer strings.

Class methods

topic_01_manifest_structure

Structure of deckyml: Root fields and global options in deck manifests.

The deck.yml file defines your presentation's identity, resolution, footer templates, theme, and slide sequence:

title: "Building Microservices in Crystal"
subtitle: "Concurrency, Fiber Scheduling & Performance"
author: "Alex Morgan"
theme: "generic"
width: 1920
height: 1080

footer_left: "☀️ {title}"
footer_center: "{author} • {palette}"
footer_right: "Slide {slide_num} / {total_slides}"

slides:
  - slides/01_intro.yml
  - slides/02_architecture.yml
  - slides/03_benchmarks.yml
  - slides/04_closing.yml
Source
topic_02_template_tags

Footer Template Tags: Dynamic placeholders available in footer strings.

Footers support dynamic variable interpolation:

  • {title}: Presentation title.
  • {subtitle}: Presentation subtitle.
  • {author}: Deck author name.
  • {palette}: Human-readable name of the slide's active palette.
  • {palette_id}: Technical identifier of the active palette.
  • {slide_num}: Current slide number (1-indexed).
  • {total_slides}: Total slide count in the entire presentation.
  • {slide_title}: Current slide title.
Source