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.

front

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 und expiryDate => 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.