Ein Neues Gesicht

Schon vor zwei Jahren habe ich mein altes, mit WordPress angetriebenes Blog zu Hugo migriert. Ich war grundsätzlich zufrieden mit der Umstellung, das Blog dümpelte dann allerdings nur so ein bisschen vor sich hin. Über ein paar unschöne Stellen konnte man drüberweg sehen. Allein es fehlte die Muße, sich da mal wieder ran zu setzen.

Das Theme

Erst jetzt beim Aufschreiben fällt mir auf, warum es eigentlich so lange gedauert hat, mal wieder etwas am Blog zu arbeiten: das Theme. Ich selbst wollte aus Zeitgründen kein Theme von Grund auf entwerfen. Die bei Hugo direkt angebotenen Themes hatten immer irgendwo etwas, was mir nicht gefallen hat. Über zwei Jahre habe ich immer mal wieder in den Hugo-Themes gestöbert, aber leider kein passendes gefunden. Und einen Blog-Kollegen, der die Umstellung schneller hinbekommen hat, wollte ich nicht kopieren. Grüße an Chris!

Beim letzten Stöbern ist mir dann Clarity über den Weg gelaufen und je mehr ich in der Demo herumgeklickt und die Doku gelesen hatte wurde immer klarer: das wird das neue Theme.

Ich weiß nicht, warum ich das Theme vorher nicht wirklich wahrgenommen habe. Das Theme gibt es schon seit ca. sechs Jahren. Vielleicht war ich zu oberflächlich beim Durchschauen der Screenshots.

Erste Anpassungen

Hugo-Themes habe ich bisher als git-Submodule eingebunden, das sollte auch mit dem neuen Theme funktionieren. Anschließend mussten ein paar Partials und ein neuer Archetype für Posts aus dem Theme übernommen werden. Die Konfiguration wanderte von /hugo.toml nach /config/_default/.

Damit lief das Blog lokal auch schon wieder. Die verwendete Schriftart anzupassen, die für meinen Geschmack etwas sehr zusammengedrückt zum flüssigen Lesen ist, gestaltete sich anfänglich etwas schwierig, da ich mit SASS noch nichts zu tun hatte. Schlussendlich habe ich dann doch die richtige Stelle gefunden und die Standardschriftart in config/_default/_override.sass überschrieben.

In config/_default/custom.css habe ich weitere benötigte Formatierungen aufgenommen.

Größere Baustellen

Wirkliche Baustellen waren die selbst erstellten Sachen. Vor allem das stark nach einer Vorlage angepasste Cookie-Consent-System und die darauf aufbauende Einbindung verschiedener Skripte, insbesondere des Skripts zur Anzeige der Kommentare.

Cookie-Consent

Da das alte System mehr Frickelei als sauberer Code war und ich keine Lust auf etwas hatte was ich unfreiwilligerweise tun müsse, habe ich die Aufgabe delegiert, und zwar an Claude. Der hatte nach kurzer Zeit ein System genau nach meinen Vorgaben fertig, inklusive eines durch die Verwendung der gleichen CSS-Variablen an das Theme angepassten Aussehens. Hatte ich schon erwähnt, das Clarity hell/dunkel kann? Der Cookie-Consent kann das nun automatisch auch.

Einbindung des Kommentarsystems

Die Einbindung der Kommentare war im alten System tief im Cookie-Consent eingewoben, das neue System erlaubt nun eine strukturierte Einbindung der Skripte je nach gewähltem Cookie-Consent. Es brauchte nur das Partial comments.html von Clarity übernommen werden und durch das für Comentario erforderliche Markup ersetzt werden. Praktisch, dass in Clarity mit coments: ... im Front-Mater bereits gesteuert werden kann, ob das Partials für Kommentare überhaupt in die jeweilige Seite eingebunden wird. Datenschutzerklärung und das Impressum z.B. brauchen keine Kommentarfunktion.

Bildergalerien

Das war mit Abstand die größte Baustelle. Ich erinnerte mich, dass das schon im vorherigen Theme die komplizierteste Stelle war. Glücklicherweise habe ich hier auch schnell Ersatz gefunden, welcher auf Anhieb gut funktioniert hat. Warum hatte ich das nicht schon viel früher gefunden? Es brauchten jetzt nur noch alle Artikel angepasst werden, welche den Gallery-Shortcode verwendeten und die Bilder der jeweiligen Galerie in ein eigenes Verzeichnis des PageBundles umgezogen werden. Auch das war schnell erledigt.

Stolpersteine

Das Blog war lokal fertig, der Commit-Hook um Remote-Repository angepasst. Alles sollte funktionieren, bis zum ersten Push. Und dann kam Debian. Hugo war für das Theme und die Bildergalerie auf dem Server einfach zu alt. Glücklicherweise stellt Hugo mit jedem Release auch ein passendes Deb-Paket bereit.

Und als das erledigt war und die kleine VM beim Hetzner reichlich 15 Sekunden an etwa 1000 Seiten herumgerechnet hatte, war das neue Blog fertig!

Was noch nicht funktioniert

Clarify bringt eine eigene Suche mit, das bisherige PageFind kann damit entfallen und damit auch der zusätzliche Schritt im Commit-Hook. Leider ist die Suche im THeme noch als experimentell gekennzeichnet. Bei mir funktioniert sie bisher noch nicht.

Die Anzeige der Titelbilder im Theme gefällt mir bisher noch nicht. Das ist aber nur ein optisches Problem. Die Bilder sind alle noch da und zugeordnet, allein ihre Anzeige ist bisher noch ausgeschaltet. Man brauch ja auch noch ein bisschen Arbeit für morgen.