From 8583989f603a22e5730ef2448d5d6a0538491971 Mon Sep 17 00:00:00 2001
From: DAWN KELLY <dawnkelly09@gmail.com>
Date: Fri, 6 Feb 2026 11:12:46 -0800
Subject: [PATCH 1/2] changes to support addition of ai resources plugin

---
 llms_config.json             | 29 +++++++++++++++++++++++++++++
 material-overrides/main.html | 22 ++++++----------------
 mkdocs.yml                   |  1 +
 3 files changed, 36 insertions(+), 16 deletions(-)

diff --git a/llms_config.json b/llms_config.json
index d2e6f05e..9c7b7190 100644
--- a/llms_config.json
+++ b/llms_config.json
@@ -31,6 +31,35 @@
             "Tooling",
             "Reference"
         ],
+        "categories_info": {
+            "Basics": {
+                "description": "Polkadot general knowledge base to provide context around overview and beginner-level content."
+            },
+            "Reference": {
+                "description": "Reference material including key functions and glossary."
+            },
+            "Smart Contracts": {
+                "description": "How to develop and deploy Solidity smart contracts on Polkadot Hub."
+            },
+            "Parachains": {
+                "description": "How-to guides related to building, customizing, deploying, and maintaining a parachain."
+            },
+            "dApps": {
+                "description": "Information and tutorials for application developers."
+            },
+            "Networks": {
+                "description": "Information about Polkadot networks."
+            },
+            "Polkadot Protocol": {
+                "description": "In-depth details about the Polkadot Protocol."
+            },
+            "Infrastructure": {
+                "description": "Guide to node infrastructure."
+            },
+            "Tooling": {
+                "description": "Developer tooling resources."
+            }
+        },
         "exclusions": {
             "skip_basenames": [
                 "README.md",
diff --git a/material-overrides/main.html b/material-overrides/main.html
index 939b3789..d564e6ab 100644
--- a/material-overrides/main.html
+++ b/material-overrides/main.html
@@ -345,27 +345,17 @@
       const SITE_BASE = location.origin.replace(/\/+$/, ''); // current host
       const AI_BASE = '/ai'; // relative path to AI content on same host
 
-      const stripLeading = (value) => value.replace(/^\/+/, '');
-
       const toAbsolute = (rawPath) => {
         if (!rawPath) return null;
-        const dataPath = rawPath.trim();
-        if (/^https?:\/\//i.test(dataPath)) return dataPath; // already absolute
-
-        const normalized = stripLeading(dataPath);
+        let dataPath = rawPath.trim();
+        if (/^https?:\/\//i.test(dataPath)) return dataPath; 
 
-        // All AI content is served from the AI_BASE on the current host
-        if (normalized.startsWith('ai/')) {
-          return `${SITE_BASE}${AI_BASE}/${stripLeading(normalized.replace(/^ai\//, ''))}`;
+        // Ensure leading slash for site-absolute paths
+        if (!dataPath.startsWith('/')) {
+            dataPath = '/' + dataPath;
         }
 
-        // NOTE: same-origin assets: default for everything we ship in docs/ (llms, ai bundles, etc.)
-        // llms.txt is served from the site root; other AI artifacts live under /ai
-        if (normalized === 'llms.txt') return `${SITE_BASE}/${normalized}`;  
-        if (dataPath.startsWith('/')) return `${SITE_BASE}/${stripLeading(dataPath)}`;
-
-        // Fallback → site-relative
-        return `${SITE_BASE}/${normalized}`;
+        return `${SITE_BASE}${dataPath}`;
       };
 
       const downloadViaFetch = async (url, filename) => {
diff --git a/mkdocs.yml b/mkdocs.yml
index bbb7f82f..06261f04 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -115,6 +115,7 @@ plugins:
       exclude:
         - ai/*
   - awesome-nav
+  - ai_resources_page
   - resolve_md:
       llms_config: llms_config.json
   - page_toggle

From 4ccc64fd0c383a571d925dfb17256115b637094f Mon Sep 17 00:00:00 2001
From: DAWN KELLY <dawnkelly09@gmail.com>
Date: Fri, 6 Feb 2026 12:25:09 -0800
Subject: [PATCH 2/2] refactor main.html to remove anything now handled by
 plugin

---
 material-overrides/main.html | 68 ++++++++++++++++++------------------
 1 file changed, 34 insertions(+), 34 deletions(-)

diff --git a/material-overrides/main.html b/material-overrides/main.html
index d564e6ab..ce526dcf 100644
--- a/material-overrides/main.html
+++ b/material-overrides/main.html
@@ -341,23 +341,21 @@
     });
   </script>
   <script>
+    /**
+     * AI Resources Page Interactivity
+     * 
+     * Purpose: Handle client-side interactivity (Download, Clipboard) that cannot be performed 
+     * by the static HTML generator plugin (ai_resources_page).
+     * 
+     * The plugin generates the HTML structure with `data-path` attributes to ensure 
+     * correct paths. This script consumes those paths to invoke browser APIs.
+     */
     document.addEventListener('DOMContentLoaded', () => {
-      const SITE_BASE = location.origin.replace(/\/+$/, ''); // current host
-      const AI_BASE = '/ai'; // relative path to AI content on same host
-
-      const toAbsolute = (rawPath) => {
-        if (!rawPath) return null;
-        let dataPath = rawPath.trim();
-        if (/^https?:\/\//i.test(dataPath)) return dataPath; 
-
-        // Ensure leading slash for site-absolute paths
-        if (!dataPath.startsWith('/')) {
-            dataPath = '/' + dataPath;
-        }
-
-        return `${SITE_BASE}${dataPath}`;
-      };
 
+      /**
+       * Justification: Standard HTML <a download> tags often open text/markdown files 
+       * in the browser instead of saving them. Fetching as a Blob forces a true "Save As" behavior.
+       */
       const downloadViaFetch = async (url, filename) => {
         try {
           const res = await fetch(url, { credentials: 'omit' });
@@ -378,6 +376,10 @@
         }
       };
 
+      /**
+       * Justification: Static HTML cannot access the user's system clipboard. 
+       * We must fetch the content client-side and use the navigator API to copy it.
+       */
       const copyTextFromUrl = async (url) => {
         try {
           const res = await fetch(url, { credentials: 'omit' });
@@ -403,46 +405,44 @@
       document.querySelectorAll('.llms-copy').forEach((btn) => {
         btn.addEventListener('click', (e) => {
           e.preventDefault();
-          const url = toAbsolute(btn.getAttribute('data-path'));
+          // Plugin generates the correct absolute path in data-path
+          const url = btn.getAttribute('data-path');
           if (url) copyTextFromUrl(url);
         });
       });
 
       // DOWNLOAD buttons: force a real download via Blob
       document.querySelectorAll('.llms-dl').forEach((a) => {
-        // Set href for right-click "Copy link address" convenience
-        const abs = toAbsolute(a.getAttribute('data-path'));
-        if (abs) a.setAttribute('href', abs);
+        // Plugin generates the correct absolute path in data-path
+        const url = a.getAttribute('data-path');
+        if (url) a.setAttribute('href', url);
 
         a.addEventListener('click', (e) => {
           e.preventDefault();
-          const path = a.getAttribute('data-path') || '';
-          const url = toAbsolute(path);
-          if (!url) return;
-          // Prefer explicit filename; else derive from last path segment
-          const filename =
-            a.getAttribute('data-filename') ||
-            path.split('/').pop() ||
-            'download.txt';
-          downloadViaFetch(url, filename);
+          const path = a.getAttribute('data-path');
+          if (!path) return;
+          
+          // Plugin provides the clean filename for saving
+          const filename = a.getAttribute('data-filename') || 'download.txt';
+          downloadViaFetch(path, filename);
         });
       });
 
       // VIEW buttons: open raw files in a new tab
       document.querySelectorAll('.llms-view').forEach((a) => {
-        const abs = toAbsolute(a.getAttribute('data-path'));
-        if (abs) {
-          a.setAttribute('href', abs);
+        const url = a.getAttribute('data-path');
+        if (url) {
+          a.setAttribute('href', url);
           a.setAttribute('target', '_blank');
           a.setAttribute('rel', 'noopener');
         }
 
         a.addEventListener('click', (e) => {
-          const url = toAbsolute(a.getAttribute('data-path') || '');
-          if (!url) return;
+          const path = a.getAttribute('data-path');
+          if (!path) return;
           if (a.getAttribute('target') !== '_blank') {
             e.preventDefault();
-            window.open(url, '_blank', 'noopener');
+            window.open(path, '_blank', 'noopener');
           }
         });
       });