Ein Rendering erstellen

Eine Seitenvorlage für einen Typ schreiben — und sie beim Schreiben an einem echten Element prüfen.

Ein Rendering ist die Seitenvorlage für einen Typ. Jedes Element dieses Typs wird darüber dargestellt.

Anlegen

Klicken Sie im Modellnavigator auf + und wählen Sie Neues Rendering.
Wählen Sie den Zieltyp — den Knoten- oder Beziehungstyp, um den es auf diesen Seiten geht.
Klicken Sie auf Erstellen. Das Rendering erscheint im Abschnitt Renderings, und seine Eigenschaften öffnen sich.

Geben Sie ihm einen Namen, den Sie später wiedererkennen — Service-Seite, Vorstandsübersicht. Sie können mehrere Renderings für denselben Typ anlegen (ein ausführliches für die Website, ein knappes für einen Management-Bericht); jede Publikation wählt aus, welches sie verwendet.

Das Dokument schreiben

Das Feld Dokument ist die Vorlage. Es ist gewöhnliches Markdown mit zwei Ergänzungen:

{{ subject.label }} — setzt einen Wert des Elements ein, um das es auf der Seite geht
:::view{ ... } — ein Block, der verwandte Elemente einbindet

Eine kurze, aber schon nützliche Seite:

# {{ subject.label }}

:::prose{ source=subject.description }

:::properties

Das ergibt einen Titel, die als Markdown gerenderte Beschreibung und eine Tabelle der Eigenschaften — automatisch für jedes Element des Typs.

Rendering-Dokumente schreiben beschreibt den vollständigen Sprachumfang.

Vorschau beim Schreiben

Unter dem Dokument zeigt Vorschau die Seite, gerendert für ein echtes Element; mit Vorschau-Subjekt wählen Sie, für welches.

Nutzen Sie sie ständig. Der häufigste Fehler ist ein Block, der still nichts findet — die Seite wird dann einfach ohne diesen Inhalt gerendert, und die Vorlage verrät es Ihnen nicht. Die Vorschau schon.

Umbenennen ist unkritisch

Eine Publikation merkt sich das ausgewählte Rendering auch dann, wenn Sie es umbenennen. Warnt das Panel, dass eine Auswahl nicht aufgelöst werden konnte, wurde das Rendering gelöscht oder auf einen anderen Typ umgestellt — wählen Sie dann erneut eines aus.