fix: enhance Liquid syntax handling in fix-docs.sh script

- Updated the script to HTML-encode Liquid tags within code blocks while preserving original content outside of them.
- Improved the logic for detecting code blocks to ensure accurate processing of Liquid syntax.

Author: mokhld

.github/scripts/docs/fix-docs.sh

@@ -15,19 +15,35 @@ for dir in code-based configuration-based; do
       echo "  Creating lowercase copy: $lowercase"
       cp "$file" "$lowercase"
 
-      # Fix the Liquid templates in both files
+      # Fix the Liquid templates in both files using HTML entities
       for target in "$file" "$lowercase"; do
         # Create a temporary file
         temp_file="${target}.tmp"
         > "$temp_file" # Create empty file
 
-        # Process line by line to properly wrap Liquid tags
+        # Process line by line to HTML-encode Liquid tags
+        in_code_block=false
         while IFS= read -r line; do
-          if [[ "$line" == *"{{"*"}}"* ]]; then
-            # Line contains Liquid syntax, wrap it
-            echo "{% raw %}${line}{% endraw %}" >> "$temp_file"
+          # Check if line starts/ends a code block
+          if [[ "$line" =~ ^\`\`\`.* ]]; then
+            in_code_block=!$in_code_block
+            echo "$line" >> "$temp_file"
+            continue
+          fi
+          
+          if $in_code_block; then
+            # Inside code blocks, replace Liquid syntax with HTML entities
+            # Replace {{ with {{
+            line=$(echo "$line" | sed 's/{{\|{{/\{\{/g')
+            # Replace }} with }}
+            line=$(echo "$line" | sed 's/}}\|}}/\}\}/g')
+            # Replace {% with {%
+            line=$(echo "$line" | sed 's/{%\|{%/\{%/g')
+            # Replace %} with %}
+            line=$(echo "$line" | sed 's/%}\|%}/\%\}/g')
+            echo "$line" >> "$temp_file"
           else
-            # No Liquid syntax, keep as is
+            # Outside code blocks, no encoding (use backticks for inline code)
             echo "$line" >> "$temp_file"
           fi
         done < "$target"