@redpanda-data/docs-extensions-and-macros 4.16.1 → 4.16.4

package/extensions/add-llms-directive.js

@@ -50,6 +50,7 @@ module.exports.register = function () {
         let directiveText = directiveMarkdown.replace(/^>\s*/, '')
 
         // Convert markdown links [text](url) to HTML <a> tags
+        // Add space after <a to match afdocs test pattern expectations
         // Add tabindex="-1" and aria-hidden="true" to remove from tab order and hide from assistive tech
         directiveText = directiveText.replace(/\[([^\]]+)\]\(([^)]+)\)/g, '<a href="$2" tabindex="-1" aria-hidden="true">$1</a>')
 

package/extensions/convert-llms-to-txt.js

@@ -607,9 +607,10 @@ function generateNavigationSection(siteUrl, contentCatalog, components) {
 
   // Generate component sitemaps dynamically
   nav += `### Component sitemaps\n\n`;
+  const internalComponents = ['home', 'shared', 'search', 'api'];
   components.forEach(component => {
-    // Skip internal components like 'home'
-    if (component.name === 'home') return;
+    // Skip internal/utility components
+    if (internalComponents.includes(component.name)) return;
     nav += `- [${component.title}](${siteUrl}/sitemap-${component.name}.md)\n`;
   });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@redpanda-data/docs-extensions-and-macros",
-  "version": "4.16.1",
+  "version": "4.16.4",
   "description": "Antora extensions and macros developed for Redpanda documentation.",
   "keywords": [
     "antora",

package/tools/redpanda-connect/helpers/bloblangExample.js

@@ -9,13 +9,15 @@ function bloblangExample(example) {
       let summary = example.summary.trim();
 
       // Convert Markdown headings to AsciiDoc
+      // Cap at H2 level to avoid creating multiple document titles (H1)
       // ##### Heading -> === Heading (H5 -> H3 in AsciiDoc)
       // H3 fits correctly under the H2 "Examples" section
       summary = summary.replace(/^#####\s+(.+)$/gm, '=== $1');
       // #### Heading -> == Heading (H4 -> H2 in AsciiDoc)
       summary = summary.replace(/^####\s+(.+)$/gm, '== $1');
-      // ### Heading -> = Heading (H3 -> H1 in AsciiDoc)
-      summary = summary.replace(/^###\s+(.+)$/gm, '= $1');
+      // ### Heading -> == Heading (H3 -> H2 in AsciiDoc)
+      // Capped at H2 to prevent invalid second document title if H3 appears in summaries
+      summary = summary.replace(/^###\s+(.+)$/gm, '== $1');
 
       // Ensure lead-in ends with a colon (replace period/exclamation/question mark if present)
       if (summary.endsWith('.') || summary.endsWith('!') || summary.endsWith('?')) {