docs: move Hugo and theme up to latest

Dive into the changes required to make use of the most recent
Hugo and Docsy.

Co-authored by AI.

Signed-off-by: Gustavo Padovan <[email protected]>

Author: padovan

.github/workflows/deploy.yml

@@ -63,16 +63,19 @@ jobs:
       - name: Setup Hugo
         uses: peaceiris/actions-hugo@v3
         with:
-          hugo-version: '0.97.3'
+          hugo-version: '0.148.0'
           extended: true
 
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: '20'
 
-      - name: Install dependencies (postcss), bootstrap-sass
-        run: npm install --save-dev autoprefixer && npm install postcss-cli && npm install -D postcss && npm install -D postcss-preset-env && npm install -D bootstrap-sass
+      - name: Install NPM dependencies
+        run: cd kernelci.org && npm install
+
+      - name: Initialize Hugo modules
+        run: cd kernelci.org && hugo mod tidy
 
       - name: Build staging
         if: github.event.inputs.environment == 'staging' || github.event_name == 'issue_comment'

.gitmodules

@@ -1,6 +1,3 @@
-[submodule "kernelci.org/themes/docsy"]
-	path = kernelci.org/themes/docsy
-	url = https://github.com/google/docsy.git
 [submodule "kernelci.org/external/kernelci-core"]
 	path = kernelci.org/external/kernelci-core
 	url = https://github.com/kernelci/kernelci-core.git

README.md

@@ -38,9 +38,11 @@ $ cd kernelci.org
 
 Then to start the server:
 ```sh
-$ docker run -v $PWD:/src -p 1313:1313 klakegg/hugo:0.97.3-ext-debian server -D
+$ docker run -v $PWD:/src -p 1313:1313 hugomods/hugo:exts-0.148.0 server -D
 ```
 
+Note: The site now uses Hugo modules with Docsy v0.12.0. Hugo will automatically download the required modules on first run.
+
 Alternatively, this can be started with `docker-compose`:
 
 ```sh

kernelci.org/.gitignore

@@ -1,2 +1,4 @@
 resources/_gen
 public
+node_modules/
+.hugo_build.lock

kernelci.org/config.toml

@@ -1,5 +1,4 @@
 baseURL = "https://kernelci.org/"
-theme = "docsy"
 
 # -- languages --
 
@@ -51,7 +50,7 @@ sidebar_menu_compact = false
 breadcrumb_disable = false
 sidebar_search_disable = false
 navbar_logo = true
-footer_about_disable = false
+footer_about_enable = true
 
 [params.links]
 
@@ -105,3 +104,14 @@ footer_about_disable = false
     name = "Documentation"
     url = "/"
     weight = 5
+
+# -- Hugo modules configuration --
+
+[module]
+  proxy = "direct"
+  [module.hugoVersion]
+    extended = true
+    min = "0.146.0"
+  [[module.imports]]
+    path = "github.com/google/docsy"
+    disable = false

kernelci.org/docker-compose.yaml

@@ -12,12 +12,12 @@
 # 2)retrieve all lfs files with `git lfs pull`
 # you might need to install git-lfs with `sudo apt install git-lfs`
 # 3)run `docker-compose up` to start the server
+# Note: The site uses Hugo modules - Hugo will automatically download required modules
 
-version: '3'
 services:
   localhugo:
     container_name: 'localhugo'
-    image: 'hubci/hugo:0.97.3'
+    image: 'hugomods/hugo:exts-0.148.0'
     volumes:
       - '.:/src'
     ports:

kernelci.org/go.mod

@@ -0,0 +1,5 @@
+module kernelci.org
+
+go 1.24.5
+
+require github.com/google/docsy v0.12.0 // indirect

kernelci.org/go.sum

@@ -0,0 +1,4 @@
+github.com/FortAwesome/Font-Awesome v0.0.0-20241216213156-af620534bfc3/go.mod h1:IUgezN/MFpCDIlFezw3L8j83oeiIuYoj28Miwr/KUYo=
+github.com/google/docsy v0.12.0 h1:CddZKL39YyJzawr8GTVaakvcUTCJRAAYdz7W0qfZ2P4=
+github.com/google/docsy v0.12.0/go.mod h1:1bioDqA493neyFesaTvQ9reV0V2vYy+xUAnlnz7+miM=
+github.com/twbs/bootstrap v5.3.6+incompatible/go.mod h1:fZTSrkpSf0/HkL0IIJzvVspTt1r9zuf7XlZau8kpcY0=