From d049c59ac92a1dccf10fb8ff7e19b1c3273407a6 Mon Sep 17 00:00:00 2001
From: Gregor Zeitlinger <gregor.zeitlinger@grafana.com>
Date: Tue, 3 Feb 2026 19:05:01 +0100
Subject: [PATCH 1/2] fix and test gh pages

Signed-off-by: Gregor Zeitlinger <gregor.zeitlinger@grafana.com>
---
 .github/workflows/test-release-build.yml      |  6 +-
 .../layouts/partials/microformats/schema.html | 97 +++++++------------
 2 files changed, 39 insertions(+), 64 deletions(-)

diff --git a/.github/workflows/test-release-build.yml b/.github/workflows/test-release-build.yml
index 357cc763c..f7fa4cc4f 100644
--- a/.github/workflows/test-release-build.yml
+++ b/.github/workflows/test-release-build.yml
@@ -27,8 +27,10 @@ jobs:
           key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}
           restore-keys: |
             ${{ runner.os }}-maven-
-      - name: Build Javadoc
-        run: mise run javadoc
+      - name: Build GitHub Pages
+        run: mise run build-gh-pages
+        env:
+          BASE_URL: "/client_java/"
       - name: Build release version
         run: mise run build-release
         env:
diff --git a/docs/themes/hugo-geekdoc/layouts/partials/microformats/schema.html b/docs/themes/hugo-geekdoc/layouts/partials/microformats/schema.html
index e4a71eb4e..e52f51402 100644
--- a/docs/themes/hugo-geekdoc/layouts/partials/microformats/schema.html
+++ b/docs/themes/hugo-geekdoc/layouts/partials/microformats/schema.html
@@ -1,70 +1,43 @@
 {{ $isPage := or (and (ne .Type "posts") (in "section page" .Kind )) (and (eq .Type "posts") (eq .Kind "page")) }}
 {{- if eq .Kind "home" }}
+  {{- $schema := dict "@context" "http://schema.org" "@type" "WebSite" "name" .Site.Title "url" .Site.BaseURL "inLanguage" .Lang }}
+  {{- with partial "utils/description" . }}
+    {{- $schema = merge $schema (dict "description" (. | plainify | htmlUnescape | chomp)) }}
+  {{- end }}
+  {{- with partial "utils/featured" . }}
+    {{- $schema = merge $schema (dict "thumbnailUrl" .) }}
+  {{- end }}
+  {{- with .Site.Params.geekdocContentLicense }}
+    {{- $schema = merge $schema (dict "license" .name) }}
+  {{- end }}
   <script type="application/ld+json">
-  {
-      "@context": "http://schema.org",
-      "@type": "WebSite",
-      "name": {{ .Site.Title }},
-      "url": {{ .Site.BaseURL }},
-      {{- with partial "utils/description" . }}
-      "description": "{{ . | plainify | htmlUnescape | chomp }}",
-      {{- end }}
-      {{- with partial "utils/featured" . }}
-      "thumbnailUrl": {{ . }},
-      {{- end }}
-      {{- with .Site.Params.geekdocContentLicense }}
-      "license": "{{ .name }}",
-      {{- end }}
-      "inLanguage": {{ .Lang }}
-  }
+  {{- $schema | jsonify | safeJS }}
   </script>
 {{- else if $isPage }}
