Frontmatter
Termine konfigurieren
Daten sind in Hugo wichtig, und wie Hugo den Sites spezielle Daten zuordnet, kann man konfigurieren. Dies geschieht, indem der config.toml
einen der Eintrag [frontmatter]
hinzugefügt wird.
Die Standardkonfiguration ist:
[frontmatter]
date = ["date", "publishDate", "lastmod"]
lastmod = [":git", "lastmod", "date", "publishDate"]
publishDate = ["publishDate", "date"]
expiryDate = ["expiryDate"] #(Frontmaterie)
Wenn beispielsweise bei einigen Sites kein dem Standard entsprechender Datumsparameter gibt, kann die Einstellung für das Datum übersteuert werden:
[frontmatter]
date = ["myDate", ":default"]
Die Einstellung :default
ist eine Verknüpfung mit den Standardeinstellungen. Das oben genannte wird .date
auf den Datumswert in myDate
gesetzt, sofern es vorhanden ist, andernfalls wird in .date
gesucht, bzw. publishDate
, lastmod
und das erste gültige Datum ausgewählt.
Photo by Benedikt Geyer on Unsplash
In der Liste rechts sind Werte, die mit ":"
beginnen, Datumshandler mit einer speziellen Bedeutung (siehe unten). Die anderen sind nur Namen von Datumsparametern (Groß-/Kleinschreibung spielt keine Rolle) in Ihrer frontmatter-Konfiguration. Zu beachten ist auch, dass Hugo einige eingebaute Aliase zu den oben genannten hat:
lastmod
=>modified
,publishDate
=>pubdate
,published
undexpiryDate =>
unpublishdate`.
Damit wird beispielsweise die Verwendung von pubDate
als Datum im Vordergrund standardmäßig .PublishDate
zugewiesen.
Die speziellen Datumshandler sind:
:fileModTime
Liefert das Datum aus dem letzten Änderungszeitstempel der Inhaltsdatei.
Ein Beispiel:
[frontmatter]
lastmod = ["lastmod", ":fileModTime", ":default"]
Das oben Gesagte versucht zuerst, den Wert für .lastmod
zu extrahieren, beginnend mit dem lastmod
frontmatter Parameter, dann den Änderungszeitstempel der Inhaltsdatei. Das letzte, :default
sollte hier nicht benötigt werden, aber Hugo wird endlich nach einem gültigen Datum in : git
, date
und dann publishDate
suchen.
:Dateiname
Holt das Datum aus dem Dateinamen der Inhaltsdatei. Beispielsweise extrahiert 2018-02-22-mypage.md
das Datum 2018-02-22. Wenn slug nicht gesetzt ist, wird mypage als Wert für .Slug verwendet.
Ein Beispiel:
[frontmatter]
date = [":filename", ":default"]
Das oben genannte wird zuerst versuchen, den Wert für .date
aus dem Dateinamen zu extrahieren, dann wird es vor den Parametern date
, publishDate
und lasttmod
nachschauen.
:git
Dies ist das Git-Autorendatum für die letzte Revision dieser Inhaltsdatei. Dies wird nur gesetzt, wenn --enableGitInfo
gesetzt ist oder enableGitInfo = true
in der Site-Konfiguration gesetzt ist.