Trail Presentation Mode Guide

Zuletzt aktualisiert am 6. Okt. 2026

Jeder Trail ist zugleich ein Foliendeck. Dieselbe Timeline, die ein Leser scrollt, lässt sich Schritt für Schritt projizieren — mit Agenda, Referentenansicht und Sprechernotizen. Nichts wird doppelt geschrieben: Das Deck wird aus dem scfTrail-Frontmatter des Trails erzeugt. Dieser Guide behandelt beides — wie ein Vortragender es steuert und wie du als Autor es vorbereitest.

Ein Deck öffnen

Öffne einen beliebigen Trail (aus der Trails-Übersicht oder einem eingebetteten Trail-Loader), klappe ihn auf und nutze den Präsentieren-Button in der Detailansicht. Das Deck öffnet sich im Vollbild über der Seite, zunächst mit einem Startbildschirm — keine separate Seite, kein zusätzliches Frontmatter für den Basisfall nötig.

Der Startbildschirm

Vor der ersten Folie kann der Vortragende den Lauf auf dem Startbildschirm anpassen:

Alle Steps zeigen (Standard an) — jeder Step wird eine Folie. Ausschalten blendet eine Per-Step-Liste mit je zwei Checkboxen ein: Folie (Step überhaupt einschließen) und Agenda (in der Agenda listen). Die Nummern werden live neu vergeben, wenn du Steps ein- oder ausschließt.
Alternative-Auswahl — ein Step mit Alternativen (alternativen Spuren) zeigt in dieser Liste eine kleine Spurauswahl, und die Liste ist bei solchen Trails von Anfang an sichtbar. Voreingestellt ist die Spur, die auf der Trail-Seite gerade aktiv ist; die Folie, ihre Attribution-Ecke und die Sprechernotiz folgen der gewählten Spur.
Dropdown „Vorbereitete Ansicht” — wähle eine der kuratierten Autoren-Ansichten (unten) oder belasse es auf Default (all steps). Eine Ansicht auszuwählen füllt die Per-Step-Auswahl für dich vor.
Layout-Umschalter — Auto-fit (Standard) verteilt einen Step auf so viele Folien wie nötig, damit nichts aus dem Bild scrollt. Full step per slide lässt den ganzen Step auf einer Folie und scrollt stattdessen.
Start — startet das Deck und wechselt in den Vollbildmodus. Browser gewähren Vollbild nur aus einem Klick heraus, deshalb geschieht es hier und nicht beim Öffnen des Decks; F oder Escape verlässt ihn wieder.

Präsentieren: Steuerung und die Referentenansicht

Im laufenden Deck steuerst du per Tastatur und Zeiger:

Navigieren — Pfeiltasten oder Leertaste wechseln die Folien; die Bildschirm-Steuerung spiegelt sie.
Springen — klicke den Folienzähler (N / total) an und tippe eine Nummer, um direkt dorthin zu springen.
Vollbild — der Vollbild-Button oder die Taste F.
Referentenfenster (S oder der Bildschirm-Button) — öffnet ein zweites Fenster mit der aktuellen Folie, ihren Sprechernotizen, einer „Als Nächstes”-Vorschau, einem Timer und einer Uhr. Es bleibt mit dem Hauptdeck synchron, sodass du nur das Deck auf dem Beamer teilst und die Notizen auf deinem Laptop behältst.
Sprechernotizen — jede Folie hat ein Notizfeld. Der Per-Step-Kontext des Autors wird als Ausgangsnotiz gezeigt; was du tippst, wird pro Trail im Browser gespeichert.
Zahnrad-Einstellungen — schaltet Chrome, Attribution, Agenda, Loop und mehr. Klick außerhalb des Panels schließt es.

Anzeige-Presets bündeln diese Schalter für gängige Situationen, wählbar in den Einstellungen oder per Launch-Konfiguration vorgesetzt:

standard — die Standardwerte.
minimal — Chrome und Attribution aus, für einen aufgeräumten Look.
kiosk — Auto-Advance und Loop an, Chrome aus, für einen unbeaufsichtigten Bildschirm.
focus — Attribution aus, sonst standard.

Vorbereitete Ansichten (Autor)

Standardmäßig zeigt das Deck jeden Step. Als Autor kannst du eine oder mehrere vorbereitete Ansichten vorgeben — kuratierte Folien-Auswahlen, die der Leser über das Dropdown auf dem Startbildschirm auswählt. Gib jedem referenzierten Trail-Step eine stabile id und ergänze eine presentations-Liste unter scfTrail:

