Troubleshooting: Hugo Extended Setup

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.

• Hugo
• Linux
• Troubleshooting