Seminar Gaphor: Diagrammgestaltung, CSS und Publikation

Gute Modelle verlieren ihren Nutzen, wenn Diagramme uneinheitlich, überladen oder nur mit manueller Nacharbeit präsentierbar sind. Dieses Seminar entwickelt deshalb einen reproduzierbaren Gestaltungs- und Publikationsprozess. Fachliche Bedeutung, visuelle Hierarchie, CSS-Regeln und Exportqualität werden so aufeinander abgestimmt, dass Diagramme im Modell, in Reviews und in Dokumentationen dieselbe Aussage behalten.

Inhaltsübersicht

• Zielsetzung
• Fachliche Schwerpunkte
• Praxisprojekt
• Qualitätskriterien
• Zielgruppe und Voraussetzungen

Zielsetzung

• Lesbarkeit und semantische Klarheit von Diagrammen systematisch bewerten.
• CSS-Regeln in Gaphor zielgerichtet auf Modellelemente und Darstellungen anwenden.
• Wiederverwendbare Gestaltungsrichtlinien für mehrere Modellierungssprachen aufbauen.
• Diagramme kontrolliert für Präsentationen, Reviews und Dokumentationen veröffentlichen.

Fachliche Schwerpunkte

1. Informationsdichte und visuelle Hierarchie steuern

Vor der Formatierung wird festgelegt, welche Aussage ein Diagramm transportieren soll und welche Elemente dafür notwendig sind.

1. Zielgruppe, Aussage und gewünschte Entscheidung für jedes Diagramm formulieren.
2. Überflüssige Elemente, redundante Beschriftungen und nicht relevante Beziehungen entfernen.
3. Gruppierung, Ausrichtung, Abstände und Leserichtung als zusammenhängendes Layoutsystem planen.
4. Semantisch wichtige Elemente durch konsistente, sparsame Hervorhebungen priorisieren.

2. CSS-Grundlagen in Gaphor einsetzen

Die Gestaltung wird von manuellen Einzeländerungen auf nachvollziehbare Regeln umgestellt.

1. Selektoren, Eigenschaften und Vererbungsprinzipien anhand kleiner Beispiele untersuchen.
2. Regeln für Elementtypen, Zustände und ausgewählte Darstellungen formulieren.
3. Konflikte zwischen allgemeinen und spezifischen Regeln erkennen und auflösen.
4. Änderungen kontrolliert prüfen, ohne die fachliche Bedeutung eines Elements zu verfälschen.

3. Gestaltungsrichtlinien als wiederverwendbares System entwickeln

Ein Styleguide verbindet Modellierungsregeln, CSS und Diagrammkonventionen.

1. Typografie, Linienführung, Abstände und Beschriftungen für zentrale Diagrammarten standardisieren.
2. Regeln für UML-, SysML-, RAAML- und C4-Sichten voneinander abgrenzen.
3. Ausnahmen dokumentieren und auf fachlich begründete Fälle beschränken.
4. Beispieldiagramme als verbindliche Orientierung für neue Modellbereiche aufbauen.

4. Große Diagramme lesbar strukturieren

Komplexe Sichten werden aufgeteilt, ohne wichtige Zusammenhänge zu verlieren.

1. Thematische Teilansichten und Überblickssichten aus demselben Modell ableiten.
2. Wiederkehrende Elemente konsistent platzieren und benennen.
3. Kantenkreuzungen, lange Beziehungswege und visuelle Sackgassen reduzieren.
4. Detailansichten mit klaren Einstiegspunkten und nachvollziehbaren Navigationsbezügen versehen.

5. Publikationsprozess und Qualitätskontrolle etablieren

Der Export wird als kontrollierter Arbeitsschritt mit definierten Prüfungen organisiert.

1. Ausgabezweck, Format, Auflösung und Seitenverhältnis vor dem Export festlegen.
2. Beschriftungen, Legenden und Randbereiche für die Zielmedien kontrollieren.
3. Dateinamen, Ablage und Versionskennzeichnung standardisieren.
4. Eine Freigabeprüfung für fachliche Aktualität, Darstellungsqualität und Nachvollziehbarkeit durchführen.

Praxisprojekt

Ein heterogener Modellsatz mit uneinheitlichen Farben, Schriften, Abständen und Beschriftungen wird schrittweise bereinigt. Daraus entstehen ein kompakter Styleguide, wiederverwendbare CSS-Regeln und mehrere publizierbare Diagramme. Die abschließende Prüfung vergleicht Bildschirmdarstellung, Präsentationsansicht und dokumentationsfähigen Export.

Qualitätskriterien

• Gestaltung unterstützt die Semantik und ersetzt keine fehlende Modelllogik.
• Regeln sind wiederverwendbar, nachvollziehbar dokumentiert und möglichst frei von Sonderfällen.
• Diagramme bleiben auch ohne Farbinformation verständlich.
• Exportierte Darstellungen besitzen ausreichende Lesbarkeit, eindeutige Benennung und einen erkennbaren Versionsstand.

Zielgruppe und Voraussetzungen

Zielgruppe: Modellierungsverantwortung, Architektur, Systementwicklung, technische Redaktion, Qualitätsmanagement und interne Methodenstellen.

Voraussetzungen: Sichere Grundbedienung von Gaphor und Erfahrung mit mindestens einer unterstützten Modellierungssprache. CSS-Grundkenntnisse sind hilfreich, werden jedoch nicht vorausgesetzt.