(iceberg-python) branch main updated: Add analytics block on PyIceberg website (#2587)

[fokko]

This is an automated email from the ASF dual-hosted git repository.

fokko pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/iceberg-python.git


The following commit(s) were added to refs/heads/main by this push:
     new 3a9eab3a Add analytics block on PyIceberg website (#2587)
3a9eab3a is described below

commit 3a9eab3a0799c5d10a4ef8ae465e99d774990c52
Author: Alex Stephen <1325798+ramblerap...@users.noreply.github.com>
AuthorDate: Wed Oct 8 00:32:03 2025 -0700

    Add analytics block on PyIceberg website (#2587)
    
    <!--
    Thanks for opening a pull request!
    -->
    
    <!-- In the case this PR will resolve an issue, please replace
    ${GITHUB_ISSUE_ID} below with the actual Github issue id. -->
    Closes #2559
    
    # Rationale for this change
    This adds the same Matomo script tag found in the Iceberg website to our
    Python documentation website.
    
    ## Are these changes tested?
    <img width="1670" height="620" alt="Screenshot 2025-10-06 at 3 53 49 PM"
    
src="https://github.com/user-attachments/assets/18b33bdb-0046-4c11-88da-a006246fab5f";
    />
    
    Script tag found when served locally.
    
    ## Are there any user-facing changes?
    
    <!-- In the case of user-facing changes, please add the changelog label.
    -->
---
 dev/.rat-excludes          |  1 +
 mkdocs/mkdocs.yml          |  1 +
 mkdocs/overrides/main.html | 22 ++++++++++++++++++++++
 3 files changed, 24 insertions(+)

diff --git a/dev/.rat-excludes b/dev/.rat-excludes
index 084c53d2..b4e8bf5e 100644
--- a/dev/.rat-excludes
+++ b/dev/.rat-excludes
@@ -4,3 +4,4 @@ build
 .git
 .gitignore
 poetry.lock
+mkdocs/*
diff --git a/mkdocs/mkdocs.yml b/mkdocs/mkdocs.yml
index 421a923a..b9e92d36 100644
--- a/mkdocs/mkdocs.yml
+++ b/mkdocs/mkdocs.yml
@@ -35,6 +35,7 @@ plugins:
 
 theme:
   name: material
+  custom_dir: overrides
   logo: assets/images/iceberg-logo-icon.png
   favicon: assets/images/iceberg-logo-icon.png
   font:
diff --git a/mkdocs/overrides/main.html b/mkdocs/overrides/main.html
new file mode 100644
index 00000000..1714de6e
--- /dev/null
+++ b/mkdocs/overrides/main.html
@@ -0,0 +1,22 @@
+{% extends "base.html" %}
+
+{% block extrahead %}
+  {{ super() }}
+  <!-- Matomo -->
+  <script>
+    var _paq = window._paq = window._paq || [];
+    /* tracker methods like "setCustomDimension" should be called before 
"trackPageView" */
+    _paq.push(["setDoNotTrack", true]);
+    _paq.push(["disableCookies"]);
+    _paq.push(['trackPageView']);
+    _paq.push(['enableLinkTracking']);
+    (function() {
+      var u="https://analytics.apache.org/";;
+      _paq.push(['setTrackerUrl', u+'matomo.php']);
+      _paq.push(['setSiteId', '82']);
+      var d=document, g=d.createElement('script'), 
s=d.getElementsByTagName('script')[0];
+      g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s);
+    })();
+  </script>
+  <!-- End Matomo -->
+{% endblock %}