From 9205d986cd67013eb378c7e6d7dda8441a6fb5a3 Mon Sep 17 00:00:00 2001
From: Ammaar Reshi <159876365+ammaarreshi@users.noreply.github.com>
Date: Fri, 16 Oct 2026 16:49:17 +0000
Subject: [PATCH] Cache-bust extra_css/extra_javascript URLs and add intrinsic
 SVG dimensions

---
 overrides/home.html  |  6 +++---
 scripts/lint_docs.py |  2 +-
 zensical.toml        | 30 +++++++++++++++---------------
 3 files changed, 19 insertions(+), 19 deletions(-)

diff --git a/overrides/home.html b/overrides/home.html
index 2e1c37e..0e314a3 100644
--- a/overrides/home.html
+++ b/overrides/home.html
@@ -26,7 +26,7 @@ <h1 class="gemma-title">Gemma</h1>
 
     <div class="gemma-hero-search" id="gemma-hero-search">
       <div class="gemma-hero-search__bar">
-        <svg class="gemma-hero-search__icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
+        <svg class="gemma-hero-search__icon" width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
           <circle cx="11" cy="11" r="8"></circle>
           <path d="m21 21-4.3-4.3"></path>
         </svg>
@@ -47,13 +47,13 @@ <h1 class="gemma-title">Gemma</h1>
   <div class="gemma-actions" role="group" aria-label="Primary actions">
     <a class="gemma-btn gemma-btn--primary" href="get-started/">
       <span>Get started</span>
-      <svg class="gemma-btn__icon gemma-btn__icon--slide" viewBox="0 0 16 16" fill="none" aria-hidden="true">
+      <svg class="gemma-btn__icon gemma-btn__icon--slide" width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true">
         <path d="M3.25 8H12.75M12.75 8L8.5 3.75M12.75 8L8.5 12.25" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"/>
       </svg>
     </a>
     <a class="gemma-btn gemma-btn--glass" href="https://aistudio.google.com/prompts/new_chat?model=gemma-4-31b-it" target="_blank" rel="noopener">
       <span>Try in Google AI Studio</span>
-      <svg class="gemma-btn__icon gemma-btn__icon--pop" viewBox="0 0 16 16" fill="none" aria-hidden="true">
+      <svg class="gemma-btn__icon gemma-btn__icon--pop" width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true">
         <path d="M4.5 11.5L11.5 4.5M11.5 4.5H5.75M11.5 4.5V10.25" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
       </svg>
     </a>
diff --git a/scripts/lint_docs.py b/scripts/lint_docs.py
index 0478a5c..b9ade15 100644
--- a/scripts/lint_docs.py
+++ b/scripts/lint_docs.py
@@ -696,7 +696,7 @@ def check_css(ctx: Context) -> Iterable[Finding]:
         return
 
     registered = {
-        Path(entry).name
+        Path(entry.split("?", 1)[0]).name
         for entry in ctx.config.get("project", {}).get("extra_css", [])
     }
 
diff --git a/zensical.toml b/zensical.toml
index 311bd08..caf4b87 100644
--- a/zensical.toml
+++ b/zensical.toml
@@ -14,24 +14,24 @@ Copyright &copy; 2026 Google DeepMind
 """
 # Order matters: the token layer must load first, motion last.
 extra_css = [
-  "stylesheets/gemma.css",       # tokens: palette, spacing, radius, shadow
-  "stylesheets/layout.css",      # page grid, sidebars, typography scale
-  "stylesheets/nav.css",         # header, tabs, sidebar, table of contents
-  "stylesheets/content.css",     # tables, admonitions, code, tabs
-  "stylesheets/components.css",  # cards, badges, figures, steps, embeds
-  "stylesheets/icons.css",       # inlined icon-set SVGs and card icons
-  "stylesheets/engine-grid.css", # quickstart: the "run it with" engine grid
-  "stylesheets/model-tree.css",  # models overview: the family lineage tree
-  "stylesheets/embeds.css",      # external interactive demos
-  "stylesheets/page-context.css",# the applicability bar above every H1
-  "stylesheets/tokens.css",      # chat-token badges
-  "stylesheets/home.css",        # landing page: chrome, backdrop, hero
-  "stylesheets/motion.css",      # transitions + reduced-motion opt-out
+  "stylesheets/gemma.css?v=2",       # tokens: palette, spacing, radius, shadow
+  "stylesheets/layout.css?v=2",      # page grid, sidebars, typography scale
+  "stylesheets/nav.css?v=2",         # header, tabs, sidebar, table of contents
+  "stylesheets/content.css?v=2",     # tables, admonitions, code, tabs
+  "stylesheets/components.css?v=2",  # cards, badges, figures, steps, embeds
+  "stylesheets/icons.css?v=2",       # inlined icon-set SVGs and card icons
+  "stylesheets/engine-grid.css?v=2", # quickstart: the "run it with" engine grid
+  "stylesheets/model-tree.css?v=2",  # models overview: the family lineage tree
+  "stylesheets/embeds.css?v=2",      # external interactive demos
+  "stylesheets/page-context.css?v=2",# the applicability bar above every H1
+  "stylesheets/tokens.css?v=2",      # chat-token badges
+  "stylesheets/home.css?v=2",        # landing page: chrome, backdrop, hero
+  "stylesheets/motion.css?v=2",      # transitions + reduced-motion opt-out
 ]
 # Order matters: the generated data must load before the switcher that reads it.
 extra_javascript = [
-  "javascripts/model-data.js",     # GENERATED from data/models.yml -- do not edit
-  "javascripts/model-switcher.js", # page context strip selector + code rewriting
+  "javascripts/model-data.js?v=2",     # GENERATED from data/models.yml -- do not edit
+  "javascripts/model-switcher.js?v=2", # page context strip selector + code rewriting
   "javascripts/mathjax.js",
   "https://unpkg.com/mathjax@3/es5/tex-mml-chtml.js",
 ]