Interaktive Grußkarte
Erstelle eine Karte, mit der jemand spielen möchte: das eigene Bild auf der Vorderseite einer gefalteten Karte, die auf der Seite schwingt, das Licht in ihrer Folie oder Farbe einfängt, sich mit einem Tippen zur handgeschriebenen Nachricht öffnet und sich umdreht, um die Rückseite zu zeigen. Ein kurzer Bauvorgang verwandelt ein Bild und ein paar Einstellungen in eine HTML-Datei mit allem darin (Bild, Schriftart, Renderer), sodass sie direkt aus einer Datei geöffnet wird, offline funktioniert und unverändert auf jedem beliebigen Webhoster abgelegt werden kann.
Was in dieser Fähigkeit enthalten ist:
scripts/make_card.pyerstellt die Seite aus den Kartendaten (JSON). Es überprüft die Daten und erklärt jeden Fehler, bevor es etwas schreibt.scripts/grid.pyzeichnet ein beschriftetes Pixelraster über das Bild, genau so, wie die Karte es zuschneidet, um Positionen abzulesen (nur für Living-Effekte und Farbauswahl erforderlich).scripts/foil_preview.pyzeigt genau an, was in Magenta zu Folie wird, damit du die Folie vor dem Bau anpassen kannst (benötigt numpy).scripts/snapshot.mjs(optional, benötigt Node und Playwright) erstellt Bildschirmfotos von Vorderseite, Innenseite und Rückseite, und mit--livezeigt es, was sich auf einer lebendigen Karte bewegt und was jede Berührung bewirkt.referenzen/optionen.mdlistet jede Einstellung.referenzen/lebendige-karten.mderklärt, wie man eine Karte zum Leben erweckt. Lies sie, wenn du sie brauchst, nicht vorher.
So erstellst du eine Karte
1. Besorge das Bild und die Nachricht
Die beiden Dinge, die du von der Person brauchst, sind das Bild für die Vorderseite und das, was innen geschrieben werden soll. Wenn eines fehlt, frage danach oder biete an, die Nachricht für sie zu schreiben (frage, für wen sie ist und von wem). Alles andere hat eine sinnvolle Voreinstellung, also zwinge sie nicht, einen Fragebogen auszufüllen; wähle gut aus und erwähne die von dir getroffenen Entscheidungen, damit sie diese ändern können.
Nimm die Nachricht so, wie sie gegeben wird. Poliere ihre Worte nicht, es sei denn, sie bitten darum, aber setze Zeilenumbrüche dort, wo eine handgeschriebene Karte sie hätte (ein Gruß in einer eigenen Zeile, die Verabschiedung am Ende); eine zu lange Zeile für das Blatt wird automatisch umgebrochen, bei etwa 20 Buchstaben. Bis zu etwa 60 Wörter liest sich groß und bequem; längere Briefe werden kleiner geschrieben, und wenn es nicht mehr passt, wird das Ende abgeschnitten, also schlage vor, einen sehr langen zu kürzen.
Mehrere Bilder ergeben mehrere Karten auf einer Seite, die nacheinander mit einem Dock zum Wechseln zwischen ihnen angeordnet sind. Das eignet sich für ein Set von Karten oder für eine Karte in mehreren Designs zur Auswahl.
2. Betrachte das Bild und wähle die Veredelung
Die Veredelung bestimmt, wie die Vorderseite das Licht einfängt. Betrachte das Bild, bevor du wählst:
| Das Bild | Veredelung | Hinweise |
|---|---|---|
| Ein Gemälde mit Pinselstruktur (Öl, Gouache, Acryl, dickes Aquarell) | paint | Die eigenen Farbstriche stehen hervor und glänzen unter dem Licht. Wenn es Goldfarbe hat, lass auch die glänzen: foil.on: "colour" mit dem ausgewählten Gold. |
| Eine Illustration, Strichzeichnung, Lettering oder flaches Design, besonders auf einfarbigem Papier | foil | on: "details"" prägt die Linien und dunklen Details in Folie; "colour" prägt eine von dir ausgewählte Farbe (z. B. goldene Buchstaben); "darks" prägt die dunkelsten Formen (Silhouetten). |
| Ein Foto | print | Auf mattem Karton gedruckt. Ein dünner Folienrand umrahmt es schön. Folie auf den Details eines Fotos wirkt meist unruhig. |
Folienfarben: gold (klassisch, warm), silver (Winter, Hochzeiten, kühle Paletten), rose (Romantik), copper (Herbst, rustikal), pink (verspielt), holo (holografisch, Geburtstage). Passe sie an die eigene Farbpalette des Bildes und den Anlass an.
Überprüfe die Folie mit foil_preview.py vor dem Bau (sobald die Kartendaten geschrieben sind, Schritt 5). Was als Folie gedacht war, sollte deckend erscheinen, und nichts anderes sollte erfasst werden. Zwei Dinge erfordern oft Anpassung:
- Das, was in Folie sein soll, teilt seine Farbe oder Dunkelheit mit Dingen, die du nicht möchtest, z. B. goldene Buchstaben über Blumen mit goldenen Zentren. Beschränke die Folie mit
folie.bereichauf einen Kasten darum. - Das Standardgold ist blass und klassisch. In einem viel tieferen Gold gezeichnete Kunst kann ihre eigene Tinte haben, damit die Folie dazu passt.
Der Abschnitt Folie in referenzen/optionen.md enthält die Tinten, was menge in jedem Modus bewirkt und den bereich.
Papier (Innenseite, Rückseite und Kanten): white, cream, blush, sage, sky, midnight oder ein beliebiges #rrggbb. Wenn das Bild auf einfarbigem Papier gezeichnet ist, nimmt die Karte standardmäßig dieses Papier, was meist am besten aussieht.
Die Karte wird aus der Bildmitte auf ihre Form zugeschnitten: portrait (5:7, Standard), square, landscape (7:5) oder original (die eigene Form des Bildes, mit Einschränkungen). Verwende landscape für breite Bilder. Wenn das Motiv nahe am Rand sitzt, führe grid.py aus, um zu sehen, was der Schnitt behält.
3. Füge Effekte für den Anlass hinzu (optional)
Diese benötigen keine Positionen, füge sie also frei hinzu, wenn sie zur Karte passen:
snow: Flocken treiben über die Vorderseite (Winter, Weihnachten)hearts: Kleine gemalte Herzen schweben hin und wieder vom Bild auf (Liebe, Valentinstag, Muttertag, Hochzeiten)fireflies: Sanfte Lichter wandern über den unteren Teil (Sommernächte, verträumte Szenen)shootingStars: Ein Stern schießt hin und wieder über den oberen Teil (Nachthimmel)sparkle: Folienpunkte fangen das Licht ein und funkeln (jede Folienkarte)
Ein oder zwei Effekte sind reichlich; mehr wird unruhig.
4. Erwecke sie zum Leben (optional, und der beste Teil)
Eine Karte kann viel mehr: Die Laterne im Bild leuchtet und flackert und lodert, wenn man darauf tippt, die Sonne wirft Strahlen, der Schwanz einer Katze wedelt und Herzen steigen davon auf, wenn man sie streichelt, Zweige wiegen sich und lassen ihren Schnee fallen, Schals flattern im Wind des Zeigers. Dazu werden Positionen auf dem Bild benötigt, die du am Raster von grid.py abliest. Lies referenzen/lebendige-karten.md und folge ihr.
Tue es, wenn die Person darum bittet, dass die Karte lebendig, animiert oder interaktiv ist, oder wenn das Bild offensichtliche Lichter (Kerzen, Laternen, die Sonne, den Mond, beleuchtete Fenster) oder Charaktere enthält. Es dauert eine Weile, also biete es bei einer schnellen Karte als nächsten Schritt an.
5. Schreibe die Kartendaten
Speichere sie als JSON neben dem Bild. Eine Karte:
{
"titel": "Alles Gute zum Geburtstag, Ellie",
"bild": "ellie-geburtstag.jpg",
"alt": "Ein Aquarell eines Fuchses in einer Mohnwiese.",
"name": "Fuchs und Mohn",
"veredelung": "foil",
"folie": { "farbe": "rose", "on": "details", "menge": 0.12 },
"papier": "cream",
"nachricht": "Liebe Ellie,\nAlles Gute zum Geburtstag, mein Lieblingsmensch.\nAuf dein bestes Jahr!\nLiebe, Nora",
"unterschrift": ["Gemacht mit Liebe von", "Nora"],
"effekte": { "hearts": true, "sparkle": true }
}
alt beschreibt die Vorderseite für Bildschirmlesegeräte; schreibe immer eine. name erscheint auf der Rückseite in Kleinschrift, es sei denn, rueckseite oder unterschrift sagt etwas anderes. Mehrere Karten werden in "karten": [ {...}, {...} ] angeordnet, mit titel und seite oben. Jede Einstellung ist in referenzen/optionen.md.
6. Erstelle sie
python scripts/make_card.py karte.json --check # überprüft die Daten, gibt die Pixelgröße der Karte aus
python scripts/make_card.py karte.json -o karte.html
Pfade im JSON sind relativ zur JSON-Datei. Für eine schnelle Karte gibt es auch eine einzeilige Form:
python scripts/make_card.py --image front.jpg --message "Alles Gute zum Geburtstag!" --finish foil --foil gold -o karte.html
Wenn das Skript einen Fehler meldet, sagt es, was falsch ist und wie man es behebt. Warnungen (eine fehlende Nachricht, eine ihm unbekannte Einstellung, eine Position außerhalb der Karte) erstellen dennoch, aber behebe sie.
7. Überprüfe sie
Wenn Node und Playwright verfügbar sind, betrachte die Karte, bevor du sie übergibst:
node scripts/snapshot.mjs karte.html aufnahmen/
node scripts/snapshot.mjs karte.html aufnahmen/ --live # eine Karte, die zum Leben erwacht: prüft auch, was sich bewegt
Dies schreibt die Vorderseite, die Vorderseite mit dem darüber gehaltenen Licht (front-lit: die Folie oder Farbe, die das Licht einfängt), die Innenseite und die Rückseite als PNGs. Betrachte sie: Ist die Nachricht gut lesbar? Sieht die Folie geprägt und nicht gesprenkelt aus? Ist das Bild wie erwartet zugeschnitten? Passe an und erstelle neu; jeder Durchgang ist schnell. Ohne Browser sage einfach, dass du keine Vorschau erstellen konntest (die Folienvorschau funktioniert trotzdem).
8. Übergib sie
Gib der Person die HTML-Datei und erkläre, wie sie sie verwenden soll:
- Öffne sie in einem beliebigen Browser, um die Karte zu sehen. Tippe darauf (oder drücke O), um sie zu öffnen; ziehe sie zur Seite (oder drücke T), um sie umzudrehen.
- Um sie zu versenden, stelle sie online und teile den Link: GitHub Pages, Netlify Drop oder jeder statische Hoster akzeptiert die Datei so, wie sie ist. Oder sende die Datei selbst; sie funktioniert offline.
- Sie ist ein bis zwei Megabyte groß, fast alles davon das Bild.
Erwähne, was du gewählt hast (Veredelung, Folie, Papier, Effekte) in einem Satz, damit sie nach Änderungen fragen können.
Gut zu wissen
- Handyfotos werden richtig herum gedreht und große Bilder werden verkleinert (mit Pillow). Transparente Bereiche werden weiß. HEIC-Fotos müssen zuerst in JPEG konvertiert werden, es sei denn, Pillow kann sie lesen.
- Die Handschrift ist Caveat, in die Seite eingebettet. Sie deckt Latein, erweitertes Latein und Kyrillisch ab; andere Schriften (Vietnamesisch, Griechisch, CJK) fallen auf die handschriftliche Schriftart des Geräts zurück.
- Ohne WebGL zeigt die Seite das Bild und die Nachricht dennoch flach an.
- Die Seite ist bewusst hell gestaltet: Die Karte sitzt auf weißem Hintergrund mit weichen Schatten.
- Um das Aussehen oder Verhalten der Karten über diese Einstellungen hinaus zu ändern, befindet sich der Quellcode des Renderers im GitHub-Repository der Fähigkeit (
renderer/), und ein erneuter Build ersetztassets/greeting-card.js.