Lidarc
EN Anmelden Zugangscode anfragen
Produkt Live-Demo Entwickler Vorlagen Blog Anmelden Zugangscode anfragen
Zur Startseite
Für Entwickler

Baue ein Theme für Lidarc.

Ein Theme bestimmt bei Lidarc nur das Aussehen. Inhalte, Feldnamen und Verhalten gehören dem gemeinsamen Unterbau. So wechselt eine Website das Theme, ohne einen Block zu verlieren.

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

  1. 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.
  2. 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).
  3. Layout. Dein Layout liest Kopf- und Fusszeile aus den Bausteinen (loadFrame) und holt feste Wörter aus words().
  4. 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.
  5. Design-Tokens binden. In theme.json → tokens steht, welche Variable deines Themes hinter welchem Token steht. Die Design-Optionen bekommen ihre Rolle (brand, bg, fontHeading, fontBody …), damit Looks greifen.
  6. Bauen. Das Theme-Kit macht aus dem Astro-Projekt das Browser-Paket.
  7. Prüfen. node scripts/check-theme.mjs <paket> muss ohne Fehler durchlaufen (nächster Abschnitt).
  8. 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.