Design Tokens (Atome)¶
Design Tokens sind die kleinsten fest definierten Bausteine des doubleSlash PlantUML Style Guides - vergleichbar mit den Farben im doubleSlash Web Style Guide.
Auf dieser Seite finden Sie die Standard-Werte, die in allen Diagrammen gelten.
Autoren vs. Maintainer
Diagramm-Autoren sollen Tokens und Stereotypen referenzieren - keine eigenen Hex-Werte oder skinparam-Overrides. Theme-Maintainer ändern Werte zentral im Repo und passen diese Seite an.
Verbindliche Do/Don't-Regeln: Autoren-Regeln · Implementierungsdetails: Theme-Entwicklung
Farb-Tokens¶
Die Farbpalette folgt dem doubleSlash Web Style Guide – Colors. Token-Namen entsprechen doubleslash/colors.puml ($DS_CYAN, $TEXT_BLACK, …).
Die meisten Farben sind modusabhängig (light / dark). Primary Cyan ist die einzige Markenfarbe und gilt in beiden Modi identisch.
Die Übersicht definiert den verbindlichen Soll-Standard für PlantUML-Diagramme. Tokens sind nach Elementkategorien gruppiert (Formen, Verbindungen, Text, Container, Diagramm-Metadaten, Semantik). Wird derselbe HEX-Wert für unterschiedliche Rollen genutzt, steht er in eigenen Zeilen.
Übersicht { #ubersicht }¶
| Kategorie | Element / Rolle | Token | Verwendung (PlantUML) | Light | Dark |
|---|---|---|---|---|---|
| Markenfarbe | Primary Cyan | $DS_CYAN, $INFO |
Markenidentität, Akzente, Info-Hervorhebung | #00A5E1 |
#00A5E1 |
| Primär (Clickable) | Deep Ocean Blue / Bright Sky | $DS_CLICKABLE / $DS_DARK_CLICKABLE |
Interaktive Elemente: Rahmen, Links, Buttons, Sequence-Lifeline, Group-Header | #00759E |
#77DDFF |
| Formen – Rahmen | Primary / Markenblau | $DS_BLUE, $PRIMARY |
Rahmen Class, State, Activity, Component; Start/End-State; Package-Rahmen | #00759E |
#77DDFF |
| Formen – Füllung | Blau-Tint | $DS_LIGHTBLUE, $SECONDARY |
Hintergrund Class, State, Activity, Use Case, Component, Participant, Collections | #D7E9F4 |
#22303C |
| Formen – Füllung | Interface | $DS_CYAN |
Interface-Hintergrund und -Rahmen (BorderThickness 2) | #00A5E1 |
#00A5E1 |
| Formen – Füllung | Extern / Fremdsystem | $SUPERLIGHTGREY ‡ |
<<external>>, <<External>>: Class, Agent, Database, Participant, Use Case |
#F8F8F8 |
#2D2D2D |
| Formen – Füllung | Actor | $DS_LIGHTGREY |
Use-Case-Actor-Hintergrund und -Rahmen | #C6C6C6 |
#B6B6B6 |
| Formen – Füllung | Extern-Interface | $DS_GREY |
<<external>> Interface-Hintergrund und -Rahmen |
#7A7A7A |
#7A7A7A |
| Verbindungen | Pfeile & Linien | $DS_GREY |
ArrowColor, Sequence-Pfeile, Activity-Pfeile; Legenden-Rahmen; Group-/Box-Rahmen |
#7A7A7A |
#7A7A7A |
| Verbindungen | Rahmen dezent | $DS_LIGHTGREY |
Swimlane-Rahmen; Sequence-Reference-Rahmen | #C6C6C6 |
#B6B6B6 |
| Text – Standard | Default / Darkmode Text | $TEXT_BLACK / $TEXT_DARK, $FGCOLOR |
Standard-Fließtext; Titel, Legende, Notes, Pfeilbeschriftung, Stereotyp-Labels | #000000 |
#D7E9F4 |
| Text – auf Formen | Element-Labels | $BLACK |
Class-Header, Participant, Activity, State, Component, Package, Rectangle | #000000 |
#D7E9F4 |
| Text – Actor | Actor-Label | $TERTIARY_TINT / $TEXT_DARK_SECONDARY |
Use-Case-Actor-Beschriftung | #6D6D6D |
#AFC1C7 |
| Text – Tertiary | Tertiary Tint / Secondary | $TERTIARY_TINT / $TEXT_DARK_SECONDARY |
Bullets, Subheader-Nummerierung; Sequence Box-/Delay-/Group-Font | #6D6D6D |
#AFC1C7 |
| Text – Invers | White / Disabled | $TEXT_WHITE / $DS_DARK_DISABLED |
Text auf dunklem oder farbigem Hintergrund; Dark-Mode deaktivierter Text | #FFFFFF |
#84999F |
| Container | Systemgrenze | $ALICEBLUE ‡ |
Use-Case-System-rectangle, Package-Hintergrund |
#F0F8FF |
#3A3A3A |
| Container | Gruppe / Swimlane | $SUPERLIGHTGREY ‡ |
Sequence-Groups, Divider, Activity-Swimlane-Titel, Reference-Header | #F8F8F8 |
#2D2D2D |
| Container | Frame / Folder | $DS_CYAN, $DS_ORANGE |
Rahmen- und Textfarbe für frame bzw. folder (Semantik-Hervorhebung) |
#00A5E1 / #DB6A00 |
#00A5E1 / #DB6A00 |
| Diagramm – Hintergrund | Export / Canvas | $PUML_BGCOLOR, $DS_BASE_BACKGROUND / $DS_DARK_BACKGROUND |
Gerendeter Diagramm-Hintergrund; Sequence-Box/Group-Body; Surface Base | #FFFFFF |
#15202B |
| Diagramm – Metadaten | Titel | $FGCOLOR |
skinparam title · FontColor |
#000000 |
#D7E9F4 |
| Diagramm – Metadaten | Legende | $FGCOLOR, $DS_GREY |
Legenden-Text; Rahmen $DS_GREY, Hintergrund transparent |
#000000 / #7A7A7A |
#D7E9F4 / #7A7A7A |
| Diagramm – Metadaten | Notes | $FGCOLOR |
Note-Text (Hintergrund transparent) | #000000 |
#D7E9F4 |
| Semantik – Erfolg | Valid / Valid Dark | $DS_GREEN, $SUCCESS / $DS_DARK_GREEN |
Erfolg, positive Status, Bestätigungen | #6B9714 |
#B9D478 |
| Semantik – Warnung | Orange | $DS_ORANGE, $WARNING |
Warnmeldungen, Storage-Semantik, Akzent | #DB6A00 |
#DB6A00 |
| Semantik – Fehler | Invalid / Invalid Dark | $DS_RED, $DANGER / $DS_DARK_RED |
Fehler, negative Status, kritische Pfade | #C63328 |
#E85F63 |
| ‡ C4 – Context | Context-Ebene | $CONTEXT_BG |
<<context>> Hintergrund |
#FFFFFF |
#2A2A2A |
| ‡ C4 – Container | Container-Ebene | $CONTAINER_BG |
<<container>> Hintergrund |
#EEF8FE |
#353535 |
| ‡ C4 – Component | Component-Ebene | $COMPONENT_BG |
<<component>> Hintergrund (gleicher HEX wie Form-Füllung Light) |
#D7E9F4 |
#404040 |
| ‡ C4 – Module | Module-Ebene | $MODULE_BG |
<<module>> Hintergrund (gleicher HEX wie Text Tertiary Dark) |
#AFC1C7 |
#4A4A4A |
| ‡ C4 – Code | Code-Ebene | $CODE_BG |
<<code>> Hintergrund (gleicher HEX wie Text Disabled Dark) |
#84999F |
#555555 |
‡ Nicht im doubleSlash Living Style Guide (Web-CI) – PlantUML-spezifische Erweiterung.
Typografie (Schriftart/-größe, kein Farb-Token): siehe Abschnitt Typografie – u. a. $FONTNAME (Helvetica), Body 12 pt, Titel 28 pt, Notes 11 pt, Class-Header 15 pt bold.
Farbdefinitionen¶
Detailierte Beschreibungen zu den Farben aus der Übersicht.
Primary Cyan
Zentrale Markenfarbe der doubleSlash Corporate Identity – modusunabhängig.
Deep Ocean Blue
Kräftiges Ozeanblau für klickbare Elemente und Primary-Rahmen.
Bright Sky
Helles Himmelblau – Primary- und Clickable-Variante auf dunklem Hintergrund.
Blau-Tint
Helles Blau-Grau – häufigste Flächen- und Textfarbe in der Palette.
Dark Blau-Grau
Dunkle Blau-Grau-Fläche für Formen und Container auf dunklem Canvas.
Container Tint
Leicht bläuliche Fläche für C4-Container-Ebene.
Alice Blue
Sehr helles Blau für Systemgrenzen und Packages.
White
Reines Weiß – Canvas-Grundfläche und helle Container-Ebene.
Super Light Grey
Fast weiße Grautönung für externe Elemente und Gruppierungen.
Light Grey
Helles Neutralgrau für Akteure und zurückhaltende Rahmen.
Medium Light Grey
Mittleres Hellgrau – Akteur- und Rahmenvariante auf dunklem Canvas.
Medium Grey
Modusunabhängiges Mittelgrau für Verbindungen und neutrale Interfaces.
Tertiary Tint
Gedämpftes Grau für untergeordnete und ergänzende Beschriftungen.
Secondary Tint
Blau-graues Sekundärgrau für Text und C4-Module-Ebene.
Disabled Grey
Gedämpftes Blau-Grau für inaktive Zustände und C4-Code-Ebene.
Black
Maximaler Kontrast für Fließtext und Beschriftungen auf hellen Flächen.
Dark Canvas
Dunkelblaues Schwarz – Grundfläche für Dark-Mode-Diagramme.
Dark Surface
Dunkle Oberfläche für externe Elemente und Gruppierungen.
Dark Surface Alt
Alternative dunkle Fläche für Systemgrenzen und Packages.
C4 Context
Hintergrund der äußersten C4-Ebene auf dunklem Canvas.
C4 Container
Hintergrund der C4-Container-Ebene auf dunklem Canvas.
C4 Component
Hintergrund der C4-Component-Ebene auf dunklem Canvas.
C4 Module
Hintergrund der C4-Module-Ebene auf dunklem Canvas.
C4 Code
Hintergrund der innersten C4-Code-Ebene auf dunklem Canvas.
Valid Green
Semantisches Grün für Erfolgs- und Valid-Zustände.
Valid Green Light
Helle Valid-Variante mit gutem Kontrast auf dunklem Hintergrund.
Orange
Modusunabhängiges Warn- und Akzentorange der Corporate Identity.
Invalid Red
Semantisches Rot für Fehler- und Invalid-Zustände.
Invalid Red Light
Helle Invalid-Variante mit gutem Kontrast auf dunklem Hintergrund.
Farbnutzung¶
Deep Ocean Blue / Bright Sky
Primärfarbe für klickbare und interaktive Elemente – Deep Ocean Blue im Light Mode, Bright Sky im Dark Mode.
Primary / Markenblau
Rahmenfarbe für zentrale Formen – identischer HEX wie Clickable, eigene Token-Zuordnung für Form-Rahmen.
Blau-Tint
Standard-Füllfarbe für Diagramm-Formen – helles Blau-Tint im Light Mode, dunkles Blau-Grau im Dark Mode.
Interface
Interfaces nutzen Primary Cyan als Füll- und Rahmenfarbe – modusunabhängig, mit verstärktem Rahmen.
Extern / Fremdsystem
Füllfarbe für externe Systeme und Fremdakteure – PlantUML-spezifische Erweiterung außerhalb der Web-CI.
Actor
Neutrale Grautöne für Use-Case-Akteure – Hintergrund und Rahmen in einem Token-Paar.
Extern-Interface
Mittleres Grau für externe Interfaces – modusunabhängig, unterscheidet sich von internen Cyan-Interfaces.
Pfeile & Linien
Standardfarbe für Verbindungen und Pfeile – dezent und gut lesbar auf hellem und dunklem Hintergrund.
Rahmen dezent
Dezenter Rahmen für untergeordnete Container – weniger dominant als Primary-Rahmen.
Default / Darkmode Text
Primäre Textfarbe für Diagramm-Metadaten und Fließtext – Schwarz im Light Mode, helles Blau-Grau im Dark Mode.
Element-Labels
Beschriftung direkt auf Formen – hoher Kontrast zur Blau-Tint-Füllung.
Actor-Label
Sekundäre Textfarbe speziell für Actor-Labels – zurückhaltender als Element-Labels.
Tertiary Tint / Secondary
Tertiäre Textfarbe für untergeordnete und ergänzende Beschriftungen.
White / Disabled
Inverse Textfarbe für Kontrast auf farbigen Flächen – im Dark Mode auch für deaktivierte Zustände.
Systemgrenze
Hintergrund für Systemgrenzen und Packages – dezente Abgrenzung vom Diagramm-Hintergrund.
Gruppe / Swimlane
Container-Hintergrund für Gruppierungen und Swimlanes – identischer HEX wie Extern/Fremdsystem, andere Rolle.
Frame / Folder
Semantische Hervorhebung: Cyan für Frames, Orange für Folders – in beiden Modi identisch.
Export / Canvas
Canvas- und Export-Hintergrund – bestimmt die sichtbare Fläche des gerenderten Diagramms.
Titel
Diagrammtitel – nutzt die Standard-Vordergrundfarbe des aktiven Modus.
Legende
Legende kombiniert modusabhängigen Text mit modusunabhängigem Grau-Rahmen.
Notes
Textfarbe für Anmerkungen – Hintergrund bleibt transparent.
Valid / Valid Dark
Semantisches Grün für Erfolgs- und Valid-Zustände – kräftiger im Light, heller im Dark Mode.
Orange
Warn- und Akzentfarbe – modusunabhängig, auch für Folder-Semantik genutzt.
Invalid / Invalid Dark
Semantisches Rot für Fehler- und Invalid-Zustände – kräftiger im Light, heller im Dark Mode.
C4 – Context
C4-Context-Ebene – PlantUML-spezifische Erweiterung für System-Context-Diagramme.
C4 – Container
C4-Container-Ebene – leicht bläulicher Hintergrund im Light Mode.
C4 – Component
C4-Component-Ebene – im Light Mode identisch mit Blau-Tint-Formfüllung.
C4 – Module
C4-Module-Ebene – im Light Mode identisch mit Tertiary-Tint-Dark-Textfarbe.
C4 – Code
C4-Code-Ebene – im Light Mode identisch mit Disabled-Text-Dark-Farbe.
Typografie¶
Einheitliche Schrift sorgt für lesbare Diagramme in Präsentationen, MkDocs und Druck.
| Rolle | Verwendung | Wert |
|---|---|---|
| Standardschrift | Alle Diagrammtexte | Helvetica ($FONTNAME) |
| Body | Standard-Labels, Attribute | 12 pt |
| Titel | Diagrammtitel | 28 pt, normal (nicht bold) |
| Notes | Anmerkungen, Erläuterungen | 11 pt, linksbündig |
| Class-Header | Klassennamen, Typ-Header | 15 pt, bold |
| Pfeilbeschriftung | Kanten- und Pfeil-Labels | 11 pt (ArrowFontSize) — Globale Defaults |
| Swimlane-Titel | Activity-Swimlanes | 16 pt |
| Sequence-Divider | Trennlinien-Beschriftung | 14 pt |
Grundsätze:
- Bold nur in Headern (Titel, Class-Header) - Fließtext in Notes und Attributen bleibt normal.
- Deutsche Umlaute können direkt in Labels verwendet werden (UTF-8).
- Diagrammtyp-spezifische Abweichungen: jeweilige Diagrammtyp-Seite.
Abstände & Form¶
Globale Abstands- und Formwerte gelten diagrammübergreifend.
| Token / Parameter | Wert | Gilt für |
|---|---|---|
roundcorner |
16 | Eckenradius aller Elemente (Ausnahme: Gantt-Bundle → 6) |
BoxPadding |
32 | Innenabstand von Sequence-Boxen |
$PUML_ELEMENT_PADDING |
4 | Element-Padding (CSS-Pfad ab PlantUML 1.2026.3) |
$PUML_SEQUENCE_GAP_H |
32 | Horizontaler Abstand zwischen Sequence-Participants |
$PUML_SEQ_MARGIN_V |
4 | Vertikaler Participant-Rand |
$PUML_SEQ_INNER_V / $H |
16 | Inneres Participant-Padding |
ArrowThickness |
1.5 | Standard-Pfeilstärke |
shadowing |
false | Keine Schatten (CI: „Weniger ist mehr“) |
dpi |
100 | Export-Auflösung |
Modus-Schalter¶
Modus-Schalter steuern Palette, Hintergrund und Darstellungsvariante. Sie werden vor dem Theme-Include gesetzt - typischerweise über die fertigen Entry-Points:
!include .../doubleslash/light.puml ' Light Mode (Default)
!include .../doubleslash/dark.puml ' Dark Mode
| Schalter | Standard (Light) | Standard (Dark) | Wirkung |
|---|---|---|---|
$PUML_MODE |
"light" |
"dark" |
Schaltet die gesamte Farbpalette |
$PUML_BGCOLOR |
#FFFFFF |
#15202B |
Export-Hintergrund des gerenderten Bildes |
$PUML_OUTLINE |
"false" |
"false" |
"true" → Outline-Modus: Füllfarben werden transparent, Text nutzt helle Varianten (Druck/Präsentation) |
$PUML_GRADIENT |
20 |
15 |
Stärke für abgeleitete Farbtöne ($PRIMARY_DARK, $SUCCESS_LIGHT, …) |
Light / Dark wählen¶
| Ziel | Include |
|---|---|
| Helle Präsentationen, Druck, helle Docs | doubleslash/light.puml |
| Dunkle Präsentationen, Dark-Mode-Docs | doubleslash/dark.puml |
| Neutral (Light Default) | doubleslash/doubleslash-gen2.puml |
$PUML_MODE nach dem Include zu ändern wirkt nicht - abgeleitete Tokens sind bereits gesetzt.
Outline-Modus¶
Bei $PUML_OUTLINE = "true" (vor dem Include setzen) werden semantische Füllfarben ($INFO_BG, $DANGER_BG, …) auf den Export-Hintergrund gesetzt; Textfarben wechseln zu den *_LIGHT-Varianten. Geeignet für schwarz-weiß-Druck und reduzierte Folien.
Weiterführend¶
| Thema | Seite |
|---|---|
| Do/Don't für Autoren (keine Hex-Werte, Theme-Include) | Autoren-Regeln |
| Globale skinparam, Padding-Gate, Titel | Globale Defaults |
| C4-Stereotypen im Detail | System & C4 |
| Include-Patterns Light/Dark/System | Style Guide - Templates |
| Bekannte Abweichungen | Anti-Patterns |