CommunityBildgithub.com

poster

Lokale Erstellung von Werbegrafiken und Postern in reinem Python: Einseitige Poster, Infografiken, Cover, Banner, Wissenskarten, Vergleichsseiten, Zertifikate, Roll-ups. Deklarativ mit „Grundgerüst + Blöcke + Thema“ oder direkt über die Canvas-API; Ausgabe als PNG / SVG / PDF, ohne externe Abhängigkeiten (nur fontTools) für lokale Rasterung.

Was ist poster?

Dieses Skill (poster) ermöglicht die Erstellung von Werbegrafiken und Postern – darunter einseitige Poster, lange Infografiken, Cover, Banner, Wissenskarten, Vergleichsseiten, Zertifikate und Roll-ups – vollständig in lokatem Python. Es folgt einem deklarativen Ansatz mit den drei Komponenten „Grundgerüst + Blöcke + Thema“ oder erlaubt die direkte Nutzung der Canvas-API für individuelle Zeichnungen. Die Ausgabeformate sind PNG, SVG oder Vektor-PDF; die Rasterung erfolgt lokal ohne Abhängigkeiten außer fontTools. Besonders geeignet für Entwickler:innen, die CI/CD-Integration, automatisierte Batch-Produktion oder Offline-Arbeitsabläufe benötigen, und Agenten, die reproduzierbare, hochwertige Grafik-Assets erstellen müssen. Es integriert sich nahtlos in Cli- und Python-Workflows und ist für Spitzenleistung optimiert – z. B. durch Lookup-Tabellen für Transparenzüberlagerungen, adaptive Unterteilung von Pfaden und Caching statischer Ebenen (standardmäßig deaktiviert). Die Engine unterstützt mehrere Voreinstellungen für gängige Formate (z. B. soziale Medien, Druck), 6 eingebaute Themen und 21 deklarative Blöcke und stellt sicher, dass die Ausgabe durch automatische Prüfungen auf Überläufe, Kontrast, Schriftgröße und fehlende Glyphen innerhalb der Grenzen bleibt. Das Tool erzeugt keine Fotos oder fotorealistische Illustrationen – es ist auf Vektor-/geometrischen Stil mit hoher Präzision spezialisiert.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/KongBai-lab/dsh-skill-poster/tree/main

Installed? Explore more Bild skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

poster: Werbegrafik / Poster

Abgrenzung (zuerst lesen)

AnforderungVerwenden
Einzelne Datengrafik (Balken/Linien/Kreis/Fluss/Zeitachse)diagram, dieses Skill nicht verwenden
Einzelne visuelle Grafik: Poster/Langbild/Cover/Banner/Karte/AusstellungstafelDieses Skill
Mehrseitige Präsentationmake-ppt
Dokument mit Formelnmd2docx

Lokale Grenzen: Keine Diffusionsmodellgewichte, keine lokale Inferenzrechenleistung, keine Erzeugung von Fotos oder fotorealistischen Illustrationen. Dieses Skill kann nur Vektor-/geometrischen Stil (detailliert, aber nicht fotorealistisch).

Eiserne Regeln

  1. Keine manuellen Punktlisten. Formen verwenden parametrische Primitive aus engine.geometry (circle/leaf/cloud/wave/heart…), diese passen sich intern adaptiv an; manuelle Koordinaten sind die Wurzel von „offensichtlich mit Polygonen geflickten“ Formen.
  2. Text ebenfalls als Pfad. Kein separates Textzeichnungssystem; engine.typography übernimmt Zeilenumbruch/vertikalen Text/Zeichenvermeidung an Zeilenanfang/-ende.
  3. Nach Code-Änderungen Modul-Cache leeren. Der Interpreter des python-Tools teilt sich Anfragen: for m in [k for k in sys.modules if k.startswith("engine")]: del sys.modules[m]
  4. Keine Abnahme von 1–2 px Fehlern per Bildbetrachtung. read_image skaliert die Vorschau und erzeugt scheinbare Lücken; verwenden Sie engine.check.check_canvas()-Asserts oder pixelgenaue Statistiken.
  5. Leistung: Große pixelweise Operationen an die C-Ebene delegieren, zuerst analysieren, dann ändern.
    • Halbtransparente Überlagerungen mit einfarbig (Schwarz/Weiß/Grau): Drei Kanäle gleiche Abbildung → 256-Eintrag LUT + bytes.translate. Gemessen: Pixelweise Alpha-Mischung verbrauchte 71 % (6,6 s), geändert auf 0,05 s, mathematisch völlig äquivalent.
    • Ganze Zeilen mit durchgehender Farbe per Slice zuweisen, nicht pixelweise 3 Byte schreiben.
    • Zlib mit Level 6, nicht 9 (doppelt so schnell, Datei nur 15 % größer).
    • Vor dem Eingriff cProfile: Die größte Falle dieses Projekts ist die Alpha-Mischung, nicht die Geometrie-Algorithmen.

