Deutsch
Über dieses Handbuch

Dieses Handbuch gehört zur Vorlage Example für QuartzControl. Es erklärt die Vorlage und führt zugleich alles vor, was sie kann.

Der Text hier kommt aus einer Markdown-Datei, nicht aus der Konfiguration.

Wie eine Excalidraw-Datei aufgebaut ist

Das Obsidian-Format: .excalidraw.md

Eine gewöhnliche Markdown-Datei mit vier Teilen:

---
excalidraw-plugin: parsed
tags: [excalidraw]
---
 
⚠ Hinweis für Leser ohne Plugin
 
# Excalidraw Data
 
## Text Elements
Der Text jedes Textelements, mit Blockkennung ^abc123
 
## Drawing
```json
{ "type": "excalidraw", "version": 2, "elements": [...] }
```

Die Textelemente stehen doppelt: einmal lesbar unter ## Text Elements, einmal im JSON. So findet Obsidians Suche den Text in einer Zeichnung.

Das JSON kann auch komprimiert vorliegen (compressed-json, LZ-String) — Obsidian stellt das in den Plugin-Einstellungen ein. Beides wird von Quartz gelesen; unkomprimiert ist besser versionierbar, weil git die Änderungen zeigen kann.

Der zweite Weg: .excalidraw

Reines JSON ohne Markdown-Hülle. Das Quartz-Plugin liest es genauso. Wer eine Zeichnung programmatisch erzeugt, hat es damit einfacher.

Wie die Zeichnung hier entstanden ist

Nicht von Hand: Ein Skript baut sie aus einer kleinen Spezifikation, die nur Inhalt beschreibt — Knoten, Gruppen, Kanten, Farben. Layout, Geometrie und die internen Kennungen berechnet das Skript.

{
  "title": "Aufbau des editorial-Frames",
  "kind": "structure",
  "groups": [{ "id": "links", "label": "Linke Spalte", "color": "teal" }],
  "nodes": [{ "id": "explorer", "label": "Explorer", "color": "teal", "group": "links" }],
  "edges": [{ "from": "frame", "to": "explorer" }]
}

Die Spezifikation liegt neben der Zeichnung unter assets/Excalidraw/. Wer die Zeichnung ändern will, ändert die Spezifikation und baut neu — oder öffnet sie in Obsidian und zeichnet weiter.

Weiterlesen

Diese Seite gehört zu Example — der Beispielvorlage für QuartzControl. Ein Überblick über alle Bereiche steht auf der Startseite.

Auf einem schmalen Bildschirm ist die Navigation oben eingeklappt.