chore: refine documentation generation workflow with liquid tag fixes and layout adjustments

- Enhanced the processing of markdown files to fix Liquid tag issues and ensure proper formatting.
- Updated INDEX.md layout from 'home' to 'default' for consistency across documentation.
- Improved the script to inject front matter and handle markdown links more effectively.

Author: mokhld

.github/workflows/test-docs-generation.yml

@@ -71,20 +71,36 @@ jobs:
           
           # Process INDEX.md - replace .md with .html and add proper front matter
           sed 's/\.md/\.html/g' docs/INDEX.md > site-src/index.md
-          # Make sure front matter is formatted correctly (with empty line after)
           sed -i '1s/^/---\nlayout: default\ntitle: DXT Documentation\n---\n\n/' site-src/index.md
           
-          # Process all other markdown files to fix links
-          find site-src -name "*.md" | while read file; do
-            sed -i 's/\.md/\.html/g' "$file"
-          done
+          # Create a file to hold the problematic lines to fix
+          cat > fix-liquid.sed << EOF
+          # Fix for the specific error in PAGE_EVENTS.md
+          /You have not been awarded any funding for this application/,+1 s/{% endif %}//
+          
+          # Escape all Liquid tags for Jekyll
+          s/{{/\\{{ /g
+          s/}}/\\}} /g
+          s/{%/\\{% /g
+          s/%}/\\%} /g
+          EOF
           
-          # Inject front matter into all markdown files that are missing it
+          # Process all markdown files
           find site-src -name "*.md" | while read file; do
+            # Apply the liquid fixes
+            sed -i -f fix-liquid.sed "$file"
+            
+            # Replace .md with .html in links
+            sed -i 's/\.md/\.html/g' "$file"
+            
+            # Ensure every Markdown file has front matter
             if ! grep -q "^---" "$file"; then
               echo "Injecting front matter into $file"
               sed -i '1s/^/---\nlayout: default\n---\n\n/' "$file"
             fi
+            
+            # Fix any 'layout: home' references
+            sed -i 's/layout: home/layout: default/g' "$file"
           done
           
           # Create Gemfile with exact dependencies
@@ -121,28 +137,16 @@ jobs:
             collections: true
             
           defaults:
-            - scope:
-                path: "schemas"
-                type: "pages"
-              values:
-                layout: default
-            - scope:
-                path: "features"
-                type: "pages"
-              values:
-                layout: default
             - scope:
                 path: ""
                 type: "pages"
               values:
                 layout: default
           EOF
           
-          # Install dependencies using Bundler
+          # Install dependencies and build
           cd site-src
           bundle install
-          
-          # Build the site using Jekyll with bundler
           bundle exec jekyll build --destination ../_site
           cd ..
           

docs/INDEX.md

@@ -1,5 +1,5 @@
 ---
-layout: home
+layout: default
 ---
 
 - [Getting started with DXT](./GETTING_STARTED.md)