scfTrail:
  steps:
    - id: "assessment"
      style: "compass"
      title: "Initial Assessment"
      trailContext: "Workload-Eigenschaften analysieren, bevor Ressourcen initialisiert werden."
    - id: "landing-zone"
      style: "gondola"
      assetId: "migration/assetcontainer/stackit/landing-zone-foundation-opentofu"
      trailContext: "Landing Zone per standardisiertem Infrastruktur-Code ausrollen."
    # ...weitere Steps...

  presentations:
    - id: "executive"
      label: "Executive-Überblick"
      description: "Die wichtigsten Meilensteine, für ein Management-Publikum."
      steps:
        - assessment                       # als nummerierter Agenda-Punkt enthalten
        - { id: landing-zone, role: sub }   # eingerückter Unterpunkt des vorherigen Hauptschritts
    - id: "technical"
      label: "Technische Vertiefung"
      steps:
        - { id: assessment, role: hidden }  # bleibt eine Folie, fehlt aber in der Agenda
        - landing-zone

Jede Ansicht enthält:

id — eindeutig innerhalb des Trails.
label — im Dropdown des Startbildschirms sichtbar.
description (optional) — ein kurzer Hinweis zur Ansicht.
steps — die kuratierte Auswahl, in Trail-Reihenfolge. Referenziere jeden Step über seine id (oder seine 1-basierte Position). Ein nicht gelisteter Step wird aus dieser Ansicht entfernt.

Jeder gelistete Step nimmt eine optionale role, die steuert, wie er in der Agenda erscheint:

main (Standard) — ein nummerierter Agenda-Punkt.
sub — ein eingerückter Unterpunkt (a, b, …) des vorherigen Hauptpunkts.
hidden — der Step bleibt eine Folie, fehlt aber in der Agenda.

Die Timeline-role eines Steps (siehe Trail Authoring Guide) ist hier der Standard, sodass Timeline-Sub-Steps ohne Wiederholung als Agenda-Unterpunkte durchkommen.

Ein gelisteter Step nimmt zusätzlich eine optionale notes — eine Sprechernotiz nur für diese Ansicht. Während die Ansicht präsentiert wird, zeigt das Referentenfenster sie als „Authored note” des Steps; die Default-Ansicht (alle Steps) und jede andere Ansicht ohne Notiz an diesem Step zeigen stattdessen den trailContext des Steps. So passt du den roten Faden pro Publikum an, ohne die Timeline anzufassen:

  presentations:
    - id: "executive"
      label: "Executive-Überblick"
      steps:
        - { id: assessment, notes: "Mit dem Business Case öffnen, Tooling-Detail weglassen." }
        - { id: landing-zone, role: sub, notes: "Ein Satz: als Code bereitgestellt, reproduzierbar." }

Ein gelisteter Step nimmt außerdem ein optionales alternative — es legt für diese Ansicht eine der Alternativen (alternativen Spuren) des Steps fest, über die Alternative-id (default meint die eigene Spur des Steps). Eine Executive-Ansicht kann den Managed-Weg festlegen, die technische Vertiefung den Selbstbau-Weg; eine unbekannte id oder ein Step ohne Alternativen ignoriert das Feld:

  presentations:
    - id: "executive"
      label: "Executive-Überblick"
      steps:
        - { id: migrate-vms, alternative: "default", notes: "Der Managed-Weg: ein Guide, planbare Wellen." }
    - id: "technical"
      label: "Technische Vertiefung"
      steps:
        - { id: migrate-vms, alternative: "hystax", notes: "Den Live-Migration-Pfad Ende zu Ende zeigen." }

Empfohlenes Paar: Gib einem substanziellen Trail mindestens zwei Ansichten - eine technische Vertiefung für Praktiker und einen nicht-technischen Überblick für Briefings und Entscheider, jede mit eigenen Notizen. Die tm-Trails und die STACKIT-Onboarding-Trails (scf-onboarding, getting-started-contributor) folgen diesem Muster und taugen als Copy-Paste-Referenz.

Eine Ansicht per Link starten

Ein Link kann einen Trail direkt als Deck öffnen. Dafür hängst du present an den Trail-Link, zum Beispiel /de/trails/?trail=<Trail-ID>&present=kiosk. Der Wert legt fest, was passiert:

