From d3eacc9daf7816862e68668be0ffd935f71f8325 Mon Sep 17 00:00:00 2001
From: Bigstool <20697772+Bigstool@users.noreply.github.com>
Date: Mon, 4 May 2026 04:49:42 +0800
Subject: [PATCH] fix: Hugo language related deprecation (v0.158.0+) (#1334)

* language related deprecation fix

Reference: https://github.com/gohugoio/hugo/releases/tag/v0.158.0
.Site.LanguageCode -> .Site.Language.Locale
.Language.LanguageDirection -> .Language.Direction
.Language.LanguageCode -> .Language.Locale

Also, in the configuration hugo.toml, the user should change `languageCode` to `locale`.

* Update languageCode to locale in configuration

* fix(languages): update languageName to label in languages.toml

* .Language.LanguageName -> .Language.Label

* .Language.Lang -> .Language.Name

---------

Co-authored-by: Jimmy Cai <jimmy@cai.im>
---
 demo/config/_default/hugo.toml                |  2 +-
 demo/config/_default/languages.toml           | 24 +++++++++----------
 .../_partials/article/components/details.html |  2 +-
 layouts/_partials/sidebar/left.html           |  6 ++---
 layouts/baseof.html                           |  2 +-
 layouts/rss.xml                               |  2 +-
 6 files changed, 19 insertions(+), 19 deletions(-)

diff --git a/demo/config/_default/hugo.toml b/demo/config/_default/hugo.toml
index 58faa84..646da2a 100644
--- a/demo/config/_default/hugo.toml
+++ b/demo/config/_default/hugo.toml
@@ -1,5 +1,5 @@
 baseURL                = "https://demo.stack.cai.im/"
-languageCode           = "en-us"
+locale                 = "en-us"
 title                  = "Hugo Theme Stack"
 # Theme i18n support
 # See i18n folder for available languages
diff --git a/demo/config/_default/languages.toml b/demo/config/_default/languages.toml
index d77bf36..bba9268 100644
--- a/demo/config/_default/languages.toml
+++ b/demo/config/_default/languages.toml
@@ -1,31 +1,31 @@
 [en]
-    languageName = "English"
-    title        = "Hugo Theme Stack"
-    weight       = 1
+    label  = "English"
+    title  = "Hugo Theme Stack"
+    weight = 1
 
     [en.params.sidebar]
         subtitle = "Card-style Hugo theme designed for bloggers"
 
 [zh]
-    languageName = "简体中文"
-    title        = "Hugo 主题 Stack"
-    weight       = 2
+    label  = "简体中文"
+    title  = "Hugo 主题 Stack"
+    weight = 2
 
     [zh.params.sidebar]
         subtitle = "为博客设计的卡片式 Hugo 主题"
 
 [zh-hant-tw]
-    languageName = "正體中文"
-    title        = "Hugo 主題 Stack"
-    weight       = 3
+    label  = "正體中文"
+    title  = "Hugo 主題 Stack"
+    weight = 3
 
     [zh-hant-tw.params.sidebar]
         subtitle = "為博客設計的卡片式 Hugo 主題"
 
 [ja]
-    languageName = "日本語"
-    title        = "Hugo Theme Stack"
-    weight       = 4
+    label  = "日本語"
+    title  = "Hugo Theme Stack"
+    weight = 4
 
     [ja.params.sidebar]
         subtitle = "ブログ用のカードスタイルの Hugo テーマ"
diff --git a/layouts/_partials/article/components/details.html b/layouts/_partials/article/components/details.html
index f145819..b311ec5 100644
--- a/layouts/_partials/article/components/details.html
+++ b/layouts/_partials/article/components/details.html
@@ -58,7 +58,7 @@
             <div class="inline-meta">
                 {{ partial "helper/icon" "language" }}
                 {{ range $Page.Translations }}
-                    <a href="{{ .RelPermalink }}" class="link">{{ .Language.LanguageName }}</a>
+                    <a href="{{ .RelPermalink }}" class="link">{{ .Language.Label }}</a>
                 {{ end }}
             </div>
         {{ end }}
diff --git a/layouts/_partials/sidebar/left.html b/layouts/_partials/sidebar/left.html
index 8319a49..1730f22 100644
--- a/layouts/_partials/sidebar/left.html
+++ b/layouts/_partials/sidebar/left.html
@@ -64,7 +64,7 @@
         {{ end }}
         <li class="menu-bottom-section">
             <ol class="menu">
-                {{- $currentLanguageCode := .Language.Lang -}}
+                {{- $currentLanguageCode := .Language.Name -}}
                 {{ if hugo.IsMultilingual }}
                     <li id="i18n-switch">  
                         {{ partial "helper/icon" "language" }}
@@ -72,11 +72,11 @@
                             {{ range .Site.Home.AllTranslations }}
                                 {{ $target := . }}
                                 {{ range $.AllTranslations }}
-                                    {{ if eq .Language.Lang $target.Language.Lang }}
+                                    {{ if eq .Language.Name $target.Language.Name }}
                                         {{ $target = . }}
                                     {{ end }}
                                 {{ end }}
-                                <option value="{{ $target.RelPermalink }}" {{ if eq $target.Language.Lang $currentLanguageCode }}selected{{ end }}>{{ .Language.LanguageName }}</option>
+                                <option value="{{ $target.RelPermalink }}" {{ if eq $target.Language.Name $currentLanguageCode }}selected{{ end }}>{{ .Language.Label }}</option>
                             {{ end }}
                         </select>
                     </li>
diff --git a/layouts/baseof.html b/layouts/baseof.html
index 83fdaa3..d1ef3ee 100644
--- a/layouts/baseof.html
+++ b/layouts/baseof.html
@@ -1,5 +1,5 @@
 <!DOCTYPE html>
-<html lang="{{ .Site.LanguageCode }}" dir="{{ default `ltr` .Language.LanguageDirection }}">
+<html lang="{{ .Site.Language.Locale }}" dir="{{ default `ltr` .Language.Direction }}">
     <head>
         {{- partial "head/head.html" . -}}
         {{- block "head" . -}}{{ end }}
diff --git a/layouts/rss.xml b/layouts/rss.xml
index 1f13ac6..dbb6ed1 100644
--- a/layouts/rss.xml
+++ b/layouts/rss.xml
@@ -30,7 +30,7 @@
         <link>{{ .Permalink }}</link>
         <description>Recent content {{ if ne .Title .Site.Title }}{{ with .Title }}in {{ . }} {{ end }}{{ end }}on {{ .Site.Title }}</description>
         <generator>Hugo -- gohugo.io</generator>
-        <language>{{ site.Language.LanguageCode }}</language>{{ with $authorEmail }}
+        <language>{{ site.Language.Locale }}</language>{{ with $authorEmail }}
         <managingEditor>{{.}}{{ with $authorName }} ({{ . }}){{ end }}</managingEditor>{{ end }}{{ with $authorEmail }}
         <webMaster>{{ . }}{{ with $authorName }} ({{ . }}){{ end }}</webMaster>{{ end }}{{ with .Site.Copyright }}
         <copyright>{{ . }}</copyright>{{ end }}{{ if not .Date.IsZero }}