From 1e722fdad57be880a9fdb6b4348dad1846c71635 Mon Sep 17 00:00:00 2001
From: David Karlsson <35727626+dvdksn@users.noreply.github.com>
Date: Thu, 4 Dec 2025 17:42:01 +0100
Subject: [PATCH] site: improve schema.org json-ld markup

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
---
 layouts/partials/meta.html   |   2 +-
 layouts/partials/schema.html | 110 +++++++++++++++++++++++++++++++++++
 2 files changed, 111 insertions(+), 1 deletion(-)
 create mode 100644 layouts/partials/schema.html

diff --git a/layouts/partials/meta.html b/layouts/partials/meta.html
index a171450eb729..10a2951b86fb 100644
--- a/layouts/partials/meta.html
+++ b/layouts/partials/meta.html
@@ -58,4 +58,4 @@
   itemprop="datePublished"
   content="{{ .PublishDate | default .Lastmod }}"
 />
-  <script type="application/ld+json">{"@context":"https://schema.org","@type":"WebPage","headline":{{ .LinkTitle | jsonify }},"description":{{ $description | jsonify }},"url":"{{ .Permalink }}"}</script>
+{{ partial "schema.html" . }}
diff --git a/layouts/partials/schema.html b/layouts/partials/schema.html
new file mode 100644
index 000000000000..6422e7d2ae96
--- /dev/null
+++ b/layouts/partials/schema.html
@@ -0,0 +1,110 @@
+{{- $description := partial "utils/description.html" . -}}
+{{- $keywords := delimit (partialCached "utils/keywords.html" . .) ", " -}}
+
+{{- /* Build TechArticle schema for content pages */ -}}
+{{- $schema := dict
+  "@context" "https://schema.org"
+  "@type" "TechArticle"
+  "headline" .LinkTitle
+  "description" $description
+  "url" .Permalink
+-}}
+
+{{- /* Add dates (from Git via enableGitInfo) */ -}}
+{{- with .PublishDate -}}
+  {{- $schema = merge $schema (dict "datePublished" (time.Format "2006-01-02T15:04:05Z07:00" .)) -}}
+{{- end -}}
+{{- with .Lastmod -}}
+  {{- $schema = merge $schema (dict "dateModified" (time.Format "2006-01-02T15:04:05Z07:00" .)) -}}
+{{- end -}}
+
+{{- /* Add author and publisher */ -}}
+{{- $logoUrl := printf "%sassets/images/docker-logo.png" (strings.TrimSuffix "/" site.BaseURL | printf "%s/") -}}
+{{- $org := dict
+  "@type" "Organization"
+  "name" "Docker Inc"
+  "url" "https://www.docker.com"
+-}}
+{{- $schema = merge $schema (dict "author" $org "publisher" (merge $org (dict "logo" (dict "@type" "ImageObject" "url" $logoUrl)))) -}}
+
+{{- /* Add article section (from Hugo section) */ -}}
+{{- with .Section -}}
+  {{- $schema = merge $schema (dict "articleSection" .) -}}
+{{- end -}}
+
+{{- /* Add keywords if present */ -}}
+{{- with $keywords -}}
+  {{- $schema = merge $schema (dict "keywords" .) -}}
+{{- end -}}
+
+{{- /* Add time required if specified in frontmatter */ -}}
+{{- with .Params.time -}}
+  {{- /* Convert "20 minutes" to ISO 8601 duration "PT20M" */ -}}
+  {{- $duration := . -}}
+  {{- $isoDuration := "" -}}
+  {{- if findRE `(\d+)\s*minutes?` $duration -}}
+    {{- $mins := index (findRE `\d+` $duration) 0 -}}
+    {{- $isoDuration = printf "PT%sM" $mins -}}
+  {{- else if findRE `(\d+)\s*hours?` $duration -}}
+    {{- $hours := index (findRE `\d+` $duration) 0 -}}
+    {{- $isoDuration = printf "PT%sH" $hours -}}
+  {{- end -}}
+  {{- with $isoDuration -}}
+    {{- $schema = merge $schema (dict "timeRequired" .) -}}
+  {{- end -}}
+{{- end -}}
+
+{{- /* Add isPartOf relationship to parent section */ -}}
+{{- with .Parent -}}
+  {{- if and (not .IsHome) .Permalink -}}
+    {{- $isPartOf := dict
+      "@type" "WebPage"
+      "@id" .Permalink
+      "name" .LinkTitle
+    -}}
+    {{- $schema = merge $schema (dict "isPartOf" $isPartOf) -}}
+  {{- end -}}
+{{- end -}}
+
+{{- /* Output the schema as JSON-LD */ -}}
+<script type="application/ld+json">{{ $schema | jsonify | safeJS }}</script>
+
+{{- /* Add BreadcrumbList schema */ -}}
+{{- $breadcrumbs := slice -}}
+{{- $position := 1 -}}
+{{- range .Ancestors.Reverse -}}
+  {{- if and (not .IsHome) .Permalink -}}
+    {{- $item := dict
+      "@type" "ListItem"
+      "position" $position
+      "item" (dict
+        "@id" .Permalink
+        "name" .LinkTitle
+      )
+    -}}
+    {{- $breadcrumbs = $breadcrumbs | append $item -}}
+    {{- $position = add $position 1 -}}
+  {{- end -}}
+{{- end -}}
+
+{{- /* Add current page to breadcrumbs */ -}}
+{{- $currentItem := dict
+  "@type" "ListItem"
+  "position" $position
+  "item" (dict
+    "@id" .Permalink
+    "name" .LinkTitle
+  )
+-}}
+{{- $breadcrumbs = $breadcrumbs | append $currentItem -}}
+
+{{- /* Only output breadcrumbs if there's more than just the current page */ -}}
+{{- if gt (len $breadcrumbs) 1 -}}
+<script type="application/ld+json">
+{{- dict
+  "@context" "https://schema.org"
+  "@type" "BreadcrumbList"
+  "itemListElement" $breadcrumbs
+| jsonify | safeJS -}}
+</script>
+{{- end -}}