Lara-MD – Bausteine

Bausteine sind wiederverwendbare Inhalte, die Sie einmal pflegen und überall einsetzen. Statt denselben Hinweis, dieselbe Adresse oder dieselbe Abbildung in viele Dokumente zu kopieren, legen Sie sie als Baustein an und binden ihn ein, wo Sie ihn brauchen. Ändern Sie den Baustein, ändert sich jede Verwendung mit – ohne Suchen und Ersetzen.

graph LR B[Baustein Adresse] --> D1[Dokument Impressum] B --> D2[Dokument Kontakt] B --> D3[Dokument Angebot]

So funktioniert ein Baustein

Ein Baustein hat einen Namen und einen Inhalt. Im Dokument binden Sie ihn ein, indem Sie den Namen in doppelte geschweifte Klammern setzen:

Erreichbar sind wir unter {{kontakt.adresse}}.

Beim Zusammenstellen – also beim Anzeigen in der Vorschau oder beim Veröffentlichen – ersetzt Lara-MD den Platzhalter durch den hinterlegten Inhalt. Den Namen müssen Sie nicht auswendig kennen: Die Schaltfläche Kürzel in der Werkzeugleiste des Editors fügt einen Baustein an der Cursorposition ein.

Ist ein Baustein einmal nicht auffindbar (z. B. vertippter Name), bleibt an seiner Stelle ein sichtbarer Hinweis stehen – der übrige Text wird dadurch nicht beschädigt.

Arten von Bausteinen

Je nachdem, woraus sich der Inhalt speist, gibt es vier Arten:

Textbaustein – ein fester Inhalt, den Sie direkt hinterlegen: ein Hinweis, eine Adresse, ein rechtlicher Standardtext. Textbausteine können auch gestaltete Abschnitte enthalten, etwa einen mehrspaltigen Block.
Dokument-Baustein – bindet den Inhalt eines anderen Dokuments ein. So führen Sie Inhalte an einer Stelle zusammen, ohne sie doppelt zu pflegen.
Datenquellen-Baustein – erzeugt seinen Inhalt aus einer Datenbank-Abfrage, typischerweise für Aufzählungen und Verzeichnisse (etwa eine Liste von Einträgen).
Abbildungs- und Download-Baustein – ein Bild oder eine Datei zum Herunterladen, als gestalteter Block. Details dazu unter Bilder, Downloads und Diagramme.

Bausteine verwalten

Alle Bausteine pflegen Sie in einem eigenen Bereich – erreichbar über den Punkt Kürzel in der Seitenleiste. Dort legen Sie neue Bausteine an, bearbeiten bestehende und finden sich auch bei vielen Einträgen zurecht: über ein Suchfeld, einen Typ-Filter und sortierbare Spalten.

Ein praktischer Hinweis zur Benennung: Stellen Sie dem Namen ein Kürzel für das Projekt oder den Themenbereich voran, getrennt durch einen Punkt – etwa kontakt.adresse oder recht.widerruf. So bleibt auch bei vielen Bausteinen erkennbar, wozu ein Baustein gehört. Projektübergreifend genutzte Bausteine sammeln Sie sinnvoll unter einem gemeinsamen Präfix.

Der Name eines Bausteins ist unveränderlich, weil Dokumente ihn über genau diesen Namen einbinden. Möchten Sie umbenennen, legen Sie den Baustein unter neuem Namen an und stellen die Dokumente darauf um.

Bausteine verschachteln

Ein Baustein darf andere Bausteine enthalten. So setzen Sie aus kleinen Teilen größere zusammen – etwa einen Layout-Baustein, der mehrere Karten-Bausteine nebeneinander anordnet. Beim Zusammenstellen werden auch die inneren Bausteine aufgelöst; ein Schutz gegen versehentliche Endlosschleifen sorgt dafür, dass sich ein Baustein nicht selbst enthalten kann.

Wenn die Schreibweise sichtbar bleiben soll

Manchmal möchten Sie die Baustein-Schreibweise selbst zeigen, statt sie auflösen zu lassen – zum Beispiel in einer Anleitung wie dieser. Stellen Sie dann ein @ voran: {{name}} erscheint als Text {{name}} und wird nicht ersetzt.