From 56211977fbf1e2a8902cd5f57c260da5e5b8814e Mon Sep 17 00:00:00 2001
From: trean <trean.mi@gmail.com>
Date: Tue, 2 Jun 2026 16:14:45 +0200
Subject: [PATCH] add empty pages rendering guard (#2388)

---
 qdrant-landing/content/documentation/cloud-tab.md        | 2 ++
 qdrant-landing/content/documentation/deploy-tab.md       | 2 ++
 qdrant-landing/content/documentation/ecosystem-tab.md    | 2 ++
 .../themes/qdrant-2024/layouts/_default/baseof.html      | 1 +
 .../themes/qdrant-2024/layouts/articles/list.html        | 1 +
 .../themes/qdrant-2024/layouts/articles/single.html      | 1 +
 .../themes/qdrant-2024/layouts/course/list.html          | 1 +
 .../themes/qdrant-2024/layouts/course/single.html        | 1 +
 .../themes/qdrant-2024/layouts/documentation/list.html   | 1 +
 .../themes/qdrant-2024/layouts/documentation/single.html | 1 +
 .../themes/qdrant-2024/layouts/learn/list.html           | 1 +
 .../themes/qdrant-2024/layouts/learn/single.html         | 1 +
 .../qdrant-2024/layouts/partials/validate-content.html   | 9 +++++++++
 .../themes/qdrant-2024/layouts/subscribe/list.html       | 1 +
 14 files changed, 25 insertions(+)
 create mode 100644 qdrant-landing/themes/qdrant-2024/layouts/partials/validate-content.html

diff --git a/qdrant-landing/content/documentation/cloud-tab.md b/qdrant-landing/content/documentation/cloud-tab.md
index 10b305c0b..940fdde8b 100644
--- a/qdrant-landing/content/documentation/cloud-tab.md
+++ b/qdrant-landing/content/documentation/cloud-tab.md
@@ -104,4 +104,6 @@ content:
         url: https://qdrant.to/cloud
 partition: deploy
 hideInSidebar: true
+build:
+  render: always
 ---
diff --git a/qdrant-landing/content/documentation/deploy-tab.md b/qdrant-landing/content/documentation/deploy-tab.md
index dac6a9968..490411cce 100644
--- a/qdrant-landing/content/documentation/deploy-tab.md
+++ b/qdrant-landing/content/documentation/deploy-tab.md
@@ -107,4 +107,6 @@ content:
         url: https://qdrant.to/cloud
 partition: deploy
 hideInSidebar: true
+build:
+  render: always
 ---
diff --git a/qdrant-landing/content/documentation/ecosystem-tab.md b/qdrant-landing/content/documentation/ecosystem-tab.md
index 2d18c62ae..78ea08a8a 100644
--- a/qdrant-landing/content/documentation/ecosystem-tab.md
+++ b/qdrant-landing/content/documentation/ecosystem-tab.md
@@ -50,4 +50,6 @@ content:
         text: Read More
 partition: ecosystem
 hideInSidebar: true
+build:
+  render: always
 ---
diff --git a/qdrant-landing/themes/qdrant-2024/layouts/_default/baseof.html b/qdrant-landing/themes/qdrant-2024/layouts/_default/baseof.html
index 701a2b5af..7a6da4f12 100644
--- a/qdrant-landing/themes/qdrant-2024/layouts/_default/baseof.html
+++ b/qdrant-landing/themes/qdrant-2024/layouts/_default/baseof.html
@@ -2,6 +2,7 @@
 <html lang="en">
   {{- partial "head.html" . -}}
   <body>
+    {{- partial "validate-content.html" . -}}
     <main>
       {{ if (eq .Params.type "external-link") }}
         Redirecting to <a href="{{ .Params.external_url }}">external page</a>...
diff --git a/qdrant-landing/themes/qdrant-2024/layouts/articles/list.html b/qdrant-landing/themes/qdrant-2024/layouts/articles/list.html
index f641dbd4a..e72be884a 100644
--- a/qdrant-landing/themes/qdrant-2024/layouts/articles/list.html
+++ b/qdrant-landing/themes/qdrant-2024/layouts/articles/list.html
@@ -2,6 +2,7 @@
 <html lang="en">
   {{- partial "head.html" . -}}
   <body>
+    {{- partial "validate-content.html" . -}}
     <main>
       {{ partial "documentation/header" . }}
       {{ partial "documentation/content-layout" . }}
diff --git a/qdrant-landing/themes/qdrant-2024/layouts/articles/single.html b/qdrant-landing/themes/qdrant-2024/layouts/articles/single.html
index f641dbd4a..e72be884a 100644
--- a/qdrant-landing/themes/qdrant-2024/layouts/articles/single.html
+++ b/qdrant-landing/themes/qdrant-2024/layouts/articles/single.html
@@ -2,6 +2,7 @@
 <html lang="en">
   {{- partial "head.html" . -}}
   <body>
+    {{- partial "validate-content.html" . -}}
     <main>
       {{ partial "documentation/header" . }}
       {{ partial "documentation/content-layout" . }}
diff --git a/qdrant-landing/themes/qdrant-2024/layouts/course/list.html b/qdrant-landing/themes/qdrant-2024/layouts/course/list.html
index a75dbe254..63533a505 100644
--- a/qdrant-landing/themes/qdrant-2024/layouts/course/list.html
+++ b/qdrant-landing/themes/qdrant-2024/layouts/course/list.html
@@ -2,6 +2,7 @@
 <html lang="en">
   {{- partial "head.html" . -}}
   <body>
+    {{- partial "validate-content.html" . -}}
     <main>
       {{ partial "documentation/header" . }}
       {{ partial "course/content-layout" . }}
diff --git a/qdrant-landing/themes/qdrant-2024/layouts/course/single.html b/qdrant-landing/themes/qdrant-2024/layouts/course/single.html
index a75dbe254..63533a505 100644
--- a/qdrant-landing/themes/qdrant-2024/layouts/course/single.html
+++ b/qdrant-landing/themes/qdrant-2024/layouts/course/single.html
@@ -2,6 +2,7 @@
 <html lang="en">
   {{- partial "head.html" . -}}
   <body>
+    {{- partial "validate-content.html" . -}}
     <main>
       {{ partial "documentation/header" . }}
       {{ partial "course/content-layout" . }}
diff --git a/qdrant-landing/themes/qdrant-2024/layouts/documentation/list.html b/qdrant-landing/themes/qdrant-2024/layouts/documentation/list.html
index f641dbd4a..e72be884a 100644
--- a/qdrant-landing/themes/qdrant-2024/layouts/documentation/list.html
+++ b/qdrant-landing/themes/qdrant-2024/layouts/documentation/list.html
@@ -2,6 +2,7 @@
 <html lang="en">
   {{- partial "head.html" . -}}
   <body>
+    {{- partial "validate-content.html" . -}}
     <main>
       {{ partial "documentation/header" . }}
       {{ partial "documentation/content-layout" . }}
diff --git a/qdrant-landing/themes/qdrant-2024/layouts/documentation/single.html b/qdrant-landing/themes/qdrant-2024/layouts/documentation/single.html
index f641dbd4a..e72be884a 100644
--- a/qdrant-landing/themes/qdrant-2024/layouts/documentation/single.html
+++ b/qdrant-landing/themes/qdrant-2024/layouts/documentation/single.html
@@ -2,6 +2,7 @@
 <html lang="en">
   {{- partial "head.html" . -}}
   <body>
+    {{- partial "validate-content.html" . -}}
     <main>
       {{ partial "documentation/header" . }}
       {{ partial "documentation/content-layout" . }}
diff --git a/qdrant-landing/themes/qdrant-2024/layouts/learn/list.html b/qdrant-landing/themes/qdrant-2024/layouts/learn/list.html
index f641dbd4a..e72be884a 100644
--- a/qdrant-landing/themes/qdrant-2024/layouts/learn/list.html
+++ b/qdrant-landing/themes/qdrant-2024/layouts/learn/list.html
@@ -2,6 +2,7 @@
 <html lang="en">
   {{- partial "head.html" . -}}
   <body>
+    {{- partial "validate-content.html" . -}}
     <main>
       {{ partial "documentation/header" . }}
       {{ partial "documentation/content-layout" . }}
diff --git a/qdrant-landing/themes/qdrant-2024/layouts/learn/single.html b/qdrant-landing/themes/qdrant-2024/layouts/learn/single.html
index f641dbd4a..e72be884a 100644
--- a/qdrant-landing/themes/qdrant-2024/layouts/learn/single.html
+++ b/qdrant-landing/themes/qdrant-2024/layouts/learn/single.html
@@ -2,6 +2,7 @@
 <html lang="en">
   {{- partial "head.html" . -}}
   <body>
+    {{- partial "validate-content.html" . -}}
     <main>
       {{ partial "documentation/header" . }}
       {{ partial "documentation/content-layout" . }}
diff --git a/qdrant-landing/themes/qdrant-2024/layouts/partials/validate-content.html b/qdrant-landing/themes/qdrant-2024/layouts/partials/validate-content.html
new file mode 100644
index 000000000..702b87461
--- /dev/null
+++ b/qdrant-landing/themes/qdrant-2024/layouts/partials/validate-content.html
@@ -0,0 +1,9 @@
+{{ if and (not (in (slice "section" "home") .Kind)) (not .Content) (ne .Params.type "external-link") (ne .Params.build.render "always") }}
+  {{- $reset := "\033[0m" -}}
+  {{- $code := "\033[36m" -}}
+  {{- $msg := print
+    "Page %q has empty " $code ".Content" $reset ". If this is a headless file, consider adding build options to the parent " $code "_index.md" $reset " or the file itself to prevent it from being rendered. "
+    "Otherwise, add " $code "build.render: always" $reset " to the file."
+  -}}
+  {{ errorf $msg .Path }}
+{{ end }}
diff --git a/qdrant-landing/themes/qdrant-2024/layouts/subscribe/list.html b/qdrant-landing/themes/qdrant-2024/layouts/subscribe/list.html
index 0a45136e8..c5868e3a0 100644
--- a/qdrant-landing/themes/qdrant-2024/layouts/subscribe/list.html
+++ b/qdrant-landing/themes/qdrant-2024/layouts/subscribe/list.html
@@ -3,6 +3,7 @@
 {{- partial "head.html" . -}}
 
 <body>
+{{- partial "validate-content.html" . -}}
 {{ partial "site-header" . }}
 {{ partial "subscribe" . }}
 </body>