Was ein Theme bei Lidarc ist
Auf Lidarc gibt es drei Ebenen. Der Unterbau ist die gemeinsame Technik aller Themes. Ein Theme ist eine Designfamilie darauf: Typografie, Formen, Abstände und wie jeder Block aussieht. Eine Vorlage ist ein fertiger Startpunkt auf einem Theme, mit Look, Beispielseiten und Texten für eine Branche.
Kunden sehen Vorlagen und Bausteine. Agents und der Seiten-Builder arbeiten mit Block-Typen und Feldern. Diese sind in jedem Theme gleich. Darum gilt für dich als Anbieter eine Regel: Dein Theme zeichnet die gemeinsamen Blöcke, es benennt sie nie um.
Heute laufen zwei Themes auf dem Unterbau: Luna (Standard) und Orbit. Eine Website wechselt zwischen ihnen und behält jede Seite, jeden Beitrag, Kopf- und Fusszeile.
Was der Unterbau festlegt
Block-Typen. Jedes Theme zeichnet alle 15 gemeinsamen Typen. Die Feldnamen folgen der Block-Bibliothek: title, subtitle, eyebrow, Buttons als primary_label und primary_href, Listen in items.
| Typ | Wofür |
|---|---|
hero |
Einstieg oben auf der Seite |
features |
Leistungen oder Vorteile im Raster |
split |
Text und Bild nebeneinander |
steps |
Ablauf in Schritten |
stats |
Kennzahlen |
logos |
Kunden, Partner |
testimonials |
Kundenstimmen |
quote |
Ein grosses Zitat |
pricing |
Angebote mit Preisen |
faq |
Fragen und Antworten |
cta |
Aufruf zum Handeln |
contact |
Kontaktwege |
text |
Fliesstext (auch für Impressum und Datenschutz) |
image |
Ein grosses Foto |
posts |
Neueste Blogbeiträge |
Jeder Typ hat in jedem Theme genau dieselben Felder und Auswahl-Optionen. EmDash prüft Blöcke beim Rendern streng gegen das aktive Theme. Ein Feld, das ein Theme kennt und ein anderes nicht, bricht das Rendern nach einem Wechsel ab. Braucht dein Theme ein Feld, das es noch nicht gibt, schlägst du es für den Unterbau vor. Dann bekommen es alle Themes.
Kopf- und Fusszeile sind Bausteine (site_header, site_footer) in der Sammlung „Kopf- und Fusszeile“. Die Felder sind für alle Themes gleich. Kunden wählen die Darstellung, und dein Theme zeichnet, welche es kann:
- Kopfzeile: Schwebend, Leiste, Schlicht, Zentriert.
- Fusszeile: Spalten, Schlicht, Zentriert.
Varianten, die dein Theme nicht kennt, zeichnet es in seiner Standardform.
Blog. Beiträge liegen unter /blog/<slug>, die Übersicht unter /blog, Themen unter /blog/thema/<slug>. Die Felder sind title, excerpt, featured_image und content.
Sprache. Feste Wörter wie „Zum Inhalt springen“, „Alle Rechte vorbehalten“ oder „Weiterlesen“ kommen aus der Sprache der Website, nie fest aus dem Theme.
Design. Farben, Schriften, Rundungen und Stil kommen als Design-Tokens (--ed-primary, --ed-radius …) auf jede Seite. Ein Look stellt sie alle auf einmal um. Dein Theme bindet seine eigenen Variablen an diese Tokens, statt eigene Farbwähler zu erfinden.
Was du nicht bauen musst: Platzhalter für Geschäftsdaten ({{phone}}, {{hours}}), Angaben für Suchmaschinen (schema.org), Bausteine der Bibliothek und die Prüfung von Eingaben. Das erledigt Lidarc für jedes Theme.
Aufbau eines Theme-Pakets
Ein Theme ist ein Astro-Theme für EmDash, gebaut zu einem Paket, das im Browser rendert:
| Datei | Inhalt |
|---|---|
theme.json |
Name, Version, Schema (Sammlungen, Block-Typen), Design-Optionen, Token-Zuordnung, Beispielinhalte |
renderer/entry.mjs |
Theme und EmDash-Laufzeit als Browser-Paket |
client/… |
CSS, Skripte, Schriften und Bilder der Seiten |
preview.png |
Vorschau für den Store, 1280 × 800 |
Der Canister rendert nicht selbst. Beim Veröffentlichen rendert der Browser alle Seiten mit deinem Theme, der Canister liefert danach fertiges HTML aus.
Schritt für Schritt
- Astro-Theme für EmDash. Starte mit einem EmDash-Template oder bringe ein bestehendes Astro-Theme mit. Eigene Änderungen kommen als Overlay neben das Original, so bleibt ein Upstream-Update möglich.
- Schema aus dem Unterbau. Dein Seed-Skript übernimmt die gemeinsamen Typen samt Feldern und die Umzugstabelle für ältere Namen (
blocks.add). Dazu kommen Kopf- und Fusszeile (frame.add). - Layout. Dein Layout liest Kopf- und Fusszeile aus den Bausteinen (
loadFrame) und holt feste Wörter auswords(). - Blöcke zeichnen. Jeder gemeinsame Typ bekommt eine Komponente. Hat dein Theme eigene Feldnamen, übersetzt eine Tabelle sie beim Zeichnen (
blocks-legacy.json). Die Daten behalten die gemeinsamen Namen. - Design-Tokens binden. In
theme.json → tokenssteht, welche Variable deines Themes hinter welchem Token steht. Die Design-Optionen bekommen ihre Rolle (brand,bg,fontHeading,fontBody…), damit Looks greifen. - Bauen. Das Theme-Kit macht aus dem Astro-Projekt das Browser-Paket.
- Prüfen.
node scripts/check-theme.mjs <paket>muss ohne Fehler durchlaufen (nächster Abschnitt). - Einreichen im Store, siehe unten.
Regeln
- Keine eigenen Block-Typen. Was nur dein Theme kann, wird ein Baustein der Bibliothek. Dann läuft er in jedem Theme.
- Keine Anfragen an Dritte: Schriften, Skripte und Bilder kommen von der Website selbst. Keine Analytics, kein CDN.
- Hell und dunkel: Farben als Paar (
light-dark()), lesbar in beiden Modi. - Alles, was aus Inhalten kommt, wird escaped. Links nur mit
/,https://,mailto:,tel:oder#. - Kein Netzwerk beim Rendern: Alles, was eine Seite braucht, steckt im Seed oder im Paket.
- Halte das Paket klein. Zum Vergleich: Luna hat gepackt 1,3 MB.
Die Abnahme-Prüfung
scripts/check-theme.mjs prüft ein gebautes Paket, bevor es in den Store geht:
- alle 15 Typen, jeder mit genau den gemeinsamen Feldern und Optionen, keine eigenen Typen
- Kopf- und Fusszeile als Bausteine, Sammlung „Kopf- und Fusszeile“
- Seiten unter
/{slug}, Blog unter/blog/{slug}, Themen-Taxonomie - Umzugstabelle: ältere Namen zeigen auf gemeinsame Typen
- Design-Tokens gebunden, Design-Optionen mit Rolle
- Paketgrösse, Vorschaubild
- keine Schriften, Skripte oder Tracker von Drittanbietern
Was ein Skript nicht sieht, prüfen wir beim Einreichen im Browser: jeden Baustein in jedem Look, hell und dunkel, ohne Kontrast- oder Überlauf-Fehler, und einen Theme-Wechsel hin und zurück.
Einreichen im Store
Anbieter laden ihre Pakete mit einem eigenen Anbieter-Schlüssel in den Store. Ein neues Paket steht auf „in Prüfung“ und wird erst ausgeliefert, wenn Lidarc es freigibt. Updates reichst du mit einer höheren Versionsnummer ein. Websites, die dein Theme nutzen, bekommen das Update angeboten.
Bausteine statt Themes: Wer eine einzelne Sektion bauen will, etwa einen Preisrechner oder eine Galerie, baut einen Baustein (React oder Svelte). Er liest nur Design-Tokens und läuft in jedem Theme.
Stand im Pilot
Lidarc ist im Pilot. Das Theme-Kit, der Unterbau (blocks.py, types.json, frame) und die Prüfung erscheinen mit dem offenen Kern unter AGPL nach dem Pilot. Bis dahin bekommst du sie als Entwickler über den Pilot-Zugang: Schreib uns, welches Theme du bauen möchtest.