Add JSON-LD schemas for BreadcrumbList and TechArticle

Copilot · gkorland · Copilot · commit 83e90301257d · 2025-11-16T19:19:34.000Z
Co-authored-by: gkorland &lt;753206+gkorland@users.noreply.github.com&gt;
diff --git a/_includes/breadcrumb_schema.html b/_includes/breadcrumb_schema.html
@@ -0,0 +1,41 @@
+{% comment %}
+BreadcrumbList JSON-LD Schema.org markup
+Generates breadcrumb navigation structure for SEO
+{% endcomment %}
+{% if page.url != "/" %}
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "BreadcrumbList",
+  "itemListElement": [
+    {
+      "@type": "ListItem",
+      "position": 1,
+      "name": "Home",
+      "item": "{{ site.url | default: 'https://docs.falkordb.com' }}"
+    }
+    {% assign position = 2 %}
+    {% if page.parent %}
+    {% comment %}Find parent page{% endcomment %}
+    {% assign parent_pages = site.pages | where: "title", page.parent %}
+    {% if parent_pages.size > 0 %}
+    {% assign parent = parent_pages | first %}
+    ,{
+      "@type": "ListItem",
+      "position": {{ position }},
+      "name": "{{ parent.title }}",
+      "item": "{{ site.url | default: 'https://docs.falkordb.com' }}{{ parent.url }}"
+    }
+    {% assign position = position | plus: 1 %}
+    {% endif %}
+    {% endif %}
+    ,{
+      "@type": "ListItem",
+      "position": {{ position }},
+      "name": "{{ page.title }}",
+      "item": "{{ site.url | default: 'https://docs.falkordb.com' }}{{ page.url }}"
+    }
+  ]
+}
+</script>
+{% endif %}
diff --git a/_includes/head_custom.html b/_includes/head_custom.html
@@ -11,3 +11,7 @@
 })(window,document,'script','dataLayer','{{ site.gtm_tracking }}');</script>
 <!-- End Google Tag Manager -->
 {% endif %}
+
+<!-- JSON-LD Schema.org Structured Data -->
+{% include breadcrumb_schema.html %}
+{% include techarticle_schema.html %}
diff --git a/_includes/techarticle_schema.html b/_includes/techarticle_schema.html
@@ -0,0 +1,36 @@
+{% comment %}
+TechArticle JSON-LD Schema.org markup
+Provides structured data for technical documentation pages
+{% endcomment %}
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "TechArticle",
+  "headline": "{{ page.title | default: site.title }}",
+  {% if page.description %}
+  "description": "{{ page.description | strip_html | strip_newlines | escape }}",
+  {% endif %}
+  "url": "{{ site.url | default: 'https://docs.falkordb.com' }}{{ page.url }}",
+  {% if page.last_modified_at %}
+  "dateModified": "{{ page.last_modified_at | date_to_xmlschema }}",
+  {% elsif page.date %}
+  "dateModified": "{{ page.date | date_to_xmlschema }}",
+  {% endif %}
+  "author": {
+    "@type": "Organization",
+    "name": "FalkorDB"
+  },
+  "publisher": {
+    "@type": "Organization",
+    "name": "FalkorDB",
+    "logo": {
+      "@type": "ImageObject",
+      "url": "{{ site.url | default: 'https://docs.falkordb.com' }}/images/falkor-logo.png"
+    }
+  },
+  "mainEntityOfPage": {
+    "@type": "WebPage",
+    "@id": "{{ site.url | default: 'https://docs.falkordb.com' }}{{ page.url }}"
+  }
+}
+</script>
