hugo: bump version to 0.147.8, address deprecations

t-lo · poettering · commit 12ca3c874bf5 · 2025-11-24T19:46:05.000+01:00
This change bumps the Hugo version used to build web pages to v0.147.8
and addresses build issues introduced by functions deprecated in newer
hugo versions:
- .Site.IsMultiLingual =&gt; hugo.IsMultilingual
- resources.ToCSS =&gt; css.Sass
Templates and partials that use deprecated functions are now overridden
in layout/.

Lastly, symlink from content/ to the Readme was removed as Hugo does noti
 support symlinks anymore, and replaced by "mounts" in config.toml.

The Hugo version was bumped in gh-pages.yml.

Signed-off-by: Thilo Fromm &lt;thilofromm@microsoft.com&gt;
diff --git a/.github/workflows/gh-pages.yml b/.github/workflows/gh-pages.yml
@@ -21,7 +21,7 @@ jobs:
       - name: Setup Hugo
         uses: peaceiris/actions-hugo@v2
         with:
-          hugo-version: '0.104.3'
+          hugo-version: '0.147.8'
           extended: true
 
       - name: Build
diff --git a/website/config.toml b/website/config.toml
@@ -31,3 +31,8 @@ theme = "hugo-book"
   BookCommitPath = 'commit'
   BookEditPath = 'edit/main'
   BookIndexPage = 'README.md'
+
+[modules]
+  [[module.mounts]]
+    source = '../README.md'
+    target = 'content/_index.md'
diff --git a/website/content/_index.md b/website/content/_index.md
diff --git a/website/layouts/404.html b/website/layouts/404.html
@@ -0,0 +1,35 @@
+<!DOCTYPE html>
+<html lang="{{ .Site.Language.Lang }}">
+
+  <head>
+    {{ partial "docs/html-head" . }}
+    {{ partial "docs/inject/head" . }}
+
+    <style>
+      .not-found {
+        text-align: center;
+      }
+      .not-found h1 {
+        margin: .25em 0 0 0;
+        opacity: .25;
+        font-size: 40vmin;
+      }
+    </style>
+  </head>
+
+  <body>
+    <main class="flex justify-center not-found">
+      <div>
+        <h1>404</h1>
+        <h2>Page Not Found</h2>
+        <h3>
+          <a href="{{ .Site.Home.RelPermalink }}">{{ .Site.Title }}</a>
+        </h3>
+      </div>
+    </main>
+
+    {{ partial "docs/inject/body" . }}
+    {{ template "_internal/google_analytics.html" . }}
+  </body>
+
+  </html>
diff --git a/website/layouts/partials/docs/footer.html b/website/layouts/partials/docs/footer.html
@@ -1,5 +1,5 @@
 <div class="flex flex-wrap justify-between">
-{{ if .Site.IsMultiLingual }}
+{{ if hugo.IsMultilingual }}
   {{ partial "docs/languages" . }}
 {{ end }}
 
diff --git a/website/layouts/partials/docs/html-head.html b/website/layouts/partials/docs/html-head.html
@@ -0,0 +1,43 @@
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="{{ default .Summary .Description }}">
+<meta name="theme-color" content="#FFFFFF">
+
+{{- template "_internal/opengraph.html" . -}}
+
+<title>{{ partial "docs/title" . }} | {{ .Site.Title -}}</title>
+
+{{- $manifest := resources.Get "manifest.json" | resources.ExecuteAsTemplate "manifest.json" . }}
+<link rel="manifest" href="{{ $manifest.RelPermalink }}">
+<link rel="icon" href="{{ "favicon.png" | relURL }}" type="image/x-icon">
+
+{{- range .Translations }}
+<link rel="alternate" hreflang="{{ .Language.Lang }}" href="{{ .Permalink }}" title="{{ partial "docs/title" . }}">
+{{ end -}}
+
+<!-- Theme stylesheet, you can customize scss by creating `assets/custom.scss` in your website -->
+{{- $styles := resources.Get "book.scss" | resources.ExecuteAsTemplate "book.scss" . | css.Sass | resources.Minify | resources.Fingerprint }}
+<link rel="stylesheet" href="{{ $styles.RelPermalink }}" integrity="{{ $styles.Data.Integrity }}">
+
+{{- if default true .Site.Params.BookSearch }}
+{{- $searchJSFile := printf "%s.search.js" .Language.Lang }}
+{{- $searchJS := resources.Get "search.js" | resources.ExecuteAsTemplate $searchJSFile . | resources.Minify | resources.Fingerprint }}
+<script defer src="{{ $searchJS.RelPermalink }}" integrity="{{ $searchJS.Data.Integrity }}"></script>
+{{ end -}}
+
+{{- if .Site.Params.BookServiceWorker }}
+{{- $swJS := resources.Get "sw-register.js" | resources.ExecuteAsTemplate "sw.js" . | resources.Minify | resources.Fingerprint }}
+<script defer src="{{ $swJS.RelPermalink }}" integrity="{{ $swJS.Data.Integrity }}"></script>
+{{ end -}}
+
+{{- template "_internal/google_analytics.html" . -}}
+
+<!-- RSS -->
+{{- with .OutputFormats.Get "rss" -}}
+  {{ printf `<link rel="%s" type="%s" href="%s" title="%s" />` .Rel .MediaType.Type .Permalink $.Site.Title | safeHTML }}
+{{ end -}}
+
+{{ "<!--" | safeHTML }}
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+{{ "-->" | safeHTML }}
