4.1 – Alle Platzhalter

Platzhalter stehen in doppelten geschweiften Klammern und werden auf jeder Seite neu ersetzt. Leerzeichen innerhalb der Klammern sind erlaubt: {{ title }} ist dasselbe wie {{title}}.

Platzhalter	Wert
{{title}}	Titel der Seite aus dem Frontmatter
{{slug}}	Pfad der Seite, etwa 3-platzierung/02-die-reihenfolge
{{root}}	relativer Weg zur Wurzel der Site — . auf der Startseite, ../.. zwei Ebenen tiefer
{{siteTitle}}	configuration.pageTitle aus der Quartz-Konfiguration
{{baseUrl}}	configuration.baseUrl, darf leer sein
{{locale}}	Sprache der Seite: Frontmatter-Feld lang, sonst configuration.locale — etwa de-DE
{{lang}}	nur der vordere Teil davon: de
{{frontmatter.feld}}	jedes Frontmatter-Feld der Seite

Werte werden maskiert

Ein & im Seitentitel wird zu &, spitze Klammern werden unschädlich. Ein Platzhalter kann also kein Markup einschleusen — auch dann nicht, wenn jemand <script> in einen Titel schreibt.

Unbekannte Namen bleiben stehen

{{gibtsnicht}} wird nicht zu einer leeren Stelle, sondern bleibt sichtbar im Text. Das ist Absicht: Ein Tippfehler fällt so beim ersten Ansehen auf, statt still eine Lücke zu hinterlassen.

Wer geschweifte Klammern als Text braucht, schaltet die Ersetzung für diese Box ab:

options:
  placeholders: false

Frontmatter-Felder

{{frontmatter.<feld>}} liest jedes Feld der Seite. Der Kapitelname oben im Kopf dieser Website ist genau das:

options:
  html: '<span data-section="{{frontmatter.section}}"></span>'

Was im Feld steht	Was eingesetzt wird
Text oder Zahl	der Wert
eine Liste	mit Komma verbunden: a, b, c
ein Objekt	nichts — der Platzhalter bleibt stehen
das Feld fehlt	nichts — der Platzhalter bleibt stehen

Platzhalter gehen auch im Titel

title: "Über {{siteTitle}}" funktioniert. Nur maskiert das Plugin dort nicht selbst — die Überschrift ist ein Textknoten, den Preact ohnehin maskiert.