Add index page for all Docker Compose labs (#915)

Co-authored-by: Joyce Fee <[email protected]>
Co-authored-by: Michele Cyran <[email protected]>
Co-authored-by: vbotbuildovich <[email protected]>

Author: 4 people

local-antora-playbook.yml

@@ -40,6 +40,15 @@ antora:
   extensions:
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/generate-rp-connect-info'
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/unpublish-pages'
+  - require: '@redpanda-data/docs-extensions-and-macros/extensions/generate-index-data'
+    data:
+      sets:
+        docker_labs:
+          component: redpanda-labs
+          family: page
+          filter: docker-compose
+          env_type: Docker
+          attribute_name: docker-labs-index
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/collect-bloblang-samples'
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/generate-rp-connect-categories'
   - require: '@redpanda-data/docs-extensions-and-macros/extensions/modify-redirects'

modules/ROOT/nav.adoc

@@ -8,6 +8,7 @@
 ** xref:get-started:quickstarts.adoc[Quickstarts]
 *** xref:get-started:quick-start.adoc[Redpanda Self-Managed]
 *** xref:console:quickstart.adoc[Redpanda Console]
+*** xref:get-started:docker-compose-labs.adoc[Docker Compose Labs]
 ** xref:get-started:licensing/index.adoc[Redpanda Licensing]
 *** xref:get-started:licensing/overview.adoc[Editions and Enterprise Features]
 *** xref:get-started:licensing/add-license-redpanda/index.adoc[Add License]

modules/get-started/pages/docker-compose-labs.adoc

@@ -0,0 +1,18 @@
+= Docker Compose Labs
+:page-index-data: docker-labs-index
+:page-role: index-list
+:description: Explore this collection of hands-on labs for deploying and testing Redpanda Self-Managed using Docker Compose. Whether you're a beginner looking to get started or an experienced user aiming to deepen your knowledge, these labs provide step-by-step instructions and practical examples to enhance your skills.
+
+{description}
+
+// This page looks empty because the list of labs isn't hardcoded here.
+// Instead, the `generate-index-data` extension dynamically gathers all Docker Compose labs
+// from the `redpanda-labs` component during the Antora build process.
+// It then assigns the resulting JSON data to the `docker-labs-index` attribute.
+//
+// The UI template checks the `:index-data:` attribute on this page and includes a predefined partial
+// that transforms this JSON data into a rendered list of links and descriptions.
+//
+// As a result, you define the role and index-data attribute here, and the extension/UI
+// handle the rest. This approach keeps the source clean and easy to maintain,
+// even as the number of labs grows or changes over time.