Diese Seiten befassen sich mit technischen Fragen und Antworten, Problemen und Lösungen - und das Aufsetzen dieser Seiten fällt in jedem Fall unter eine dieser Kategorie. Aber sowas von.

Gegeben ist: Diese Seiten müssen statisch von einem Server ausgeliefert werden, also als fertige HTML-Seiten vorliegen. Die Vorteile: Keine Login- oder Admin-Seiten auf dem Server, in die sich Übelmenschen hineinhacken könnten. Und die Seiten werden erheblich schneller ausgeliefert - weil sie (s.o.) schon fertig vorliegen. Der Aufwand mit einem CMS wie WordPress erscheint mir angesichts des Umfangs der Seiten als overkill. Und weil ich schon mal mein Weblog mit der Exotenmaschine Hugo betrieben habe, sollte es diesmal wieder so sein. Das Problem: Meine Erfahrungen mit Hugo liegen geschätzt sechs Jahre zurück. Ein Fall für das Langzeitgedächtnis?

Nun hat sich Hugo in den letzten Jahren gewaltig weiterentwickelt, meine Kenntnisse damit und mit der Programmiersprache Go dagegen nicht. Und da Dokumentation manchmal Glückssache ist, beschäftige ich mich derzeit viel mit TOML und YAML (das eine ist die Standard-Markup-Sprache von Hugo, das andere die des hier verwendeten Themes, und beide sind nur begrenzt, sprich: nicht miteinander kompatibel). Gut, dass es im Netz auch dafür eine Lösung gibt. Das Menu dagegen steht, jetzt muss ich es nur noch auf die Startseite bekommen. Piece of cake.

Wo es dann wieder Schwierigkeiten gab: Gleich nach dem Aufsetzen erschienen die Posts (zu der Zeit nur einer) auf der Startseite. Dann packte ich die statische Seite mit Impressum und Datenschutz und Kram dazu, dann erschien nur die auf der Startseite. Und dann blieb die Startseite plötzlich leer…

Die Antwort: Zu jedem Inhalt, hier in Markdown geschrieben, gehört ein Absatz namens front matter, geschrieben in TOML oder YAML (siehe oben), und der enthält einige Pflicht- und einige freiwillige Angaben. Und in dem Fall war ich mit den freiwilligen Angaben zu freiwilliggiebig, und das hat den armen Hugo durcheinandergebracht. Merke: Packe nie was in die front matter, was Du nicht bei anderen schon gesehen hast.

Gut, dass es da draußen im Netz mitfühlende Menschen gibt:

Screenshot eines Mastodon-Posts: “I feel you. Hugo ist wie Schach oder Golf, das Prinzip ist in einer halben Stunde erklärt, und der Rest dauert 30 Jahre…”

Und außerdem ist es vizeheiß (viel zu heiß).