kiosk: Das Deck startet sofort und blättert von selbst weiter. Nach der letzten Folie beginnt es von vorn. Das ist für einen Bildschirm gedacht, den niemand bedient.
auto: Das Deck startet sofort und blättert von selbst weiter. Auf der letzten Folie bleibt es stehen.
ask: Zuerst öffnet sich der Startbildschirm, damit der Besucher vor der ersten Folie bestätigt. So funktioniert der „Get Started”-Button auf der Startseite.

kiosk und auto funktionieren bei jedem Trail. ask funktioniert nur bei einem Trail mit einer Ansicht, die launch: true trägt. Ein Trail ohne so eine Ansicht ignoriert den Link und klappt nur auf.

Die folgenden Felder gehören zur Start-Ansicht. Sie wirken nur, wenn ein ask-Link sie öffnet:

launch: true öffnet diese Ansicht über einen ask-Link.
preset: standard, minimal, kiosk oder focus. Es wird auf dem Startbildschirm vorgewählt.
fullscreen: Start geht standardmäßig ins Vollbild. Mit false bleibt das Deck im Fenster.
agenda: false öffnet ohne Agenda-Folie und springt direkt zum ersten Step. Das schlägt das Preset. Eine minimal-Tour kann also trotzdem ohne Agenda starten.

Ein weiteres Feld hat mit Links nichts zu tun:

default: true wählt diese Ansicht beim normalen Öffnen des Decks vor. Sonst startet es auf Default (all steps).

  presentations:
    - id: "quick-tour"
      label: "Quick tour"
      launch: true
      preset: "minimal"
      agenda: false
      steps: [assessment, landing-zone]

Mehrere Trails nacheinander

Ein Bildschirm am Messestand kann mehrere Trails hintereinander zeigen:

Speichere die Trails mit dem Herz auf ihren Karten.
Öffne Listen in der Kopfzeile und bring die Trails mit den Pfeilen in die gewünschte Reihenfolge.
Wähle Als Kiosk abspielen.

Aus der Liste wird ein Kiosk-Link. Am Ende jedes Decks öffnet sich der nächste Trail. Nach dem letzten Trail beginnt es wieder mit dem ersten. Assets und Contributors in der Liste werden übersprungen.

Die Zeit pro Folie stellst du in den Deck-Einstellungen unter Auto-advance ein. Der Browser merkt sie sich für jeden Trail einzeln. Stell sie also auf dem Gerät, das den Bildschirm betreibt, einmal pro Trail ein.

Split- und zentrierte Folien

Steps komponieren ihr eigenes Folien-Layout, und das Deck spiegelt die Timeline exakt:

Ein Step mit Schaubild (imageSrc) wird zur Zwei-Spalten-Folie — Bild auf der einen Seite, Inhalt auf der anderen — oder zu einem zentrierten Cover, wenn keine imagePosition gesetzt ist.
Ein Step mit den left / right / center-Slots legt beliebige Inhaltstypen auf eine Seite oder in die Mitte: freien Text, ein Schaubild oder eine Card (assetId / pageId / trailId) als Zeiger — hänge einen #section-anchor an eine assetId / pageId, um zusätzlich genau diesen Abschnitt unter der Card einzubetten. left + right → Split, nur eine Seite → diese Seite, center → zentriertes Cover.

Beides wird am Trail-Step gesetzt und ist im Trail Authoring Guide dokumentiert. Bilder sind auf der Folie per Klick zoombar, animierte SVGs eingeschlossen. Eine nackte Card bleibt kompakt; nutze einen #section-anchor, wenn der Inhalt eines Abschnitts eingebettet werden soll, damit die Folie nie eine sehr hohe Spalte wird.

Auf dem Handy

Auf dem Handy passt das Deck diese Folien an. Am Trail muss dafür nichts geändert werden.

Hochkant: Ein Step mit left und right zeigt eine Spalte groß und die andere als kleine Vorschau daneben. Tippen auf die Vorschau, Wischen oder der Weiter-Pfeil tauscht sie. Weiter zeigt erst die rechte Spalte und geht dann zum nächsten Step.
Bild neben dem Text: Hochkant zeigt ein Step mit imageSrc und imagePosition: left oder right das Bild in voller Breite über dem Text.
Quer: Der Kopf jeder Folie schrumpft auf eine kurze Zeile. Ein Split-Step behält beide Spalten nebeneinander.

Zentrale Übersicht

Zur Cloud-Framework-Trails-Übersicht

Öffne einen Trail, klappe ihn auf und drücke Präsentieren, um eines dieser Decks in Aktion zu sehen.

Ihr Feedback

Fast fertig!