From 09b2d43f337baf64f2825eadfe197d3e72c7529c Mon Sep 17 00:00:00 2001
From: Aron T <aront@fourm.info>
Date: Wed, 5 Aug 2026 15:34:16 +0300
Subject: [PATCH] Adopt canonical muted color palette + Inter font for
 Documenter theme

Sourced from math_tech_study/project_resources/docs-assets/custom.css
(new canonical location -- no sub-repo is the source of truth for this
going forward). Replaces Documenter's saturated default link/chevron
blue (#2e63b8/#2E63BD) with the same muted blue-gray family chosen for
the Franklin main site, and switches body/UI text from Lato to Inter
(chosen after live comparison against Lato, Roboto, and Raleway --
pairs well with Raleway on the main site). Deliberately does not touch
JuliaMono code fonts or MathJax-rendered math.
---
 docs/src/assets/custom.css | 72 +++++++++++++++++++++++++++++++++++---
 1 file changed, 67 insertions(+), 5 deletions(-)

diff --git a/docs/src/assets/custom.css b/docs/src/assets/custom.css
index b7dfb3b..3a514da 100644
--- a/docs/src/assets/custom.css
+++ b/docs/src/assets/custom.css
@@ -1,5 +1,27 @@
 /* Custom styles for cross-site navigation and branding */
 
+@import url('https://fonts.googleapis.com/css?family=Inter:400,500,700');
+
+/* ============================================================
+ * FourM font override
+ *
+ * Inter, chosen 2026-08-04 after live comparison against
+ * Documenter's native default (Lato), Roboto, and Raleway (used
+ * on the Franklin main site) -- pairs well with Raleway there.
+ *
+ * Scoped to body/UI text only -- deliberately does NOT touch:
+ *   - .is-family-monospace / .is-family-code (JuliaMono stack)
+ *     -- changing this would make code unreadable/misaligned.
+ *   - MathJax-rendered math (mjx-container etc.) -- MathJax3
+ *     renders its own fonts independent of page CSS, and
+ *     Documenter's headings don't set their own font-family
+ *     (they inherit from body), so this one override is
+ *     sufficient without a separate heading rule.
+ * ============================================================ */
+body, button, input, optgroup, select, textarea {
+    font-family: 'Inter', -apple-system, BlinkMacSystemFont, "Segoe UI", "Helvetica Neue", "Helvetica", "Arial", sans-serif;
+}
+
 /* Site navigation footer styling */
 .site-navigation {
     margin-top: 2rem;
@@ -52,15 +74,15 @@
         background-color: #2b2b2b;
         border-color: #404040;
     }
-    
+
     .site-navigation h4 {
         color: #ffffff;
     }
-    
+
     .site-navigation ul li a {
         color: #58a6ff;
     }
-    
+
     .site-navigation ul li a:hover {
         color: #79c0ff;
     }
@@ -71,11 +93,11 @@
     .site-navigation {
         padding: 1rem;
     }
-    
+
     .site-navigation h4 {
         font-size: 0.9rem;
     }
-    
+
     .site-navigation ul li a {
         font-size: 0.85rem;
     }
@@ -98,3 +120,43 @@ html[data-theme="dark"] .site-navigation ul li a {
 html[data-theme="dark"] .site-navigation ul li a:hover {
     color: var(--documenter-dark-link-hover);
 }
+
+/* ============================================================
+ * FourM muted color palette override
+ *
+ * Documenter's default light theme's global link color
+ * (a{color:#2e63b8}) is a saturated blue that reads as "neon"
+ * against the site's grays. Replaces it with the same muted
+ * blue-gray family chosen for the Franklin main site's sidebar
+ * (see math_tech_study/_css/documenter-theme-alignment.css and
+ * desktop-sidebar.css) for whole-domain visual consistency.
+ *
+ * Scope is intentionally narrow: Documenter's headings, sidebar
+ * active-state, and docstring badges are already muted in the
+ * shipped theme and don't need touching -- only the base anchor
+ * color (and the two other selectors below that reuse it) do.
+ * ============================================================ */
+a {
+    color: #4a6b85;
+}
+
+a:hover {
+    color: #2c3e50;
+}
+
+.outdated-warning-overlay a {
+    color: #4a6b85;
+}
+
+#documenter .docs-sidebar form.docs-search > input.is-active {
+    border-color: #4a6b85;
+    box-shadow: 0 0 0 0.125em rgba(74, 107, 133, 0.25);
+}
+
+details.docstring > summary::before {
+    color: #4a6b85;
+}
+
+.content a code {
+    color: #4a6b85;
+}