Auf dieser Seite
Konfiguration
Einstellungen liegen an drei Orten, von der ganzen Website bis zur einzelnen Seite:
clay.yamlReferenz aller Einstellungen der clay.yaml, mit Standardwerten und einem vollständigen Beispiel.Front MatterReferenz aller Front-Matter-Felder von Seiten, Ordnern (index.md) und der Startseite, mit Standardwerten und Beispielen.UmgebungsvariablenEinstellungen der clay.yaml beim Build überschreiben, etwa in der CI oder für eine Staging-Seite.
#Die drei Orte
Die Website: Titel, Adressen, Links in der Navigationsleiste, Versionen und Sprachen.
title: "Mein Projekt"
baseURL: "/mein-projekt/"
siteURL: "https://meine-org.github.io"
languages: ["en", "de"]Eine Seite oder ein Ordner: Titel, Icon, Beschreibung, Reihenfolge und Aufbau.
---
title: Einrichtung
icon: fa-solid fa-wrench
order: 2
---Ein Build: eine Testseite, ein Fork oder ein Geheimnis, das nicht ins Repository gehört.
#Welcher Wert gewinnt
Ein weiter rechts gesetzter Wert ersetzt den davor. Front Matter gehört zu einer einzelnen Seite und kommt den anderen nie in die Quere.
#Das Wichtigste
- Alles hat einen Standardwert. Eine
clay.yamlnur mittitleund schlichte Markdown-Dateien ergeben eine funktionierende Website. - Umgebungsvariablen gewinnen. Sie überschreiben die
clay.yamlfür einen Build, ohne die Datei zu ändern. - Tippfehler werden gemeldet. Ein unbekannter Schlüssel in der
clay.yamlist bei jedem Build eine Warnung, siehe Build-Prüfungen. - YAML musst du nicht von Hand bearbeiten.
clay editändert Einstellungen und Front Matter und behält deine Kommentare und Formatierung. Siehe clay edit.