Enable Markdown-format output (#9597)

Author: chalin

.gitmodules

@@ -3,7 +3,7 @@
 	path = themes/docsy
 	url = https://github.com/google/docsy.git
   # cSpell:disable-next-line
-	docsy-pin = v0.14.3-34-g4db086c6
+	docsy-pin = v0.14.3-36-gc0587d9b
 	docsy-note = "2024-04-01 Switching to google/docsy.git from cncf/docsy.git since we don't have any CNCF customizations."
 	docsy-reminder = "Ensure that any tag referenced by `docsy-pin` is present in the remote repo (url), otherwise add (push) the tags to the repo."
 [submodule "content-modules/opentelemetry-specification"]

config/_default/hugo.yaml

@@ -96,8 +96,9 @@ outputFormats:
     notAlternative: true
 
 outputs:
-  home: &home-outputs [HTML, RSS]
-  section: &section-outputs [HTML]
+  home: [HTML, markdown, RSS]
+  page: [HTML, markdown]
+  section: [HTML, markdown]
 
 services:
   rss: { limit: 20 }
@@ -108,16 +109,16 @@ cascade:
 
   # Enable redirects for site root (and not locales)
   - outputs:
-      # This must match the equivalent of [*home-outputs, redirects]
-      [HTML, RSS, redirects]
+      # This must match the equivalent of [outputs.home, redirects]
+      [HTML, markdown, RSS, redirects]
     target:
       kind: home
       sites: { matrix: { languages: [en] } }
 
   # Enable RSS for blog section
   - outputs:
-      # This must match the equivalent of [*section-outputs, RSS]
-      [HTML, RSS]
+      # This must match the equivalent of [outputs.section, RSS]
+      [HTML, markdown, RSS]
     target:
       kind: section
       path: '/blog'

package.json

@@ -103,7 +103,7 @@
     "netlify-build:preview": "npm run seq -- build:preview diff:check",
     "netlify-build:production": "npm run seq -- build:production diff:check",
     "pin:submodule": "npm run _pin:submodule -- $PIN_SKIP",
-    "post_hugo": "echo 'Temporarily rm Docsy favicons until https://github.com/google/docsy/issues/2595 is fixed'; cd public && rm -Rf favicons",
+    "post_hugo": "scripts/strip-hugo-ctx.sh public; echo 'Temporarily rm Docsy favicons until https://github.com/google/docsy/issues/2595 is fixed'; cd public && rm -Rf favicons",
     "postfix:refcache:refresh": "npm run fix:refcache",
     "postfix:submodule": "git submodule",
     "postget:submodule": "git submodule && echo && scripts/update-semconv-mounts.pl",

scripts/strip-hugo-ctx.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+target_dir="${1:-public}"
+
+if [[ ! -d "$target_dir" ]]; then
+  echo "Directory not found: $target_dir"
+  exit 0
+fi
+
+find -L "$target_dir" -type f -name '*.md' -exec perl -i -ne '
+  print unless /^\{\{__hugo_ctx pid=\d+\}\}\s*$/;
+' {} +