Integrate AI Resources Page plugin

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",

material-overrides/main.html

@@ -341,33 +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 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);
-
-        // 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\//, ''))}`;
-        }
-
-        // 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}`;
-      };
 
+      /**
+       * 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' });
@@ -388,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' });
@@ -413,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');
           }
         });
       });

mkdocs.yml

@@ -115,6 +115,7 @@ plugins:
       exclude:
         - ai/*
   - awesome-nav
+  - ai_resources_page
   - resolve_md:
       llms_config: llms_config.json
   - page_toggle