From 1b1aee5e1f517b9c3ce340847814ee80f6e1a608 Mon Sep 17 00:00:00 2001
From: Dave <shrps@posteo.net>
Date: Wed, 20 Mar 2024 15:15:12 +0100
Subject: [PATCH] update preprocess script and npm run scripts

---
 docs/website/package.json             |  6 +++---
 docs/website/tools/preprocess_docs.js | 21 ++++++++++++++++-----
 2 files changed, 19 insertions(+), 8 deletions(-)

diff --git a/docs/website/package.json b/docs/website/package.json
index dbba604c4c..70bca2d84f 100644
--- a/docs/website/package.json
+++ b/docs/website/package.json
@@ -4,9 +4,9 @@
   "private": true,
   "scripts": {
     "docusaurus": "docusaurus",
-    "start": "node tools/update_version_env.js && concurrently --kill-others \"node tools/preprocess_docs.js --watch\" \"docusaurus start\"",
-    "build": "PYTHONPATH=. poetry run pydoc-markdown && node tools/preprocess_docs.js && node tools/update_version_env.js && docusaurus build",
-    "build:netlify": "PYTHONPATH=. pydoc-markdown && node tools/preprocess_docs.js && node tools/update_version_env.js && docusaurus build --out-dir build/docs",
+    "start": "node tools/update_version_env.js && node tools/preprocess_docs.js && concurrently --kill-others \"node tools/preprocess_docs.js --watch\" \"docusaurus start\"",
+    "build": "node tools/preprocess_docs.js  && PYTHONPATH=. poetry run pydoc-markdown && node tools/update_version_env.js && docusaurus build",
+    "build:netlify": "node tools/preprocess_docs.js && PYTHONPATH=. pydoc-markdown && node tools/update_version_env.js && docusaurus build --out-dir build/docs",
     "swizzle": "docusaurus swizzle",
     "clear": "docusaurus clear",
     "serve": "docusaurus serve",
diff --git a/docs/website/tools/preprocess_docs.js b/docs/website/tools/preprocess_docs.js
index 45e651173b..426ed295ac 100644
--- a/docs/website/tools/preprocess_docs.js
+++ b/docs/website/tools/preprocess_docs.js
@@ -153,15 +153,17 @@ function getSnippet(fileName, snippetName) {
  */
 function insertSnippets(fileName, lines) {
   const result = []
+  let snippetCount = 0;
   for (let line of lines) {
     if (line.includes(SNIPPET_MARKER)) {
       const snippetName = extractMarkerContent(SNIPPET_MARKER, line);
       snippet = getSnippet(fileName, snippetName);
       result.push(...snippet);
+      snippetCount+=1;
     }
     result.push(line);
   }
-  return result;
+  return [snippetCount, result];
 }
 
 
@@ -170,9 +172,10 @@ function insertSnippets(fileName, lines) {
  */
 function insertTubaLinks(lines) {
   const result = []
+  let tubaCount = 0;
   for (let line of lines) {
     if (line.includes(TUBA_MARKER)) {
-      const tubaTag = extractMarkerContent(SNIPPET_MARKER, line);
+      const tubaTag = extractMarkerContent(TUBA_MARKER, line);
       const links = tubaConfig.filter((link) => link.tags.includes(tubaTag));
       if (links.length > 0) {
         result.push("## Additional Setup guides")
@@ -182,10 +185,11 @@ function insertTubaLinks(lines) {
       } else {
         // we could warn here, but it is a bit too verbose
       }
+      tubaCount+=1;
     }
     result.push(line);
   }
-  return result;
+  return [tubaCount, result];
 }
 
 /** 
@@ -203,6 +207,8 @@ function removeRemainingMarkers(lines) {
 function preprocess_docs() {
     console.log("Processing docs...");
     let processedFiles = 0;
+    let insertedSnippets = 0;
+    let processedTubaBlocks = 0;
     for (const fileName of walkSync(MD_SOURCE_DIR)) {
         if (!MOVE_FILES_EXTENSION.includes(path.extname(fileName))) {
             continue
@@ -222,14 +228,19 @@ function preprocess_docs() {
         let lines = fs.readFileSync(fileName, 'utf8').split(/\r?\n/);
 
         // insert stuff
-        lines = insertSnippets(fileName, lines);
-        lines = insertTubaLinks(lines);
+        [snippetCount, lines] = insertSnippets(fileName, lines);
+        insertedSnippets += snippetCount;
+        [tubaCount, lines] = insertTubaLinks(lines);
+        processedTubaBlocks += tubaCount;
         lines = removeRemainingMarkers(lines);
 
         fs.writeFileSync(targetFileName, lines.join("\n"));
         processedFiles += 1;
     }
     console.log(`Processed ${processedFiles} files.`);
+    console.log(`Inserted ${insertedSnippets} snippets.`);
+    console.log(`Processed ${processedTubaBlocks} tuba blocks.`);
+
 }