Wie man Hugo behebt: can't evaluate field IsServer in type interface {}

Problem:

Beim Bauen deiner Hugo-Site siehst du eine Fehlermeldung wie die folgende:

03:27:57.943	ERROR render of "page" failed: "/opt/buildhome/repo/themes/tailbliss/layouts/_default/baseof.html:5:7": execute of template failed: template: _default/single.html:5:7: executing "_default/single.html" at <partial "head.html" .>: error calling partial: "/opt/buildhome/repo/themes/tailbliss/layouts/partials/head.html:25:6": execute of template failed: template: partials/head.html:25:6: executing "partials/head.html" at <hugo>: can't evaluate field IsServer in type interface {}

Lösung

Das Problem wird dadurch verursacht, dass Hugo .IsServer nicht findet:

can't evaluate field IsServer in type interface {}

zum Beispiel im folgenden Template-Code:

{{ if hugo.IsServer }}
<link rel="stylesheet" href="{{ $styles.RelPermalink }}" />
{{ end }}

.IsServer wurde jedoch erst in Hugo-Version 0.120.0 hinzugefügt, daher wirst du diesen Fehler sehen, wenn du eine ältere Version verwendest.

Die Lösung ist einfach. Du kannst entweder:

• Empfohlen: Aktualisiere deine Hugo-Version auf 0.120.0 oder neuer. Zum Zeitpunkt der Erstellung dieses Artikels ist Version 0.134.2 die neueste Version.
• Falls das nicht möglich ist: Entferne die .IsServer-Prüfung aus deinem Template-Code. Dies wirkt sich typischerweise nicht stark auf deine Site aus (da Produktions-Builds überhaupt nicht betroffen sind und hugo serve-Entwicklungs-Builds typischerweise nur leicht verändert werden), aber du musst möglicherweise deine Site testen, um sicherzustellen, dass alles wie erwartet funktioniert.

Hinweis: Für Cloudflare Pages kannst du die Deployment-Umgebungsvariable HUGO_VERSION auf 0.120.0 oder neuer setzen, um dieses Problem zu beheben. Ich habe dies mit 0.134.2 getestet und es hat einwandfrei funktioniert.