artbreez/meadow-slides

Meadow Folien

Decks im Meadow-Look, erstellt aus einer kleinen JSON-Spezifikation über ein Skript, sodass jede Folie auf demselben Raster, derselben Schriftartenskala und denselben Farben wie Meadows eigene Verkaufsdecks landet. Sie schreiben den Inhalt und wählen Layouts aus; das Skript erledigt die Pixelarbeit und warnt, wenn der Text nicht passt.

scripts/meadow_deck.py   spec.json -> .pptx (+ --figma-json layout für Figma)
scripts/preview.py       .pptx -> PNG pro Folie + Kontaktbogen (LibreOffice oder Keynote)
scripts/figma_render.js  zeichnet eine Folie des Layout-Dumps durch use_figma
scripts/install_fonts.sh installiert Geist / Geist Mono / Syne für den aktuellen Benutzer
references/layouts.md    jedes Layout, seine Felder und wann es zu verwenden ist   <- vor dem Schreiben einer Spezifikation lesen
references/design-system.md  Tokens und Regeln hinter den Layouts               <- lesen, wenn Sie vom Layout abweichen
references/image-prompts.md  Prompt-Bibliothek für Deck-Bilder                  <- lesen, wenn das Deck neue Bilder benötigt
references/figma.md      Figma-Ausgabe-Rezept und seine Tücken                    <- nur lesen, wenn Figma gewünscht ist
examples/sample-deck.json      ein Sechs-Folien-Deck, das die Hauptlayouts abdeckt (fiktive Daten)
examples/skill-intro-deck.json das Deck, das diesen Skill präsentiert (README-Bilder)

Arbeitsablauf

1. Holen Sie sich zuerst den Inhalt. Fragen Sie nach (oder extrahieren Sie aus dem Briefing / alten Deck / Dokument) der Botschaft jeder Folie. Wenn Ihnen der Benutzer ein Quelldeck zum Neulayouten gibt, behalten Sie dessen Text wortwörtlich bei: Ändern Sie nur, was geändert werden soll, und bieten Sie Kürzungen oder neue Überschriften als separaten Vorschlag an. Leute bemerken, wenn ihr Text stillschweigend umgeschrieben wurde.
2. Gliedern. Eine Idee pro Folie. Ordnen Sie jede Folie einem Layout aus references/layouts.md zu (Cover → Inhaltsfolien → Kontakte ist der übliche Bogen). Zeigen Sie dem Benutzer die Gliederung, wenn das Deck länger als ~6 Folien ist oder das Briefing vage ist; andernfalls gehen Sie direkt zum Bauen über.
3. Überprüfen Sie die Zahlen. Kommerzielle Decks leben von Budgets, CPM/CPV, Aufrufen. Berechnen Sie abgeleitete Werte (CPM = Budget / Aufrufe × 1000, Summen, Prozentsätze) vor dem Satz neu. Wenn sie nicht aufgehen, setzen Sie trotzdem das, was der Benutzer angegeben hat, und teilen Sie ihm mit, welche Zahlen wie stark voneinander abweichen. Ein Kunde wird dieselbe Arithmetik durchführen.
4. Schreiben Sie die Spezifikation (deck.json), siehe das Beispiel und references/layouts.md. Bilder sind gebündelte Kurznamen (wave-05, meadow-night-02, people-02-camera-blue) oder Pfade.
5. Bauen: python3 scripts/meadow_deck.py deck.json -o deck.pptx. Behandeln Sie jedes WARN als Fehler: Kürzen Sie den Text, teilen Sie die Folie auf oder wechseln Sie das Layout, dann neu bauen. WARN-Zeilen betreffen überlaufenden Text, kyrillische Schrift in Syne (keine kyrillischen Glyphen), mehr als eine Akzentplatte auf einer Folie und das Ausrichtungs-Gatter, das bei jedem Build läuft:
   • Text, der nicht optisch in einer Pille, einem Chip, einem Button oder einem Badge zentriert ist (Tintenpolster links/rechts und Versalhöhe oben/unten müssen innerhalb von 1,5 px übereinstimmen);
   • Inhalt, der die 96px-Seitenränder überschreitet (Bilder, die über den Folienrand hinausgehen, sind in Ordnung);
   • Kanten, die fast ausgerichtet sind, 1–4 px auseinander: Rasten Sie sie ein oder verschieben Sie sie deutlich auseinander;
   • Ungleichmäßige Abstände in einer Reihe oder einem Stapel gleich großer Karten. Jedes neue pillenförmige Element wird durch Slide.pill() verarbeitet, das es dimensioniert und zentriert; Text, der anderen Text inline folgt (ein Symbol nach einer Zahl, einer Einheit, einem Badge), wird mit flow=True gebaut, sodass er auf Passgenauigkeit geprüft, aber nicht am Raster festgehalten wird.
6. Anschauen. Am schnellsten und überall funktionierend: --png preview/ zum Build hinzufügen. Es zeichnet dasselbe Layout mit Pillow und misst Text so, wie Keynote es tut. Um zu überprüfen, ob das PPTX die Schriftarten auf einem Mac aufnimmt, rendert qlmanage -t -s 1600 -o preview/ deck.pptx Folie 1 über das System (keine App öffnet sich). python3 scripts/preview.py deck.pptx verwendet LibreOffice oder Keynote als letzte Möglichkeit: Keynote-Scripting kann hängen bleiben und ein Dialogfeld auf dem Bildschirm des Benutzers hinterlassen, wiederholen Sie es daher nicht in einer Schleife. Öffnen Sie contact-sheet.png und die einzelnen Folien. Überprüfen Sie Ausrichtung, Gedrängel, Kontrast auf Fotos, leere halbe Karten und Kollisionen mit der Fußzeile. Office-Renderings benötigen die installierten Schriftarten (scripts/install_fonts.sh).
7. Liefern Sie die .pptx. Erwähnen Sie, dass die Empfänger die Schriftarten (assets/fonts, alle kostenlos unter der OFL) benötigen oder den --portable-Build verwenden sollten (siehe unten).
8. Figma (optional) wenn gewünscht: folgen Sie references/figma.md. Schreiben Sie nicht in die Figma-Datei eines anderen, es sei denn, er hat darum gebeten.