Drei Zugriffsmodi

ModusEingabeAnwendung
A Vorlage nutzentemplates/*/ kopieren, nur content.json ändernStandard-Werbegrafiken (80 % der Fälle)
B Zusammenbauenlayout.json schreiben (Grundgerüst + Blockliste + Parameter)Struktur ändern, Elemente standardisiert
C Eigenzeichnungengine.canvas.Canvas direkt für GrafikelementeReferenzbild nachahmen, einzigartiges Layout

Verzeichnis

engine/
  canvas.py       Display-Liste (Canvas.fill/stroke/clip, Layer static/dynamic)
  path.py         Path (M/L/C/Q/Z) + adaptive Unterteilung
  geometry.py     23 parametrische Primitive
  fonts.py        Schriftregistrierung + Glyph→Path + Fehlende-Zeichen-Erkennung
  typography.py   Zeilenumbruch/Vermeidung Zeilenanfang/-ende/Zeichensetzung-Kernung/vertikaler Text/Laufweite
  theme.py        Thema (6 Skin-Sets + Stilparameter) + 9 Leinwand-Voreinstellungen
  blocks.py       21 deklarative Blöcke
  layouts.py      9 Grundgerüste (inkl. Links-Rechts-Spalte)
  render.py       Zusammenbau + CLI
  check.py        Überlauf/Kontrast/Schriftgröße/Farbanzahl/Fehlende Glyphen/Slot-Asserts
  cache.py        Cache statischer Layer-Bitmaps (standardmäßig aus, gemessen siehe refs/workflow.md)
  backends/       raster.py (PNG), pdf.py (Vektor-PDF), svg.py
packs/            Materialpakete (guofeng 国风, tea 茶器), bei Bedarf laden
templates/        Fertige Rezepte (content + layout)

Voraussetzungen

  • Abhängigkeiten installieren: pip install -r requirements.txt (nur ein Abhängigkeit: fontTools).
  • Schriftarten: Dieses Repository enthält keine Schriftdateien; die Engine liest systemweit installierte Schriftarten – standardmäßig scannt sie /system/fonts, /usr/share/fonts, ~/.fonts usw.; bei anderem Speicherort mit Umgebungsvariable POSTER_FONT_DIR auf das Schriftverzeichnis verweisen.
  • Kein Internet, kein Office/GUI nötig: Rasterung, PDF und SVG sind alles reine Python-Implementierungen.

Schnellstart

# Bild ausgeben (Standard preview-Modus)
python -m engine.render templates/minimal-poster/layout.json -o out.png

# Druckvorlage: A4 Vektor-PDF (Text nicht auswählbar)
python -m engine.render templates/minimal-poster/layout.json -o out.pdf \
       --preset a4-portrait --for print

# Thema / Größe wechseln
python -m engine.render ... --theme guofeng --preset xhs-3x4

# Verfügbare Voreinstellungen / Grundgerüste / Blöcke auflisten
python -m engine.render --list

Aufruf in Python:

from engine.render import render, load_json
render(layout, content, theme="minimal", preset_name="xhs-3x4",
       out="out.png", for_="publish")

Nur vier Stellschrauben

StellschraubeWerteBeschreibung
presetxhs-3x4 / sq-1x1 / story-9x16 / wechat-cover / video-16x9 / info-long / a4-portrait / a3-portrait / rollup-85x200Größe & Sicherheitszone
--fordraft / preview / publish / printAuflösung & Ausgabe (siehe refs/workflow.md)
--formatpng / pdf / svgStandard: print→pdf, sonst png
--deco0/1/2 (innerhalb des Themas)Dekorationsdichte; beeinflusst nur Optik & Dateigröße, kaum Geschwindigkeit

Kein quality-Parameter: Untere Qualitätsgrenze garantiert durch adaptive Unterteilung der Primitive + Subpixel-Abdeckung + check.py.

Einschränkungen (transparent mitgeteilt)

  • Keine Fotos, fotorealistische Illustrationen, 3D; halbrealistische Gegenstände möglich (jeweils ca. 100–200 Zeilen, sechs Schichten), Personen nicht empfohlen.
  • PDF erste Version Text in Pfade umgewandelt: visuell korrekt, aber nicht auswählbar, nicht durchsuchbar.
  • PDF nur RGB, kein CMYK/Sonderfarben; vor Druck selbst konvertieren.
  • Große Überschriften/dünne Linien bei ss=2 besser mit --for publish (ss=3) verwenden.
  • Seltene Zeichen können fehlen; check.py meldet fehlende Zeichen, Schriftart über POSTER_FONT_DIR angebbar.
  • Erstmaliges Rendern ca. +6 s (Schriftdatei-Parsing), Wiederverwendung im gleichen Prozess; iterativ aufrufen, nicht häufig neustarten.
  • Warmlauf-Zeitreferenz: preview ≈1,6 s, publish ≈2,7 s (1080×1440 Ausgabe mit 3240×4320).
  • Vertikale Zeichensetzung nur verschoben, nicht gedreht; Zahlen/Englisch vertikal nicht gedreht; keine Schriftsatzanpassung für mehrere Endgeräte.

Hinweise (bekannte Fallstricke)

Leistung

  • Halbtransparente Überlagerungen: Beliebige Farben über kanalweise LUT (gemessen 13 s→2,5 s). Vor neuem „großflächiger pixelweiser“ Feature überlegen, ob Lookup-Tabelle möglich.
  • Große PNG-Dekodierung: 5760×3240 voll dekodiert 10 s+. Hintergrundmaterial ≤1500px oder JPEG (nur DC-Koeffizienten dekodieren, eine Größenordnung schneller).
  • Print-Modus erzwingt ss=1: A4@ss3 gemessen 52 s.
  • Cache statischer Layer gemessen nicht lohnend (40 MB Bitmap-IO ≈ Rendering-Kosten), --cache standardmäßig aus.

Schriftarten

  • Alle FZ-Schriftarten fehlen ∂ ħ ∇ und hochgestellte Zahlen ⁻³⁵; Fehlende Zeichen werden stillschweigend übersprungen, kein Fehler (Formeln werden zu ψ/ t = i Hψ).
  • Vor Formeln/Einheiten fonts.missing(text, family) prüfen; gemessen nur verfügbare Symbole: ψ ∫ ≈ ∝ λ ∞ → ·.

Layout

  • hero mehrzeilig benötigt Bereichshöhe ≥ Zeilen × Zeilenhöhe, sonst Druck auf nächsten Block.
  • banner / card-grid / cover Proportionen sind Erfahrungswerte, bei Inhaltswechsel ggf. Feinjustierung nötig.
  • CTA in Breitbild muss max_width gesetzt haben, sonst füllt es die ganze Zeile wie eine Fortschrittsleiste.
  • Eigener Text im Hintergrundbild kollidiert mit Vordergrund – textloses Material wählen (Fotos/Texturen/Illustrationen).

Bildmaterial

  • JPEG mit PNG-Ausgabe nur DC-Version (8× verkleinert, pixelig); für Klarheit PDF ausgeben oder PNG-Material verwenden.
  • PDF direktes Einbetten von JPEG ohne Neucodierung, beste Qualität.
  • Material ohne Dateiendung wird erkannt (anhand Dateisignatur).

Entwicklungspraktiken

  • Modul-Cache des python-Tools wird anfragenübergreifend geteilt, daher zu Testbeginn sys.modules von engine* / packs* leeren.
  • Entwicklungsverzeichnis und Installationsverzeichnis trennen, nach Änderungen mit copytree synchronisieren (__pycache__ ignorieren).
  • Fehler beim Import von objects_pack in scene führen zu stillem Rückfall auf vereinfachte Version, kein Fehler.

Detaildokumentation (bei Bedarf lesen)

DateiInhalt
refs/workflow.mdReferenzbild-Zerlegung → Graumodell → Färbung → Beschriftung → Abnahme; Auflösungsstufen und Leistungsmessungen
refs/canvas-api.mdCanvas / Path / geometry Kurzreferenz, Methoden für fehlende Fähigkeiten
refs/presets.mdAlle Größen, Sicherheitszonen, Druckbeschneidung und pt-Umrechnung
refs/packs.mdMaterialpaket-Protokoll und Workflow für „bedarfsgerechtes Verpacken“
refs/styles.mdStilparameter, 6 integrierte Stil-Fingerabdrücke, theme_overrides, Workflow zur Nachahmung eines Stils
refs/analyze.mdReferenzbildanalyse: Farbnahme/Helligkeit/Satzspiegel/Dichte → Theme-Entwurf

Verwandte Skills