From 9d29ac6621ff6768cdc28f0aabd24bc6ff1b6e44 Mon Sep 17 00:00:00 2001
From: Ralf Handl <ralf.handl@sap.com>
Date: Mon, 24 Mar 2025 12:03:25 +0100
Subject: [PATCH 1/2] main: run `respec.yaml` only on changes to relevant files

---
 .github/workflows/respec.yaml | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/respec.yaml b/.github/workflows/respec.yaml
index 0b62909990..71726f06d6 100644
--- a/.github/workflows/respec.yaml
+++ b/.github/workflows/respec.yaml
@@ -8,11 +8,17 @@ name: respec
 # on the gh-pages branch when the corresponding markdown files change.
 #
 
-# run this on push to main
+# run this on push to main for spec-relevant files
 on:
   push:
     branches:
       - main
+    paths:
+      - 'versions/*.md'
+      - 'scripts/md2html/**'
+      - '.github/workflows/respec.yaml'
+      - 'package.json'
+      - 'package-lock.json'
   workflow_dispatch: {}
 
 jobs:

From 84fbf79cedf0eddb1fb5b0e22a45e0fc700bf56e Mon Sep 17 00:00:00 2001
From: Ralf Handl <ralf.handl@gmail.com>
Date: Mon, 24 Mar 2025 23:08:56 +0100
Subject: [PATCH 2/2] Tweak output to make it more stable

---
 scripts/md2html/build.sh | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/scripts/md2html/build.sh b/scripts/md2html/build.sh
index 68bedf9bc6..8bbc4318d7 100755
--- a/scripts/md2html/build.sh
+++ b/scripts/md2html/build.sh
@@ -58,9 +58,11 @@ for specification in $specifications; do
 
   node scripts/md2html/md2html.js --maintainers $maintainers $specification "$allVersions" > $tempfile
   npx respec --no-sandbox --use-local --src $tempfile --out $tempfile2
-  # remove unwanted Google Tag Manager and Google Analytics scripts
+  # remove unwanted Google Tag Manager and Google Analytics scripts, non-deterministic changes, and ReSpec minor version
   sed -e 's/<script type="text\/javascript" async="" src="https:\/\/www.google-analytics.com\/analytics.js"><\/script>//' \
       -e 's/<script type="text\/javascript" async="" src="https:\/\/www.googletagmanager.com\/gtag\/js?id=G-[^"]*"><\/script>//' \
+      -e 's/ toc-inline//' -e 's/ darkmode//' \
+      -e 's/"ReSpec \([0-9]*\)[.0-9]*"/"ReSpec \1"/' \
       $tempfile2 > $destination
 
   echo === Built $destination