Theme: Farben, Schriften und Abstände
Farben, Schrift, Abstände und Rundungen Ihrer Website zentral festlegen, live in der Vorschau sehen, mit ihrer Verwendung pflegen, als Entwurf speichern, veröffentlichen und frühere Versionen zurückholen.
Worum es geht
Das Theme enthält die Gestaltungswerte Ihrer Website: Hauptfarbe, Hintergrund, Schrift, Grundabstand, Rundung von Ecken, Schatten. Diese Werte heissen Design-Tokens. Ändern Sie eine Farbe im Theme, übernimmt Ihre Website sie überall dort, wo sie das Token verwendet – ohne dass jemand den Code anfassen muss.
Änderungen am Theme gehen nicht sofort live: Speichern legt einen Entwurf an, erst Veröffentlichen stellt die Werte auf alle Seiten. Jede Änderung wird eine Version im Verlauf und lässt sich zurückholen.
Voraussetzungen
- Recht Theme verwalten. Es deckt Speichern und Veröffentlichen.
- Themes gehören zur aktiven Umgebung.
- Ihre Website muss die Tokens verwenden. Die Vorlagen von Scorebase tun das; bei einer eigenen Website fragen Sie Ihren Entwickler.
Ein Theme anlegen und als Standard setzen
- Öffnen Sie Theme. Die Seite heisst Theme-Builder.
- Klicken Sie auf Neues Theme, geben Sie einen Name ein (z.B. „Marke Hell“) und klicken Sie auf Erstellen. Das Theme startet mit Standardwerten.
- Passen Sie die Werte an (siehe unten) und klicken Sie auf Speichern. Gespeichert wird ein Entwurf.
- Klicken Sie auf Veröffentlichen. Jetzt gelten die Werte auf allen Seiten, die das Theme verwenden.
- Klicken Sie auf Als Standard. Ihre Website verwendet immer das Standard-Theme der Umgebung; es ist mit Standard markiert.
Name und Als Standard wirken sofort, ohne Veröffentlichen – der Hinweis unter dem Namen sagt es. Die Website zeigt dann die veröffentlichten Werte des neuen Standard-Themes, nicht einen offenen Entwurf.
Löschen entfernt ein Theme dauerhaft samt seinen Versionen; das lässt sich nicht rückgängig machen. Die Einträge im Verlauf bleiben erhalten.
Entwurf, Veröffentlichen und Verlauf
Die Leiste über den Reitern
Über den Reitern fasst eine Leiste zusammen, was gilt, z.B. „Entwurf gespeichert · nicht veröffentlicht · Version 8 von Anna Meier, vor 5 Minuten · Live ist Version 7“ oder „Veröffentlicht · Version 7 · Keine unveröffentlichten Änderungen“. Rechts daneben stehen Verlauf, Weitere Aktionen (⋯), Speichern und Veröffentlichen.
- Speichern sichert Ihre Änderungen als Entwurf. Die Website zeigt weiter die veröffentlichte Version; der Hinweis darunter nennt sie („Speichert als Entwurf. Die Website zeigt weiter Version 7.“). Auf der Tastatur geht es mit Strg+S bzw. Ctrl+S (am Mac mit der Befehlstaste).
- Veröffentlichen stellt den gespeicherten Entwurf sofort auf alle Seiten der Umgebung („Geht sofort in der Umgebung „Produktion“ live.“). Es entsteht keine neue Version: die neueste wird live. Mit ungespeicherten Änderungen heisst der Knopf Speichern und veröffentlichen. Fehlen im Entwurf Werte, die noch verwendet werden, fragt Scorebase vorher nach (siehe „Veröffentlichen: was wegfällt und was noch fehlt“ weiter unten).
- Zeigt die Website schon den gespeicherten Stand, gibt es nichts zu veröffentlichen; der Knopf ist dann ausgegraut.
- Entwurf verwerfen unter Weitere Aktionen: Nach einer Rückfrage gilt wieder die veröffentlichte Fassung. Die verworfenen Werte bleiben im Verlauf und lassen sich zurückholen.
In der Liste links trägt ein Theme mit gespeichertem, noch nicht veröffentlichtem Entwurf ein Stift-Symbol („Unveröffentlichte Änderungen“).
Verlauf
Verlauf öffnet rechts die Liste aller Änderungen, die neueste zuerst: wer etwas getan hat oder über welchen Weg (z.B. Kommandozeile, API-Schlüssel, aus Umgebung befördert), was geschah, wann, und wie viele Theme-Werte sich geändert haben. Die Marken Live und Entwurf zeigen, welche Version auf der Website steht und welche im Entwurf wartet.
- In Entwurf zurückholen übernimmt die Werte einer früheren Version als neuen Entwurf. Die Website ändert sich erst, wenn Sie veröffentlichen. Der Name bleibt, wie er ist.
- Wieder veröffentlichen stellt eine frühere Version sofort live. Das geht nur ohne offenen Entwurf; der Knopf ist sonst ausgegraut mit dem Hinweis „Erst den offenen Entwurf veröffentlichen oder verwerfen.“
- Mit ungespeicherten Änderungen im Editor sind beide Knöpfe gesperrt.
Wenn mehrere Personen gleichzeitig arbeiten
Hat jemand anderes das Theme gespeichert, seit Sie es geöffnet haben, speichert Scorebase nicht einfach darüber. Es erscheint Dieses Theme wurde inzwischen geändert mit den Werten, die die andere Person geändert hat:
- Neu laden (meine Änderungen verwerfen): Sie arbeiten mit dem gespeicherten Stand weiter.
- Trotzdem überschreiben: Ihre Fassung wird als neuer Entwurf gespeichert. Der überschriebene Stand bleibt als Version im Verlauf.
- Abbrechen speichert nichts.
Wechseln Sie mit ungespeicherten Änderungen auf ein anderes Theme oder eine andere Seite, fragt Scorebase nach: Bleiben, Verlassen und verwerfen oder Speichern und verlassen (gespeichert wird als Entwurf).
Werte ändern: der Reiter „Tokens“
Die Tokens sind in Gruppen geordnet. Fünf Kern-Gruppen gibt es immer:
| Gruppe | Enthält (Beispiele) |
|---|---|
colors |
Primär-, Sekundär-, Hintergrund-, Text- und Akzentfarbe, Rahmen, dazu Farben für Erfolg, Warnung und Gefahr |
typography |
Schriftart, Grundgrösse der Schrift, Skalierung der Überschriften |
spacing |
Grundabstand |
radius |
Rundung der Ecken |
effects |
Schatten |
Kern-Gruppen und Kern-Tokens lassen sich nicht löschen oder umbenennen; ihre Werte ändern Sie jederzeit. Die Live-Vorschau zeigt an einer Beispiel-Karte, wie die Werte wirken – schon vor dem Speichern.
Werte hinzufügen, bearbeiten, löschen
Oben im Reiter Tokens steht die Übersicht: Farben als Raster, darunter Abstände, Schriftgrössen, Radien und Schatten als Skalen. Die Zahl hinter der Überschrift nennt, wie viele Werte die Gruppe hat.
- Farbe hinzufügen legt eine neue Farbe an. Name und Wert passen Sie danach über Bearbeiten an.
- Jeder Wert hat das Menü Aktionen (⋯) mit Bearbeiten, Löschen und der Verwendung: „Verwendet in 3 Stellen“, solange sie noch nicht geprüft ist Verwendung prüfen. Blöcke anzeigen listet die Seiten, Layouts und Komponenten, die den Wert verwenden, mit Block und Eigenschaft; Stellen, die nur in einem Entwurf stehen, tragen die Marke Nur im Entwurf. Die Liste sehen Sie nur mit dem Recht, Seiten zu lesen; sonst nur die Zahl.
- Bearbeiten öffnet Theme-Wert bearbeiten mit Name im Theme und Wert. Darunter steht die Variable, unter der Websites den Wert kennen, z.B.
--colors-primary. Übernehmen ändert den Entwurf; die Website ändert sich erst beim Veröffentlichen. - Löschen fragt nach und nennt die Stellen, die den Wert verwenden („Dieser Wert wird nicht verwendet.“, wenn es keine gibt). Das Löschen ändert nur den Entwurf. Bis zum Veröffentlichen verwerfen Sie den Entwurf, danach holen Sie den Wert über den Verlauf zurück. Kern-Werte lassen sich nicht löschen; der Eintrag ist dann ausgegraut.
Skalen ergänzen und Stufen löschen
Fehlen einem Theme Standard-Skalen, bietet ein Hinweis Skalen ergänzen an. Ergänzen fügt nur Fehlendes hinzu und ändert keine vorhandenen Werte; neu ergänzte Skalen tragen die Marke Neu · Standardwerte. Die ergänzten Werte gelten nach Speichern und Veröffentlichen auf allen Seiten.
- Stufe hinzufügen über einer Skala ergänzt die nächste fehlende Standard-Stufe. Hat die Skala alle Standard-Stufen, ist der Knopf ausgegraut.
- Eine einzelne Stufe löschen Sie wie jeden Wert über Aktionen › Löschen. Die Rückfrage zeigt, wo die Stufe verwendet wird; das Löschen wirkt im Entwurf und lässt sich über den Verlauf zurückholen.
Unzulässige Werte
Farben, Grössen und Schatten nimmt Scorebase nur in Formen an, die Websites sicher übernehmen. Ein Wert mit url(, einem Semikolon, geschweiften Klammern oder Anführungszeichen wird beim Speichern abgelehnt. Das gilt im Theme-Builder, bei hcms theme push und bei Themes aus dem Marketplace. Im Theme-Builder steht der Grund unter dem Feld, z.B. „„Hauptfarbe“ enthält Zeichen, die Websites nicht übernehmen, zum Beispiel url( oder ein Semikolon.“ oder „„Abstand“ ist kein gültiger Wert für den Typ Grösse.“
Ältere Werte, die diese Regel verletzen, sperren das Speichern nicht. Scorebase weist einmal darauf hin („… enthält einen Wert, den Websites verwerfen. Er bleibt, bis Sie ihn ändern.“). Websites verwerfen einen solchen Wert und zeigen ihre Vorgabe.
Theme live in der Vorschau
Vorschau öffnen neben dem Namen des Themes öffnet Ihre Website in einem eigenen Vorschaufenster. Ändern Sie einen Wert, erscheint die Änderung dort nach einem kurzen Moment, noch bevor Sie speichern. Neben dem Knopf steht, wie viele Fenster verbunden sind, z.B. „Live in 2 Vorschaufenstern“ oder „Kein Vorschaufenster offen“.
- Den ungespeicherten Stand sehen nur Ihre eigenen Vorschaufenster. Andere Personen und Besucher sehen ihn nicht.
- Gespeicherte und veröffentlichte Theme-Änderungen erscheinen in allen offenen Vorschaufenstern der Umgebung, auch in denen anderer Personen.
- Die Vorschau gibt es nur für das Standard-Theme der Umgebung („Die Vorschau ist nur für das Standard-Theme verfügbar.“).
- Voraussetzung ist eine Vorschau-URL in den Einstellungen der Umgebung, siehe Umgebungen. Die Vorlagen von Scorebase zeigen das Theme in der Vorschau live; bei einer eigenen Website fragen Sie Ihren Entwickler.
Werte aus dem Stil-Inspektor
Der Stil-Inspektor (Reiter Stil im Seiten- und Layout-Editor, Stil-Panel im Vorschaufenster) bietet am gewählten Block die Werte dieses Themes an: Farben, Abstände, Schriften, Rundungen und Breiten. Wählen Sie einen Wert, speichert der Block nur den Verweis darauf, z.B. {colors.primary}. Ändern Sie später den Wert im Theme, ändert er sich überall, wo er gewählt ist. Auf Vorgabe zurücksetzen entfernt die Wahl. Bei Farben zeigt der Inspektor, ob der Kontrast ausreicht. Wie Sie einen eigenen Wert zum Wert des Themes machen, steht im nächsten Abschnitt.
Der Inspektor zeigt nur Eigenschaften, die der Block annimmt (bei eigenen Blöcken über styleProps, siehe Eigene Blöcke), und nur Werte, die das Theme kennt. Ein Wert, den das Theme nicht kennt, bleibt am Block gespeichert, zeigt aber den Hinweis, dass Websites ihn verwerfen.
Als Theme-Wert speichern
Einen eigenen Wert, den Sie an einem Block eingegeben haben, machen Sie zu einem Wert des Themes. Andere Blöcke können ihn danach auswählen, und eine spätere Änderung im Theme wirkt überall, wo er verwendet wird.
- Wählen Sie im Seiten-Editor den Block und öffnen Sie den Reiter Stil. Im Vorschaufenster geht es ebenso über das Stil-Panel des gewählten Blocks.
- Geben Sie unter Eigener Wert den Wert ein, z.B.
#d98e04, und klicken Sie auf Als Theme-Wert speichern. - Geben Sie den Namen im Theme ein, z.B. „Gold“, und klicken Sie auf Ins Theme speichern. Der Block verweist jetzt auf den neuen Wert.
Gut zu wissen:
- Dafür brauchen Sie das Recht Theme verwalten. Ohne dieses Recht steht nur Nur hier verwenden zur Verfügung.
- Der Wert kommt in den Entwurf des Standard-Themes. Die Website kennt ihn erst, wenn das Theme veröffentlicht ist. Soll er sofort gelten, veröffentlichen Sie anschliessend das Theme.
- Gibt es denselben Wert schon im Theme, verwendet Scorebase ihn, statt einen zweiten anzulegen.
- In der Umgebung hike gibt es diese Funktion nicht; dort legt das Portal die Farben fest.
Veröffentlichen: was wegfällt und was noch fehlt
Theme veröffentlichen, wenn Werte wegfallen. Haben Sie im Entwurf Werte gelöscht, die Seiten, Layouts oder Komponenten noch verwenden, fragt Scorebase vor dem Veröffentlichen nach: Theme trotzdem veröffentlichen? Der Dialog nennt jeden dieser Werte mit der Zahl der Stellen, z.B. „Gold · an 2 Stellen verwendet“. An diesen Stellen zeigen Websites nach dem Veröffentlichen ihre Vorgabe.
- Trotzdem veröffentlichen stellt den Entwurf live.
- Abbrechen ändert nichts; auch ungespeicherte Änderungen werden dabei nicht gespeichert.
- Lässt sich die Verwendung nicht prüfen, nennt der Dialog alle Werte, die wegfallen.
- Geänderte Werte nennt der Dialog nicht: Websites verwenden die Variablen auch direkt, eine Zahl wäre irreführend.
Seite oder Layout veröffentlichen, wenn ein Wert erst im Theme-Entwurf steht. Verwendet eine Seite oder ein Layout einen Theme-Wert, der nur im Entwurf des Themes steht (z.B. eben mit Als Theme-Wert speichern angelegt), geht sie trotzdem live. Danach erscheint der Hinweis „Die Seite verwendet einen Theme-Wert, der noch nicht veröffentlicht ist: Gold“. Bis das Theme veröffentlicht ist, zeigt die Website an diesen Stellen ihre Vorgabe. Theme öffnen im Hinweis führt hierher (nur mit dem Recht Theme verwalten).
Eigene Gruppen und Tokens
- Gruppe hinzufügen: Key (z.B.
buttons) und optional eine Bezeichnung. - Token hinzufügen: Key (z.B.
gap), Typ (Farbe, Grösse, Zahl, Text, Schatten oder Schriftart) und optional eine Bezeichnung.
Jedes Token wird auf der Website zu einer CSS-Variable im Muster --<gruppe>-<token>, z.B. --colors-primary. Unter CSS-Variablen sehen Sie alle Namen; Variablen-Namen kopieren übernimmt sie in die Zwischenablage.
Wichtig: Löschen Sie ein Token oder eine Gruppe, entfällt die zugehörige CSS-Variable – auf der Website erst beim Veröffentlichen. Bis dahin lässt sich der Entwurf verwerfen, danach holen Sie den Wert über den Verlauf zurück. Eine Website, die die Variable verwendet, muss angepasst werden. Stimmen Sie das vorher mit Ihrem Entwickler ab.
Reiter „Bibliothek“ und „Token-Inventar“
- Bibliothek zeigt die Bausteine der Scorebase-Bausteinbibliothek mit Vorschau. Je Baustein steht, wie viele Tokens er nutzt und wie viele davon in Ihrem Theme gesetzt sind. „Interaktiv“ kennzeichnet Bausteine mit eigener Bedienung.
- Token-Inventar zeigt, welche Bausteine welche Tokens nutzen, und markiert fehlende Tokens mit „fehlt“. Mit Token anlegen ergänzen Sie ein fehlendes Token direkt. Darunter stehen Tokens, die kein Baustein der Bibliothek nutzt – sie können trotzdem von Ihrer eigenen Website verwendet werden.
Farbwelten und Farbrollen
Die Komponenten der Bibliothek verweisen auf Farbrollen wie Hauptfarbe, Hintergrund, Schrift, Karte oder Rahmen. Fehlt Ihrem Theme eine dieser Rollen, weist ein Hinweis darauf hin. Ergänzen fügt nur Fehlendes hinzu und ändert keinen vorhandenen Wert.
Unter Farbwelten wählen Sie eine geprüfte Palette aus 48 Farbwelten, 36 hellen und 12 dunklen. Jedes Rollenpaar ist auf ausreichenden Kontrast geprüft. Ausprobieren zeigt die Welt in der Vorschau, ohne etwas zu speichern. Anwenden nennt zuerst, wie viele Werte sich ändern und wie viele neu entstehen, und schreibt sie danach in den Entwurf. Live geht das Theme erst mit Veröffentlichen.
Im Marketplace veröffentlichen
Mit Im Marketplace veröffentlichen stellen Sie ein Theme anderen Organisationen zur Verfügung. Dafür brauchen Sie das Recht Bausteine im Marketplace veröffentlichen, und der Marketplace muss in Ihrer Organisation freigeschaltet sein. In den Marketplace gehen immer die veröffentlichten Werte, nie ein offener Entwurf. Details: Marketplace.
Theme in der Hike-Umgebung
In der Umgebung hike zeigt Theme eine lesende Markenpalette statt des Theme-Editors. Das Hike-Portal zeichnet die Gestaltung selbst. Seiten wählen nur aus fünf Hintergründen und vier Abstandsstufen; ein Theme wirkt in dieser Umgebung nicht. Die Palette zeigt Namen, Texthelligkeit und Abstandsbereiche. Es gibt dort keine Bearbeitungs-, Speicher- oder Veröffentlichungsfunktion.
Für Entwickler
Die Content API liefert die Tokens des Standard-Themes unter GET /theme als { gruppe: { token: wert } } – immer die veröffentlichten Werte, nie einen Entwurf. Nur mit einer gültigen Vorschau-Sitzung (Kopf X-Hcms-Vorschau oder GET /theme?previewToken=…, im SDK serverseitig theme.get({ previewToken })) kommt ohne Cache der Stand des Vorschaufensters: der ungespeicherte Stand der Person, sonst der Theme-Entwurf, sonst die veröffentlichten Werte. Verwenden Sie die Werte als CSS-Variablen mit Ersatzwert, z.B. var(--colors-primary, #2563eb). Das Ereignis theme.updated kommt beim Veröffentlichen, Umbenennen und beim Wechsel des Standard-Themes; Speichern und Verwerfen eines Entwurfs melden theme.draft_saved bzw. theme.draft_discarded (ohne Aktualisierung der Website).
Themes lassen sich auch als Datei pflegen, siehe Website als Code:
hcms theme pullzieht den neuesten Stand (auch einen offenen Entwurf) und schreibt die Version in jede Datei.hcms theme pushspeichert als Entwurf; live geht es mit Veröffentlichen in Scorebase oder mithcms theme push --veroeffentlichen. Hat jemand das Theme seit dem Ziehen geändert, bricht der Push ab;--forceüberschreibt.hcms theme diffzeigt, was ein Push ändern würde, samt offener Entwürfe.
Welche Tokens die Bausteine eines Projekts brauchen, prüft hcms tokens check, siehe Bausteinbibliothek.
Wenn etwas nicht klappt
| Symptom | Ursache | Lösung |
|---|---|---|
| Gespeicherte Werte erscheinen nicht auf der Website | Gespeichert ist erst der Entwurf (Leiste: „Live ist Version …“) | Veröffentlichen klicken |
| Die Website übernimmt eine Farbe nicht | Das Theme ist nicht Standard, liegt in einer anderen Umgebung, oder die Website speichert das Theme zwischen | Standard setzen, Umgebung prüfen; Webhook für theme.updated einrichten lassen |
| Wieder veröffentlichen ist ausgegraut | Es gibt einen offenen Entwurf | Den Entwurf zuerst veröffentlichen oder verwerfen |
| „Dieses Theme wurde inzwischen geändert“ | Jemand anderes hat seit dem Öffnen gespeichert | Neu laden oder Trotzdem überschreiben wählen |
| „Ungültiger Key“ | Keys beginnen mit einem Kleinbuchstaben und enthalten nur Kleinbuchstaben, Ziffern und Bindestriche | Key anpassen |
| „Key bereits vergeben“ | Das Token oder die Gruppe gibt es schon | Anderen Key wählen |
| Ein Baustein sieht falsch aus | Ihm fehlt ein Token | Im Token-Inventar fehlende Tokens anlegen |
| „… enthält Zeichen, die Websites nicht übernehmen“ | Der Wert enthält z.B. url( oder ein Semikolon |
Wert als Farbe, Grösse oder Schatten ohne diese Zeichen eingeben |
| Nach dem Veröffentlichen einer Seite: „Die Seite verwendet einen Theme-Wert, der noch nicht veröffentlicht ist“ | Der Wert steht nur im Entwurf des Themes | Theme öffnen und das Theme veröffentlichen |
| Theme trotzdem veröffentlichen? erscheint | Der Entwurf löscht Werte, die noch verwendet werden | Werte wiederherstellen (Verlauf) oder die Stellen anpassen; sonst Trotzdem veröffentlichen |
| Vorschau öffnen fehlt oder meldet „nur für das Standard-Theme“ | Gewählt ist nicht das Standard-Theme | Standard-Theme wählen oder Als Standard setzen |