feat(docs): add Matomo analytics to documentation site

Add Matomo tracking to the docs site, matching the portal's setup
(cookies disabled, link tracking enabled, same Matomo Cloud instance).

The tracking script is deployed as a single root-level file (`/matomo.js`)
rather than baked into each versioned build, so the site ID can be
updated without rebuilding existing versions.

> **TODO**: Replace `CHANGEME` in `docs-site/matomo.js` with the actual
> Matomo site ID once IT creates the site for `cli.internetcomputer.org`.

Author: marc0olo

.github/workflows/docs.yml

@@ -88,6 +88,9 @@ jobs:
           # Copy custom domain file
           cp docs-site/public/.well-known/ic-domains root/.well-known/ic-domains
 
+          # Copy Matomo analytics script (site ID defined once here, not per-version)
+          cp docs-site/matomo.js root/matomo.js
+
           # Extract the latest version from versions.json
           LATEST_VERSION=$(jq -r ".versions[] | select(.latest == true) | .version" docs-site/versions.json)
 

docs-site/astro.config.mjs

@@ -52,6 +52,12 @@ export default defineConfig({
             });
           `,
         },
+        // Matomo analytics — loaded from root so the site ID is defined once,
+        // not baked into each versioned build
+        {
+          tag: 'script',
+          attrs: { src: '/matomo.js', async: true },
+        },
       ],
       social: [
         { icon: 'github', label: 'GitHub', href: 'https://github.com/dfinity/icp-cli' },

docs-site/matomo.js

@@ -0,0 +1,15 @@
+var _paq = (window._paq = window._paq || []);
+_paq.push(["disableCookies"]);
+_paq.push(["enableLinkTracking"]);
+_paq.push(["trackPageView"]);
+(function () {
+  var u = "https://internetcomputer.matomo.cloud/";
+  _paq.push(["setTrackerUrl", u + "matomo.php"]);
+  _paq.push(["setSiteId", "CHANGEME"]);
+  var d = document,
+    g = d.createElement("script"),
+    s = d.getElementsByTagName("script")[0];
+  g.async = true;
+  g.src = "//cdn.matomo.cloud/internetcomputer.matomo.cloud/matomo.js";
+  s.parentNode.insertBefore(g, s);
+})();