arifszn/slide-wright

Was macht slide-wright?

Verwandle ein Thema oder grobe Notizen in eine vorstandsreife Präsentation: Folien, die wie ein Deck aus einem starken Strategie- oder Produktteam wirken, ausgegeben als einzelne, eigenständige HTML-Datei, die in jedem Browser läuft.

Die Regel, die dieses Skill definiert

Schlage das Aussehen vor, bevor du die Präsentation baust. Beim ersten Durchlauf erstellst du niemals eine fertige Präsentation. Du generierst ein Theme, baust eine Vorschau mit zwei Folien darin und stoppst, bis der Benutzer die Richtung genehmigt. Erst dann baust du den Rest.

Ein Vorschlag nach dem anderen, kein Menü. Wenn der Benutzer Nein sagt, verwirf die Richtung und versuche eine deutlich andere. Jedes Theme wird für die vorliegende Präsentation erfunden; es gibt keine Bibliothek mit Voreinstellungen.

Neues Deck: Lies zuerst references/new-deck.md. Es enthält die Schritte 1-4 (das Deck ausarbeiten, ein Aussehen vorschlagen, ein Ja bekommen, bauen) und das genaue Genehmigungstor.

Die Engine (intern behalten)

Präsentationen rendern mit reveal.js, geladen von einem CDN, aber das ist ein Implementierungsdetail, das der Benutzer nie sieht. Sprich über Folien, Themes und Design; der Bibliotheksname erscheint nur innerhalb der generierten <link>- und <script>-Tags. references/deck-template.md enthält den genauen Aufbau.

Bearbeiten einer vorhandenen Präsentation

Wenn der Benutzer auf eine vorhandene HTML-Präsentation verweist, überprüfe, ob sie auf reveal.js basiert (suche nach den reveal.js <link>/<script>-Tags von einem CDN). Wenn dies der Fall ist – unabhängig davon, ob dieses Skill sie erstellt hat – fange nicht von vorne an: Lies sie, behalte ihr Theme und nimm die Änderung direkt vor. Das Aussehen ist bereits genehmigt, überspringe also den Vorschlag und das Tor. Führe nach der Bearbeitung node <skill-dir>/scripts/check-deck.mjs <deck.html> aus und behebe jede Zeile, die es ausgibt (references/new-deck.md enthält die Details).

Für eine Bearbeitung werden keine Referenzdateien benötigt, es sei denn, du fügst einen neuen Exponat-Typ hinzu (lies references/exhibits.md) oder Code oder Animation (lies references/code-slides.md oder references/motion-recipes.md).

Wenn die Präsentation HTML ist, aber nicht auf reveal.js basiert (andere Engine, einfache Folien usw.), liegt sie außerhalb des Bearbeitungspfads dieses Skills – sage dies, anstatt eine Neuschreibung auf eine andere Engine zu erzwingen. Alles andere hier dient dem Bau eines neuen Decks.

Schritt 5 – Übergabe

1. Öffne die fertige Präsentation.
2. Sage, wo sie sich befindet, den Themennamen und die Folienanzahl.
3. Erkläre dem Benutzer, wie er sie steuert: Pfeiltasten, Leertaste oder Wischen zum Bewegen; F für Vollbild, Esc oder O für die Folienübersicht, S für die Sprecheransicht mit Notizen; füge ?print-pdf zur URL hinzu und drucke, um ein PDF zu speichern (references/export-pdf.md enthält die Schritte); die Designfarben leben in den :root-Variablen, Schriftarten im <link>.
4. Biete die offensichtlichen nächsten Schritte an: den Inhalt überarbeiten, das Theme ändern, ein PDF exportieren, eine PowerPoint-Datei exportieren (references/export-pptx.md) oder auf eine Live-URL bereitstellen, um sie zu teilen. Wenn sie bereitgestellt werden soll, lies references/deploy.md und lass sie den Host wählen (Surge, Vercel oder Netlify) – gehe nicht von einem aus.

Referenzdateien

Lies diese, wenn du sie erreichst, nicht alle auf einmal:

• references/new-deck.md — Schritte 1-4 für ein neues Deck: Das Deck ausarbeiten, ein Aussehen vorschlagen, ein Ja bekommen, bauen
• references/design-aesthetics.md — Was macht ein Deck designed aussehen (Schritt 2)
• references/theme-generation.md — Die Vorgehensweise zum Erfinden eines Themes (Schritt 2)
• references/deck-template.md — Das HTML-Grundgerüst, Layout und Engine-Setup (Schritte 2 und 4)
• references/exhibits.md — Auswählen und Bauen der visuellen Darstellung auf jeder Inhaltsfolie (Schritte 2 und 4)
• references/code-slides.md — Code-Folien und ihr Markup-Vertrag (Schritt 4)
• references/motion-recipes.md — Animation, wenn der Benutzer danach fragt (Schritt 4)
• references/media.md — Bilder und Videos in Folien (Schritt 4)
• references/export-pdf.md — Speichern eines Decks als PDF (Schritt 5)
• references/export-pptx.md — Exportieren eines Decks nach PowerPoint mit bearbeitbarem Text (Schritt 5)
• references/deploy.md — Veröffentlichen des Decks auf einer Live-URL (Schritt 5)