divineforge-com · divineforge · Jul 20, 2026 · Jul 20, 2026 · Jul 20, 2026 · Jul 21, 2026
diff --git a/.Jules/palette.md b/.Jules/palette.md
@@ -0,0 +1,3 @@
+## 2025-02-23 - Language Switcher Accessibility
+**Learning:** For multilingual support and accessibility, language switcher links must include `hreflang` and `lang` attributes matching the target language code to ensure proper screen reader pronunciation profiles are applied.
+**Action:** Add these attributes to the translations component.
diff --git a/apps/gzen-invest/hugo.toml b/apps/gzen-invest/hugo.toml
@@ -1,5 +1,5 @@
 baseURL = "https://invest.gzen.dev/"
-languageCode = "en-us"
+locale = "en"
 title = "invest.gzen"
 enableRobotsTXT = true
 

diff --git a/apps/gzen-ki/.github/copilot-instructions.md b/apps/gzen-ki/.github/copilot-instructions.md
@@ -18,7 +18,7 @@ Deployed via **Cloudflare Pages** (not GitHub Actions).
 
 ```html
 <!-- Iterate over site data -->
-{{ range .Site.Data.herbs }}
+{{ range site.Data.herbs }}
   {{ .name_zh }} — {{ .pinyin }}
 {{ end }}
 

diff --git a/apps/gzen-ki/config/_default/hugo.toml b/apps/gzen-ki/config/_default/hugo.toml
@@ -1,5 +1,5 @@
 baseURL = "https://genki.gzen.io/"
-languageCode = "zh-CN"
+locale = "zh-CN"
 defaultContentLanguage = "zh-cn"
 title = "元気・健康笔记"
 theme = "blowfish"

diff --git a/apps/gzen-ki/config/_default/languages.zh-cn.toml b/apps/gzen-ki/config/_default/languages.zh-cn.toml
@@ -1,6 +1,6 @@
 disabled    = false
-languageCode = "zh-CN"
-languageName = "中文"
+locale = "zh-CN"
+label = "中文"
 weight       = 1
 title        = "元気・健康笔记"
 

diff --git a/apps/gzen-ki/layouts/gallery/list.html b/apps/gzen-ki/layouts/gallery/list.html
@@ -1,5 +1,5 @@
 {{/* Gallery list — Herb Gallery with filter bar
-     Reads from .Site.Data.herbs (data/herbs.yaml)
+     Reads from site.Data.herbs (data/herbs.yaml)
      Uses Blowfish base template via {{ define "main" }}
 */}}
 {{ define "main" }}
@@ -32,7 +32,7 @@ <h1 class="mt-5 text-4xl font-extrabold text-neutral-900 dark:text-neutral">{{ .
 
   {{/* Herb grid */}}
   <div class="herb-gallery-grid" id="herb-gallery">
-    {{ range .Site.Data.herbs }}
+    {{ range site.Data.herbs }}
     <div class="herb-card" data-category="{{ .category }}">
       <div class="herb-stripe {{ .nature }}"></div>
       <div class="herb-body">

diff --git a/apps/gzen-ki/themes/blowfish/config/_default/languages.en.toml b/apps/gzen-ki/themes/blowfish/config/_default/languages.en.toml
@@ -1,6 +1,6 @@
 disabled = false
-languageCode = "en"
-languageName = "English"
+locale = "en"
+label = "English"
 weight = 1
 title = "Blowfish"
 

diff --git a/apps/gzen-ki/themes/blowfish/layouts/_default/baseof.html b/apps/gzen-ki/themes/blowfish/layouts/_default/baseof.html
@@ -1,6 +1,6 @@
 <!doctype html>
 <html
-  lang="{{ with site.Params.isoCode | default (site.LanguageCode | default `en`) }}{{- . -}}{{ end }}"
+  lang="{{ with site.Params.isoCode | default (site.Language.Label | default `en`) }}{{- . -}}{{ end }}"
   dir="{{ cond (site.Params.rtl | default false) `rtl` `ltr` }}"
   class="scroll-smooth"
   data-default-appearance="{{ site.Params.defaultAppearance | default `light` }}"

diff --git a/apps/gzen-ki/themes/blowfish/layouts/_default/rss.xml b/apps/gzen-ki/themes/blowfish/layouts/_default/rss.xml
@@ -17,7 +17,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.LanguageCode }}</language>{{ with .Site.Params.Author.email }}
+    <language>{{ site.Language.Label }}</language>{{ with .Site.Params.Author.email }}
     <managingEditor>{{.}}{{ with $.Site.Params.Author.name }} ({{.}}){{end}}</managingEditor>{{end}}{{ with .Site.Params.Author.email }}
     <webMaster>{{.}}{{ with $.Site.Params.Author.name }} ({{.}}){{end}}</webMaster>{{end}}
     {{ if .Site.Params.footer.showCopyright | default true -}}

diff --git a/apps/gzen-ki/themes/blowfish/layouts/_default/sitemap.xml b/apps/gzen-ki/themes/blowfish/layouts/_default/sitemap.xml
@@ -10,12 +10,12 @@
     <priority>{{ .Sitemap.Priority }}</priority>{{ end }}{{ if .IsTranslated }}{{ range .Translations }}
     <xhtml:link
       rel="alternate"
-      hreflang="{{ .Language.LanguageCode }}"
+      hreflang="{{ .Language.Label }}"
       href="{{ .Permalink }}"
     />{{ end }}
     <xhtml:link
       rel="alternate"
-      hreflang="{{ .Language.LanguageCode }}"
+      hreflang="{{ .Language.Label }}"
       href="{{ $link }}"
     />{{ end }}
   </url>

diff --git a/apps/gzen-ki/themes/blowfish/layouts/partials/head.html b/apps/gzen-ki/themes/blowfish/layouts/partials/head.html
@@ -1,6 +1,6 @@
 <head>
   <meta charset="utf-8">
-  {{ with .Site.Language.Params.htmlCode | default .Site.LanguageCode }}
+  {{ with .Site.Language.Params.htmlCode | default .Site.Language.Label }}
     <meta http-equiv="content-language" content="{{ . }}">
   {{ end }}
   <meta name="viewport" content="width=device-width, initial-scale=1.0">

diff --git a/apps/gzen-ki/themes/blowfish/layouts/partials/schema.html b/apps/gzen-ki/themes/blowfish/layouts/partials/schema.html
@@ -6,7 +6,7 @@
     "@id": {{ site.Home.Permalink | safeURL }},
     "name": "{{ .Site.Title | safeJS }}",
     {{ with .Site.Params.description }}"description": "{{ . | safeJS }}",{{ end }}
-    {{ with .Site.LanguageCode }}"inLanguage": "{{ . }}",{{ end }}
+    {{ with .Site.Language.Label }}"inLanguage": "{{ . }}",{{ end }}
     "url": {{ site.Home.Permalink | safeURL }},
     {{ with .Site.Params.keywords }}"keywords": {{ . }},{{ end }}
     "publisher" : {
@@ -25,7 +25,7 @@
     "name": "{{ .Title | safeJS }}",
     "headline": "{{ .Title | safeJS }}",
     {{ with .Description }}"description": "{{ . | safeJS }}",{{ end }}
-    {{ with .Site.LanguageCode }}"inLanguage": "{{ . }}",{{ end }}
+    {{ with .Site.Language.Label }}"inLanguage": "{{ . }}",{{ end }}
     "url" : {{ .Permalink }},
     "author" : {
       "@type": "Person",

diff --git a/apps/gzen-ki/themes/blowfish/layouts/shortcodes/codeberg.html b/apps/gzen-ki/themes/blowfish/layouts/shortcodes/codeberg.html
@@ -1,6 +1,6 @@
 {{ $id := delimit (slice "codeberg" (partial "functions/uid.html" .)) "-" }}
 {{- $codebergURL := print "https://codeberg.org/api/v1/repos/" (.Get "repo") -}}
-{{- $repoColors := .Site.Data.repoColors -}}
+{{- $repoColors := site.Data.repoColors -}}
 {{- $codebergData := dict -}}
 {{- with try (resources.GetRemote $codebergURL) -}}
   {{- with .Err -}}

diff --git a/apps/gzen-ki/themes/blowfish/layouts/shortcodes/forgejo.html b/apps/gzen-ki/themes/blowfish/layouts/shortcodes/forgejo.html
@@ -1,6 +1,6 @@
 {{ $id := delimit (slice "forgejo" (partial "functions/uid.html" .)) "-" }}
 {{- $forgejoURL := print (.Get "server" | default .Site.Params.forgejoDefaultServer) "/api/v1/repos/" (.Get "repo") -}}
-{{- $repoColors := .Site.Data.repoColors -}}
+{{- $repoColors := site.Data.repoColors -}}
 {{- $forgejoData := dict -}}
 {{- with try (resources.GetRemote $forgejoURL) -}}
   {{- with .Err -}}

diff --git a/apps/gzen-ki/themes/blowfish/layouts/shortcodes/gitea.html b/apps/gzen-ki/themes/blowfish/layouts/shortcodes/gitea.html
@@ -1,6 +1,6 @@
 {{ $id := delimit (slice "gitea" (partial "functions/uid.html" .)) "-" }}
 {{- $giteaURL := print (.Get "server" | default .Site.Params.giteaDefaultServer) "/api/v1/repos/" (.Get "repo") -}}
-{{- $repoColors := .Site.Data.repoColors -}}
+{{- $repoColors := site.Data.repoColors -}}
 {{- $giteaData := dict -}}
 {{- with try (resources.GetRemote $giteaURL) -}}
   {{- with .Err -}}

diff --git a/apps/gzen-ki/themes/blowfish/layouts/shortcodes/github.html b/apps/gzen-ki/themes/blowfish/layouts/shortcodes/github.html
@@ -2,7 +2,7 @@
 {{- $githubURL := print "https://api.github.com/repos/" (.Get "repo") -}}
 {{- $githubThumbnailURL := print "https://opengraph.githubassets.com/0/" (.Get "repo") -}}
 {{- $showThumbnail := .Get "showThumbnail" | default true -}}
-{{- $repoColors := .Site.Data.repoColors -}}
+{{- $repoColors := site.Data.repoColors -}}
 {{- $githubData := dict -}}
 {{- with try (resources.GetRemote $githubURL) -}}
   {{- with .Err -}}

diff --git a/apps/gzen-ki/themes/gzen/layouts/gallery/list.html b/apps/gzen-ki/themes/gzen/layouts/gallery/list.html
@@ -18,7 +18,7 @@ <h1>{{ .Title }}</h1>
 </div>
 
 <div class="gallery-grid" id="herb-gallery">
-  {{ range .Site.Data.herbs }}
+  {{ range site.Data.herbs }}
   <div class="herb-card" data-category="{{ .category }}">
     <div class="herb-card-stripe {{ .nature }}"></div>
     <div class="herb-card-body">

diff --git a/apps/gzen-learn/hugo.toml b/apps/gzen-learn/hugo.toml
@@ -1,5 +1,5 @@
 baseURL = 'https://learn.gzen.io/'
-languageCode = 'en-us'
+locale = 'en'
 title = 'GZen — Japanese, Korean & Russian Language Learning'
 
 [params]