Troubleshooting: Hugo Extended Setup

Projektbeschreibung:
Beheben der Konfigurationsprobleme mit dem Theme “Ananke” im Framework Hugo im Codespace von GitHub

Die Herausforderung

Die Standard-Installation von Hugo im Codespace war veraltet. Das Theme “Ananke” benötigt jedoch die Extended-Version, um CSS-Dateien zu verarbeiten. Ein Update der integriereten Hugo-Version mit get-apt liefert keine zufriedenstellenden Ergebnisse.

Meine Herangehensweise

1. Analyse:

  • Identifikation der benötigten Version (0.146.0 Extended).
  • Der Fehler äußerte sich durch folgenden Abbruch beim Start des Servers: Error: failed to transform "ananke/css/main.css" (text/x-scss): this feature is not available in your current Hugo version
  • Mit dem Befehl hugo version wurde festgestellt, dass eine Standard-Version installiert war. Für SCSS-Support wird zwingend die Extended-Version benötigt. Da im GitHub Codespace keine Administratorrechte für apt-get vorlagen, war eine manuelle Installation der Binary erforderlich.

2. Installation:

  • Manueller Download der Binary von GitHub und Speichern in Codespace
$ wget https://github.com/gohugoio/hugo/releases/download/v0.146.0/hugo_extended_0.146.0_linux-amd64.tar.gz
  • Das tar-Archiv entpacken
$ tar -xvf hugo_extended_0.146.0_linux-amd64.tar.gz hugo

3. Ausführung:

  • Start des Servers mit ab jetzt aus dem Hauptverzeichnis heraus mit
./hugo server

Fazit

Wer moderne Hugo-Themes in Cloud-Umgebungen nutzt, muss die Versions-Abhängigkeiten im Blick behalten. Dass die Standard-Installation im Codespace für das Ananke-Theme nicht ausreicht, ließ sich erst durch einen Blick in die Log-Files und den Abgleich der Hugo-Features klären. Die Lösung liegt in der Unabhängigkeit vom System-Repository: Der manuelle Download der Extended-Version ermöglicht die volle Kontrolle über die Build-Pipeline, ungeachtet restriktiver Benutzerrechte.

Ähnliche Beiträge: