6.1 – Ausblenden und tauschen

Jede Instanz hört auf ein Frontmatter-Feld. Wie es heißt, sagt frontmatterKey; ohne Angabe ist es layoutBox.

Die vier Formen

Ausblenden:

---
layoutBox: false
---

Ein anderes Schnipsel:

---
layoutBox: impressum.html
---

Der Name gilt relativ zu dir, genau wie in der Konfiguration.

Mehreres auf einmal:

---
layoutBox:
  file: impressum.html
  title: Zu dieser Seite
  collapsed: true
---

Nur für diese Seite ein anderes Markup:

---
layoutBox:
  html: "<p>Diese Seite ist ein Entwurf.</p>"
---

Als Objekt geschrieben sind hidden, file, html, title, collapsible und collapsed erlaubt. dir und frontmatterKey nicht — das eine ist ein Installationspfad, das andere der Name, unter dem die Seite gerade spricht.

Die Rangfolge

Von stark nach schwach:

1. Frontmatter der Seite
2. byLang für die Sprache der Seite (Kapitel 7)
3. Grundoptionen aus der Konfiguration

Jede Ebene überschreibt nur, was sie selbst nennt. Ein Frontmatter mit title: lässt file: aus der Konfiguration unangetastet.

html gegen file folgt der Rangfolge nicht

Die Quelle wird nicht je Ebene entschieden, sondern einmal für alle: Gibt es irgendwo ein html — im Frontmatter, unter byLang oder in den Grundoptionen —, wird es genommen, und file gar nicht erst angesehen. Ein layoutBox: impressum.html im Frontmatter tut also nichts, wenn die Konfiguration html: nutzt, und ein byLang.en.file nichts, wenn die Grundoptionen html: haben. Ohne Meldung. Gemessen; und genau darauf beruht der Trick mit der leeren Datei in 6.2.

Ein Beispiel, das oft gebraucht wird

Eine Site hat einen Spendenkasten nach dem Inhalt — nur auf der Impressumsseite wirkt er unpassend:

---
title: Impressum
layoutBoxSpende: false
---