Was macht HTML-Diagramme und -Präsentationen?
Diese Fähigkeit (ein Agent Skill: Claude Code, GitHub Copilot und andere Agenten lesen sie) bietet zwei kleine Figurenbibliotheken, eine Präsentations-Engine, drei Designs und drei Vorlagen. Jedes Ergebnis ist eine HTML-Datei, die offline funktioniert, sobald GSAP gecached ist, dem hellen oder dunklen Design des Betrachters folgt und als Claude.ai-Artifact veröffentlicht werden kann.
| Pfad | Beschreibung |
|---|---|
lib/edgediagram.js | Deklarative SVG-Graphen: zone, node, text, link (standardmäßig orthogonal, Pfeile, Beschriftungen, Paketflüsse), fan (ein Punkt versorgt mehrere Knoten), bindFocus, steps und eine Layout-Prüfung bei jedem Schritt |
lib/edgesketch.js | Handgezeichnete Figuren auf einem Raster: zone, box (passt sich dem Text an; vertikale Spalten und zentrierte Balken), arrow (rechte Winkel, zwei Köpfe), connect (Box zu Box), fan, text; und EdgeSketch.check, eine Layout-Prüfung für jedes SVG, inklusive schräger und gebogener Linien |
lib/icons.js | window.EDGE_ICONS: 50 Liniensymbole auf einem 24-Einheiten-Raster (Netzausrüstung, Rechnen, Vertrauen, Betrieb) |
lib/edgedeck.js | EdgeDeck.run: eine 1600×900 Folienbühne mit schrittweisem Folienaufbau, Bildunterschriften, Tastatur-, Wisch- und #n-Links |
themes/*.css | Farb- und Schriftart-Designs, hell und dunkel, auf einem Token-Vertrag: engineering (blau auf grün-grau, Archivo Narrow und IBM Plex), indigo (indigo auf lavendel-grau, Space Grotesk und Inter), drafting (türkis auf warmem Papier, Barlow Condensed und Source Sans 3) |
templates/diagram.html | Eine schrittweise EdgeDiagram-Figur mit Bildunterschriften, Vorher/Zurück und Punkten |
templates/sketch.html | Eine handgezeichnete EdgeSketch-Figur: Zonen von links nach rechts, Spalten, Dienste, Doppelpfeile, eine Legende |
templates/deck.html | Eine Titelfolie plus eine Inhaltsfolie, deren Diagramm Schritt für Schritt aufgebaut wird |
scripts/inline.py | Bettet die Bibliotheksdateien und das Design in eine Seite ein, sodass sie als eine Datei veröffentlicht wird; bricht ab, wenn etwas nicht gefunden wird |
scripts/shot.sh | Headless-Screenshots (hell oder dunkel, beliebige Breite, nach bestimmten Klicks, --only für ein Element, --full Seite) und --check, die Layout-Prüfung jeder Figur auf einer Seite |
scripts/todrawio.sh | Exportiert eine Figur einer erstellten Seite in eine draw.io-Datei, um sie dort zu bearbeiten: EdgeDiagram-Figuren mit ihren angehängten Verbindungen, handgezeichnete SVG-Figuren, HTML-Figuren |
scripts/check_theme.py | Überprüft den WCAG-Kontrast eines Designs in hell und dunkel und dass seine beiden dunklen Blöcke übereinstimmen |
scripts/theme_from_design.py | Erstellt aus einer DESIGN.md-Datei (Farben und Schriften einer Marke) ein Design, hell und dunkel, jedes Paar mit seinem Kontrast |
scripts/test.sh | Führt die Tests in tests/ aus; nach Änderungen an lib/, scripts/ oder themes/ ausführen |
scripts/vendor.sh | Kopiert die Bibliothek in ein anderes Projekt; --check zeigt, ob diese Kopie veraltet ist |
references/api.md | Jede Option beider Bibliotheken und der Präsentations-Engine |
references/conventions.md | Tokens, die Bedeutung jedes Farbtons, Layout-Regeln, Veröffentlichung und die durchzuführenden Prüfungen |
examples/ci-canary-deck.html | Eine vollständige Zwei-Folien-Präsentation zu einem neutralen Workflow (CI/CD, dann ein Canary-Rollout) |
examples/isometric/ | Ein isometrischer Generator für geschichtete Figuren (der SGAM-Würfel), mit gewonnenen Erkenntnissen |
examples/design-md/DESIGN.md | Eine beispielhafte DESIGN.md (Harbor), um daraus ein Design zu erstellen |
Arbeitsablauf
- Lege fest, was die Abbildung zeigen soll. Benenne den Mechanismus, die Teile, von denen er abhängt, und die Reihenfolge, in der er enthüllt werden soll. Ein Satz, der es schneller sagt, ist besser als eine Abbildung.
- Wähle die Bibliothek. Ein Graph aus Teilen, die durch sinnvolle Verbindungen verbunden sind, Schritt für Schritt enthüllt: EdgeDiagram (
templates/diagram.html). Ein Raster aus Boxen, ein geschichteter Stapel oder eine Ansicht von links nach rechts, bei der die Anordnung die Bedeutung trägt: EdgeSketch (templates/sketch.html). Eine Präsentation:templates/deck.html, mit einer der beiden Bibliotheken auf den Folien. - Kopiere die Vorlage in das Arbeitsverzeichnis, z. B.
cp <skill>/templates/sketch.html ./meine-figur.html. Korrigiere die<script src>- und Themenpfade, sodass sie auf<skill>/lib/und<skill>/themes/zeigen, oder führe am Endeinline.pymit--libund--themesaus. - Lege auf einem Raster aus. Wähle die viewBox, dann die Zonen, dann die Boxen (gleiche Größen, gleichmäßige Abstände), dann die Verbindungen (siehe Verbindungen unten). Platziere Boxen, die miteinander kommunizieren, in derselben Zeile oder Spalte, sodass ihre Verbindung eine gerade Linie ist. Gib Links, die eine Bedeutung haben, ein
info. Lesereferences/api.mdfür die Optionen. - Schreibe die Schritte (EdgeDiagram). Schritt 0 ist der Ruhezustand. Jeder weitere Schritt fügt eine Idee hinzu und hat eine kurze Bildunterschrift. Verwende
flowsfür die Daten, die sich bewegen, unddimoderhidefür das, worüber der Schritt hinweggeht. - Design. Seiten verlinken ein Design, `<link rel=