@redpanda-data/docs-extensions-and-macros 5.2.0 → 5.2.1

package/package.json

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

package/tools/rpk-docs/generate-rpk-docs.js

@@ -1692,13 +1692,18 @@ function formatExamples(text) {
       i++
     } else if (isIndented) {
       // Command line — collect all consecutive command lines into one code block
-      // (stops at a blank line or a comment line)
-      result.push('[,bash]')
-      result.push('----')
+      // (stops at a blank line or a comment line). Dedent by the run's minimum
+      // indent rather than trimming each line, so multi-line commands with
+      // backslash continuations keep their relative indentation.
+      const run = []
       while (i < lines.length && /^\s{2,}\S/.test(lines[i]) && !lines[i].trim().startsWith('#')) {
-        result.push(lines[i].trim())
+        run.push(lines[i])
         i++
       }
+      const minIndent = Math.min(...run.map(l => l.match(/^\s*/)[0].length))
+      result.push('[,bash]')
+      result.push('----')
+      run.forEach(l => result.push(l.slice(minIndent)))
       result.push('----')
     } else if (/^\s*`rpk .+`\s*$/.test(line)) {
       // Inline backticked command on its own line - convert to code block

package/tools/rpk-docs/rpk-docs-handler.js

@@ -14,7 +14,7 @@ const { validateDirectory, formatResults } = require('./validate-output')
 /**
  * Known rpk plugins that are managed separately (have install/uninstall commands)
  */
-const KNOWN_PLUGINS = ['ai', 'check', 'connect', 'oxla']
+const KNOWN_PLUGINS = ['ai', 'check', 'connect', 'k8s', 'oxla']
 
 /**
  * Parse Go version from 'go version' output
@@ -497,6 +497,13 @@ function fetchRpkTreeFromLinuxSource(sourcePath) {
         } else if (stderr.includes('unknown command') || stderr.includes('Error: unknown command')) {
           console.log(`    - ${plugin} is not an installable plugin`)
         } else {
+          // A failed install is non-fatal: generation continues, but this
+          // plugin's commands will be absent from the tree. Expected for `k8s`
+          // during the 26.2 beta window — `rpk k8s install` finds no `latest`
+          // release because the plugin publisher's stableVersionRe only promotes
+          // pure X.Y.Z versions, so k8s commands only appear at GA. A pre-GA
+          // regen that omits `rpk k8s` pages is this, not a generator bug.
+          // See redpanda-data/docs#1801.
           console.warn(`    ✗ Failed to install ${plugin}: ${stderr || stdout}`)
         }
       }