+  {{- $title := partial "utils/title" . }}
+  {{- $schema := dict "@context" "http://schema.org" "@type" "TechArticle" "articleSection" (.Section | humanize | title) "name" $title "url" .Permalink "headline" $title "wordCount" (string .WordCount) "inLanguage" .Lang "isFamilyFriendly" "true" "copyrightHolder" .Site.Title "copyrightYear" (.Date.Format "2006") "dateCreated" (.Date.Format "2006-01-02T15:04:05.00Z") "datePublished" (.PublishDate.Format "2006-01-02T15:04:05.00Z") "dateModified" (.Lastmod.Format "2006-01-02T15:04:05.00Z") }}
+  {{- with .Params.lead }}
+    {{- $schema = merge $schema (dict "alternativeHeadline" .) }}
+  {{- end }}
+  {{- with partial "utils/description" . }}
+    {{- $schema = merge $schema (dict "description" (. | plainify | htmlUnescape | chomp)) }}
+  {{- end }}
+  {{- with partial "utils/featured" . }}
+    {{- $schema = merge $schema (dict "thumbnailUrl" .) }}
+  {{- end }}
+  {{- with .Site.Params.geekdocContentLicense }}
+    {{- $schema = merge $schema (dict "license" .name) }}
+  {{- end }}
+  {{- $mainEntity := dict "@type" "WebPage" "@id" .Permalink }}
+  {{- $schema = merge $schema (dict "mainEntityOfPage" $mainEntity) }}
+  {{- with $tags := .Params.tags }}
+    {{- $schema = merge $schema (dict "keywords" $tags) }}
+  {{- end }}
+  {{- $logoUrl := default "brand.svg" .Site.Params.logo | absURL }}
+  {{- $logo := dict "@type" "ImageObject" "url" $logoUrl "width" "32" "height" "32" }}
+  {{- $publisher := dict "@type" "Organization" "name" .Site.Title "url" .Site.BaseURL "logo" $logo }}
+  {{- $schema = merge $schema (dict "publisher" $publisher) }}
   <script type="application/ld+json">
-  {
-      "@context": "http://schema.org",
-      "@type": "TechArticle",
-      "articleSection": "{{ .Section | humanize | title }}",
-      "name": {{ partial "utils/title" . }},
-      "url" : {{ .Permalink }},
-      "headline": {{ partial "utils/title" . }},
-      {{- with .Params.lead }}
-      "alternativeHeadline": {{ . }},
-      {{- end }}
-      {{- with partial "utils/description" . }}
-      "description": "{{ . | plainify | htmlUnescape | chomp }}",
-      {{- end }}
-      {{- with partial "utils/featured" . }}
-      "thumbnailUrl": {{ . }},
-      {{- end }}
-      "wordCount" : "{{ .WordCount }}",
-      {{- with .Site.Params.geekdocContentLicense }}
-      "license": "{{ .name }}",
-      {{- end }}
-      "inLanguage": {{ .Lang }},
-      "isFamilyFriendly": "true",
-      "mainEntityOfPage": {
-          "@type": "WebPage",
-          "@id": {{ .Permalink }}
-      },
-      {{- with $tags := .Params.tags }}
-      "keywords" : [ {{ range $i, $tag := $tags }}{{ if $i }}, {{ end }}"{{ $tag }}" {{ end }}],
-      {{- end }}
-      "copyrightHolder" : "{{ .Site.Title }}",
-      "copyrightYear" : "{{ .Date.Format "2006" }}",
-      "dateCreated": "{{ .Date.Format "2006-01-02T15:04:05.00Z" | safeJS }}",
-      "datePublished": "{{ .PublishDate.Format "2006-01-02T15:04:05.00Z" | safeJS }}",
-      "dateModified": "{{ .Lastmod.Format "2006-01-02T15:04:05.00Z" | safeJS }}",
-      "publisher":{
-          "@type":"Organization",
-          "name": {{ .Site.Title }},
-          "url": {{ .Site.BaseURL }},
-          "logo": {
-              "@type": "ImageObject",
-              "url": {{ (default "brand.svg" .Site.Params.logo) | absURL }},
-              "width":"32",
-              "height":"32"
-          }
-      }
-  }
+  {{- $schema | jsonify | safeJS }}
   </script>
 {{- end }}

From 6e9808d112c78413f3937e846e4e44dfd6e40b7a Mon Sep 17 00:00:00 2001
From: Gregor Zeitlinger <gregor.zeitlinger@grafana.com>
Date: Tue, 3 Feb 2026 19:19:30 +0100
Subject: [PATCH 2/2] fix

Signed-off-by: Gregor Zeitlinger <gregor.zeitlinger@grafana.com>
---
 .github/workflows/test-release-build.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/test-release-build.yml b/.github/workflows/test-release-build.yml
index f7fa4cc4f..c134ec991 100644
--- a/.github/workflows/test-release-build.yml
+++ b/.github/workflows/test-release-build.yml
@@ -16,6 +16,8 @@ jobs:
       - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
         with:
           persist-credentials: false
+          fetch-tags: "true"
+          fetch-depth: 0
       - uses: jdx/mise-action@6d1e696aa24c1aa1bcc1adea0212707c71ab78a8 # v3.6.1
         with:
           version: v2026.2.0