Regeln, die es wie Meadow aussehen lassen

Dies sind die Regeln, die zuerst überprüft werden. Die Layouts wenden sie bereits an, daher sind sie hauptsächlich wichtig, wenn Sie Text schreiben oder ein Layout verbiegen.

• Dunkle Leinwand, eine Limettenplatte. Hintergrund #0E1013, Karten #1A1D21, innere Reihen #23262B. Lime #D3FF31 markiert die eine Sache, um die es auf der Folie geht (das Angebot, das Ergebnis, der entscheidende Hinweis). Zwei Limettenplatten auf einer Folie ebnen die Hierarchie ein. Malen Sie keine zufällige Karte nur zur Betonung lime: Eine Folie kann auch keine haben. Text auf Lime ist fast schwarz, niemals weiß.
• Schriftarten. Eine in Latein geschriebene Überschrift wird in Syne gesetzt, selbst in einem russischen Deck (ein Produktname wie «Meadow Slides» auf einem Cover). Eine Überschrift mit kyrillischen Buchstaben wird in Geist gesetzt, da Syne keine kyrillischen Zeichen hat. Das Skript entscheidet pro Überschrift (Cover, Abschnitt, Aussage, Folien- und Kontakttitel), schreiben Sie den Titel daher in der Sprache, in der Sie ihn gesetzt haben möchten. Fließtext ist immer Geist, Beschriftungen in Geist Mono Versalien, eigenständige Zahlen/KPIs in Syne (ab ~36px).
• Raster. 96px Ränder, Kopfzeile (mono Augenbraue + 64px Titel) oben, Inhalt zwischen y=264 und y=944, Fußzeile = Logo + NN / NN. Abstände 24, Kartenradius 24, Polsterung 40.
• Sagen Sie es mit Flächen, nicht mit Strichen. Karten werden durch Füllung getrennt, nicht durch Umrisse. Das einzige Element mit Umriss ist ein Kategorie-Chip (1px weiß 18%).
• Keine Wettbewerbernamen im Text. Kundenlogos/-erfahrungsberichte nur, wenn der Benutzer sie bereitgestellt hat.
• Typografie: Das Skript klebt kurze Präpositionen/Konjunktionen und Gedankenstriche mit NBSP, sodass Zeilen nicht auf «в», «и», «—» enden. Schreiben Sie Zahlen als 10 000+, $5 000, 1,5 Mio in russischen Decks.
• Diagramme sind durchgehende dunkle Balken auf Lime oder Lime auf Dunkel, Null-Baseline, Höhen proportional zu den Daten. Ein halbtransparentes Schwarz auf Lime wird matschig, daher nicht verwenden.

Bilder

Gebündelt: 6 abstrakte blaue/lime Wellen (wave-01…06), 3 Nachtwiesen (meadow-night-01…03), 4 Lifestyle-Porträts (people-…) und weiße Plattform-Glyphen (instagram, tiktok, youtube, vk, telegram, x, linkedin, twitch). Wellen eignen sich für Cover und Abschnittswechsel, Wiesen für Kontakte und Abschlussfolien, Porträts für Kontakte und Bild-Text-Folien.

Wenn das Deck etwas Neues benötigt (ein thematisches Cover wie das Content-Factory-Floor, eine Szene für einen Case), schreiben Sie Prompts aus references/image-prompts.md: Hausstil-Präfix + Szene + Kompositionshinweis für den Slot, den es füllt. Wenn ein Bildgenerierungstool angeschlossen ist (z.B. das Magnific MCP images_generate), bieten Sie die Generierung an; andernfalls übergeben Sie die Prompts und verknüpfen die zurückgegebenen Dateien über den Pfad in der Spezifikation.

Ausgabevarianten

• --portable: Ordnet jede Schriftstärke Regular/Bold derselben Familie zu. Verwenden Sie es für den Google Slides-Import oder für Empfänger, die keine Schriftarten installieren können. Hierarchie bleibt erhalten, Nuancen nicht.
• --figma-json layout.json: Gibt das berechnete Layout für den Figma-Renderer aus.
• Sprechernnotizen: Fügen Sie "notes" zu jeder Folie hinzu. Sie werden in deck-notes.md neben dem PPTX abgelegt, da Keynote sich weigert, ein PPTX zu öffnen, das von python-pptx geschriebene Notizenfolien enthält. --embed-notes fügt sie direkt ein, für Decks, die nur in PowerPoint geöffnet werden.
• PDF: Fügen Sie --pdf deck.pdf hinzu (vollständiger 1920×1080-Render jeder Folie, Text nicht auswählbar). Verwenden Sie es, wenn jemand ein PDF zum Senden oder Lesen möchte; kein Keynote oder LibreOffice erforderlich.

Wenn die Layouts nicht passen

Bevorzugen Sie das Aufteilen des Inhalts auf zwei Folien gegenüber dem Quetschen. Wenn eine Folie wirklich eine neue Anordnung benötigt, fügen Sie eine layout_<name>-Funktion zu scripts/meadow_deck.py hinzu, die aus denselben Helfern (header, card, grid, bullets, kpi_tile, footer) und Tokens erstellt wird, sodass sie das System erbt. Lesen Sie references/design-system.md, bevor Sie dies tun.