docs: streamline Jekyll configuration and link management

- Replaced inline JavaScript for fixing links with a separate file for better maintainability.
- Updated the create-jekyll-config.sh script to copy the link-fixer JavaScript instead of generating it inline.
- Removed outdated link adjustments from fix-docs.sh to simplify the documentation processing.
- Added `nav_exclude: true` to schemas/index.md and set `toc: false` in the schema reference for improved navigation control.

Author: mokhld

.github/scripts/docs/assets/fix-links.js

@@ -0,0 +1,13 @@
+document.addEventListener('DOMContentLoaded', function () {
+  // Fix all links that should have the baseurl
+  document.querySelectorAll('a[href^="/"]').forEach(function (link) {
+    if (
+      !link.href.includes('/forms-engine-plugin') &&
+      !link.href.match(/^https?:\/\//) &&
+      !link.getAttribute('href').startsWith('/forms-engine-plugin')
+    ) {
+      const href = link.getAttribute('href')
+      link.href = '/forms-engine-plugin' + href
+    }
+  })
+})

.github/scripts/docs/create-jekyll-config.sh

@@ -152,22 +152,9 @@ keep_files:
   - assets
 EOF
 
-# Add Javascript to fix any remaining links
-echo "📝 Creating link-fixer JavaScript..."
+echo "📝 Copying link-fixer JavaScript..."
 mkdir -p site-src/assets/js
-cat > site-src/assets/js/fix-links.js << 'EOF'
-document.addEventListener('DOMContentLoaded', function() {
-  // Fix all links that should have the baseurl
-  document.querySelectorAll('a[href^="/"]').forEach(function(link) {
-    if (!link.href.includes('/forms-engine-plugin') &&
-        !link.href.match(/^https?:\/\//) &&
-        !link.getAttribute('href').startsWith('/forms-engine-plugin')) {
-      const href = link.getAttribute('href');
-      link.href = '/forms-engine-plugin' + href;
-    }
-  });
-});
-EOF
+cp .github/scripts/docs/assets/js/fix-links.js site-src/assets/js/
 
 # Create custom includes directory to add baseurl meta tag
 mkdir -p site-src/_includes

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

@@ -138,18 +138,6 @@ for dir in code-based configuration-based; do
     }
     ' "$file" > "$temp_file"
 
-    if [[ "$file" == "PAGE_VIEWS.md" ]]; then
-      sed "${SED_INPLACE[@]}" 's|\(see our guidance on page events\)(\.\./configuration-based/PAGE_EVENTS.md)|\1(/features/configuration-based/PAGE_EVENTS)|g' "$temp_file"
-      sed "${SED_INPLACE[@]}" 's|\[plugin option\](/forms-engine-plugin/https://|[plugin option](https://|g' "$temp_file"
-    fi
-
-    if [[ "$file" == "PAGE_TEMPLATES.md" ]]; then
-      sed "${SED_INPLACE[@]}" 's|\[PLUGIN_OPTIONS.md\](../../PLUGIN_OPTIONS.md#custom-filters)|\[Plugin Options](/PLUGIN_OPTIONS#custom-filters)|g' "$temp_file"
-    fi
-
-    sed "${SED_INPLACE[@]}" 's|/forms-engine-plugin/forms-engine-plugin/|/forms-engine-plugin/|g' "$temp_file"
-    sed "${SED_INPLACE[@]}" 's|/forms-engine-plugin/https://|https://|g' "$temp_file"
-
     lowercase_file=$(echo "$file" | tr '[:upper:]' '[:lower:]')
     if [ "$file" != "$lowercase_file" ]; then
       echo "  Creating lowercase copy: $lowercase_file"

.github/scripts/docs/process-docs.sh

@@ -226,13 +226,6 @@ EOF
 
     echo "✅ Updated SCHEMA_REFERENCE.md with full schema listing"
   fi
-
-  # Set schemas/index.md to be excluded from navigation
-  if [ -f "$BASE_DIR/schemas/index.md" ]; then
-    echo "  Updating schemas/index.md to be excluded from navigation"
-    sed "${SED_INPLACE[@]}" '/^---/a\
-nav_exclude: true' "$BASE_DIR/schemas/index.md"
-  fi
 fi
 
 # Check for features directory before processing

docs/features/index.md

@@ -7,6 +7,3 @@ permalink: /features/
 ---
 
 # DXT Features
-
-- [Configuration-based Features](configuration-based/)
-- [Code-based Features](code-based/)

scripts/generate-schema-docs.js

@@ -194,6 +194,8 @@ title: Schema Reference
 nav_order: 5
 has_children: true
 permalink: /schemas/
+nav_exclude: true
+toc: false
 ---
 
 # Defra Forms Model Schema Reference