quartz-layout-box rendert einen HTML- oder Markdown-Schnipsel an jeder Stelle des Seitenlayouts:
Kopfbereich, Seitenleisten, vor oder nach dem Inhalt, Fußzeile. Diese Vorlage nutzt es siebenmal,
jedes Mal für etwas anderes — zweimal davon, ohne dass ein Kasten dabei herauskäme.
Was das Plugin kann
| Möglichkeit | Option |
|---|---|
| Inhalt aus einer Datei | file: |
| Inhalt aus der Konfiguration | html: |
| Markdown statt HTML | Datei auf .md enden lassen |
| Überschrift darüber | title: |
| Aufklappbar | collapsible: und collapsed: |
| Eigene CSS-Klasse | className: |
| Platzhalter ersetzen | placeholders: |
| Je Seite steuerbar | frontmatterKey: |
| Je Sprache anders | byLang: |
| Bild je Farbschema | Klassen img-light / img-dark |
Platzhalter
{{title}}, {{slug}}, {{root}}, {{siteTitle}}, {{baseUrl}}, {{locale}}, {{lang}} und
jedes Frontmatter-Feld über {{frontmatter.name}}. {{root}} ist der relative Weg zur Startseite —
damit funktioniert ein Link auch, wenn die Seite in einem Unterpfad liegt.
{{locale}} nennt die Sprache der Seite (aus dem Frontmatter-Feld lang) und fällt nur auf
configuration.locale zurück, wenn die Seite keine hat. {{lang}} ist davon der vordere Teil:
en statt en-US.
Die Gestaltung
Das Plugin liefert bewusst farblose Stile mit: Breite, Bildumschaltung, ein gestrichelter Platzhalter für fehlende Dateien. Das ist die richtige Entscheidung für ein Komponenten-Plugin — es überlässt das Aussehen der Website.
Diese Vorlage gestaltet jede Klasse: .layout-box, .layout-box-title, .layout-box-content,
.layout-box-missing, dazu sieben eigene Varianten.
Weiter: Die Instanzen · Je Seite steuern
Die Seiten
- Die Instanzen — Dasselbe Plugin, siebenmal, für jeweils etwas anderes.