From 392ad911cd0f245bb15b664732af9e959d544f1c Mon Sep 17 00:00:00 2001 From: Kat Batuigas Date: Tue, 26 May 2026 11:43:12 -0700 Subject: [PATCH 1/2] chore: bump docs-extensions-and-macros to v5 and wire new extensions Add conditional-home-redirect and unified-navigation extensions, and extend docs-site start_paths with data-platform and self-managed. Co-Authored-By: Claude Opus 4.7 (1M context) --- local-antora-playbook.yml | 8 +++++++- package-lock.json | 8 ++++---- package.json | 2 +- 3 files changed, 12 insertions(+), 6 deletions(-) diff --git a/local-antora-playbook.yml b/local-antora-playbook.yml index fe2fe8c63b..c20a7567cd 100644 --- a/local-antora-playbook.yml +++ b/local-antora-playbook.yml @@ -26,7 +26,7 @@ content: branches: main - url: https://github.com/redpanda-data/docs-site branches: 'main' - start_paths: [home] + start_paths: [home, data-platform, self-managed] ui: bundle: url: https://github.com/redpanda-data/docs-ui/releases/latest/download/ui-bundle.zip @@ -42,6 +42,12 @@ asciidoc: - '@redpanda-data/docs-extensions-and-macros/asciidoc-extensions/add-line-numbers-highlights' antora: extensions: + # Conditional home page redirect when agentic-data-plane component doesn't exist + - require: '@redpanda-data/docs-extensions-and-macros/extensions/conditional-home-redirect' + # Unified navigation extension (config-driven) + # Components with page-navigation attribute use that config + # Components without page-navigation use standard Antora navigation + - require: '@redpanda-data/docs-extensions-and-macros/extensions/unified-navigation' - 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/add-global-attributes' diff --git a/package-lock.json b/package-lock.json index 5d15501510..06f6cdd864 100644 --- a/package-lock.json +++ b/package-lock.json @@ -12,7 +12,7 @@ "@antora/cli": "3.1.2", "@antora/site-generator": "3.1.2", "@asciidoctor/tabs": "^1.0.0-beta.5", - "@redpanda-data/docs-extensions-and-macros": "^4.0.0", + "@redpanda-data/docs-extensions-and-macros": "^5.0.0", "@sntke/antora-mermaid-extension": "^0.0.6" }, "devDependencies": { @@ -2691,9 +2691,9 @@ "license": "MIT" }, "node_modules/@redpanda-data/docs-extensions-and-macros": { - "version": "4.17.0", - "resolved": "https://registry.npmjs.org/@redpanda-data/docs-extensions-and-macros/-/docs-extensions-and-macros-4.17.0.tgz", - "integrity": "sha512-RCcgwoIuuVUuNtqdMFxAWuq7T2yG7pFsW1J1T8iKhLFqZMSThPHaM0lr6rJ5NPKYVZhQRbcx7K5x/V5iRhc7Ow==", + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/@redpanda-data/docs-extensions-and-macros/-/docs-extensions-and-macros-5.0.0.tgz", + "integrity": "sha512-39rjNtv1oiHl/5vPYbkMwG+X6MYCc20868sfg4/Z5+WmcT0YcIuDtig/+CmbMHBmvuucRrUClk6DBYAtsUXoYQ==", "license": "ISC", "dependencies": { "@asciidoctor/tabs": "^1.0.0-beta.6", diff --git a/package.json b/package.json index 846b057656..d386c7aaeb 100644 --- a/package.json +++ b/package.json @@ -17,7 +17,7 @@ "@antora/cli": "3.1.2", "@antora/site-generator": "3.1.2", "@asciidoctor/tabs": "^1.0.0-beta.5", - "@redpanda-data/docs-extensions-and-macros": "^4.0.0", + "@redpanda-data/docs-extensions-and-macros": "^5.0.0", "@sntke/antora-mermaid-extension": "^0.0.6" }, "devDependencies": { From 32f3ddb32f9c8c37b856f7d35c1dea6628cb81cb Mon Sep 17 00:00:00 2001 From: micheleRP Date: Tue, 26 May 2026 15:37:00 -0600 Subject: [PATCH 2/2] chore: update local playbook component references for renames Align with the component renames already on main: ROOT -> streaming and redpanda-labs -> labs. Updates start_page, docker_labs.component, archive-attachments, and replace-attributes-in-attachments so local builds match the production playbook on docs-site. Co-Authored-By: Claude Opus 4.7 (1M context) --- local-antora-playbook.yml | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/local-antora-playbook.yml b/local-antora-playbook.yml index c20a7567cd..82a76c6d31 100644 --- a/local-antora-playbook.yml +++ b/local-antora-playbook.yml @@ -1,6 +1,6 @@ site: title: Redpanda Docs - start_page: ROOT:get-started:intro-to-events.adoc + start_page: streaming:get-started:intro-to-events.adoc url: http://localhost:5002 robots: disallow keys: @@ -58,7 +58,7 @@ antora: data: sets: docker_labs: - component: redpanda-labs + component: labs family: page filter: docker-compose env_type: Docker @@ -66,7 +66,7 @@ antora: - require: '@redpanda-data/docs-extensions-and-macros/extensions/archive-attachments' data: archives: - - component: 'ROOT' + - component: 'streaming' output_archive: 'redpanda-quickstart.tar.gz' file_patterns: - '**/test-resources/**/docker-compose/**' @@ -74,8 +74,8 @@ antora: data: replacements: - components: - - 'ROOT' - - 'redpanda-labs' + - 'streaming' + - 'labs' file_patterns: - '**/docker-compose.yaml' - '**/docker-compose.yml'