admonition transform

Author: TJTheCoder

driver-ci

@@ -38,16 +38,29 @@ TUTORIAL_DST="$DOCS_SOURCE_DIR/tutorial.md"
     done < "$TUTORIAL_SRC"
 } > "$TUTORIAL_DST"
 
-# === Copy and transform README.md into index.md ===
+# === Copy and transform README.md into index.md (with admonition fix) ===
 README_SRC="$TMP_DIR/amago-crr_k/README.md"
 INDEX_DST="$DOCS_SOURCE_DIR/index.md"
 
 {
     found_title=false
     while IFS= read -r line; do
+        # Rewrite title to "# Home"
         if ! $found_title && [[ "$line" =~ ^# ]]; then
             echo "# Home"
             found_title=true
+            continue
+        fi
+
+        # Replace GitHub-style admonitions with MyST blocks
+        if [[ "$line" =~ ^\[!TIP\] ]]; then
+            echo '```{tip}'
+            echo "${line/\[!TIP\]/}" | sed 's/^ *\*NOTE*[:]* *//'
+            echo '```'
+        elif [[ "$line" =~ ^\[!WARNING\] ]]; then
+            echo '```{warning}'
+            echo "${line/\[!WARNING\]/}" | sed 's/^ *//'
+            echo '```'
         else
             echo "$line"
         fi