From d995ad9ef2db383a7b8d25f9c2ebf4e77d4d8dde Mon Sep 17 00:00:00 2001 From: "Vincent D. Warmerdam" Date: Fri, 1 May 2026 18:00:32 +0200 Subject: [PATCH 1/5] Add LLM markdown banner to reference pages Each /reference// page now shows a "Feeding an LLM?" banner near the top that links to the matching .md endpoint, so users notice the markdown version exists without having to hunt through the gallery. --- mkdocs/assets/stylesheets/extra.css | 51 +++++++++++++++++++++++++++++ mkdocs/overrides/main.html | 15 +++++++++ 2 files changed, 66 insertions(+) diff --git a/mkdocs/assets/stylesheets/extra.css b/mkdocs/assets/stylesheets/extra.css index 3981492d..3caa4e69 100644 --- a/mkdocs/assets/stylesheets/extra.css +++ b/mkdocs/assets/stylesheets/extra.css @@ -272,6 +272,57 @@ border: 0; } +/* —————————————————————————————————————————— + LLM markdown banner (top of reference pages) + —————————————————————————————————————————— */ +.llm-md-banner { + display: flex; + align-items: center; + gap: 0.75rem; + padding: 0.75rem 1rem; + margin: 0 0 1.5rem; + border: 1px solid var(--wiggly-border); + border-radius: 8px; + background: var(--wiggly-card-bg); + box-shadow: var(--wiggly-card-shadow); + text-decoration: none; + color: inherit; + font-size: 0.85rem; + transition: border-color 120ms ease, transform 120ms ease; +} + +.llm-md-banner:hover { + border-color: var(--wiggly-molab); + transform: translateY(-1px); +} + +.llm-md-banner__icon { + font-size: 1.25rem; + line-height: 1; +} + +.llm-md-banner__text { + flex: 1; + line-height: 1.4; +} + +.llm-md-banner__text code { + background: rgba(0, 0, 0, 0.05); + padding: 0.05rem 0.3rem; + border-radius: 3px; + font-size: 0.8rem; +} + +[data-md-color-scheme="slate"] .llm-md-banner__text code { + background: rgba(255, 255, 255, 0.08); +} + +.llm-md-banner__arrow { + color: var(--wiggly-molab); + font-weight: 700; + font-size: 1.1rem; +} + /* —————————————————————————————————————————— Small-screen adjustments —————————————————————————————————————————— */ diff --git a/mkdocs/overrides/main.html b/mkdocs/overrides/main.html index dfa7a5d3..8a3e2fbc 100644 --- a/mkdocs/overrides/main.html +++ b/mkdocs/overrides/main.html @@ -8,3 +8,18 @@ plausible.init() {% endblock %} + +{% block content %} + {% if page and "reference/" in page.url and page.url != "reference/" %} + {% set slug = page.url | replace("reference/", "") | replace("/", "") %} + + 📄 + + Feeding an LLM? + Grab this page as raw markdown — drop the .md URL into your prompt. + + → + + {% endif %} + {% include "partials/content.html" %} +{% endblock %} From bd2d8c372e7464647a9b0dc0890ee71b516571f9 Mon Sep 17 00:00:00 2001 From: "Vincent D. Warmerdam" Date: Fri, 1 May 2026 18:01:01 +0200 Subject: [PATCH 2/5] Call them clankers --- mkdocs/overrides/main.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/mkdocs/overrides/main.html b/mkdocs/overrides/main.html index 8a3e2fbc..1adfa774 100644 --- a/mkdocs/overrides/main.html +++ b/mkdocs/overrides/main.html @@ -15,7 +15,7 @@ 📄 - Feeding an LLM? + Feeding a clanker? Grab this page as raw markdown — drop the .md URL into your prompt. → From f9028ab2a8561baa8ea9c1414a96b944495b148d Mon Sep 17 00:00:00 2001 From: "Vincent D. Warmerdam" Date: Fri, 1 May 2026 18:02:59 +0200 Subject: [PATCH 3/5] Slim the clanker banner to a pill --- mkdocs/assets/stylesheets/extra.css | 42 ++++++++++++++--------------- 1 file changed, 21 insertions(+), 21 deletions(-) diff --git a/mkdocs/assets/stylesheets/extra.css b/mkdocs/assets/stylesheets/extra.css index 3caa4e69..df17574a 100644 --- a/mkdocs/assets/stylesheets/extra.css +++ b/mkdocs/assets/stylesheets/extra.css @@ -273,44 +273,44 @@ } /* —————————————————————————————————————————— - LLM markdown banner (top of reference pages) + LLM markdown pill (top of reference pages) —————————————————————————————————————————— */ .llm-md-banner { - display: flex; + display: inline-flex; align-items: center; - gap: 0.75rem; - padding: 0.75rem 1rem; + gap: 0.4rem; + padding: 0.3rem 0.65rem; margin: 0 0 1.5rem; border: 1px solid var(--wiggly-border); - border-radius: 8px; - background: var(--wiggly-card-bg); - box-shadow: var(--wiggly-card-shadow); + border-radius: 999px; + background: var(--wiggly-btn-bg); + color: var(--md-primary-fg-color); text-decoration: none; - color: inherit; - font-size: 0.85rem; - transition: border-color 120ms ease, transform 120ms ease; + font-size: 0.72rem; + line-height: 1.3; + transition: background-color 0.15s ease, border-color 0.15s ease; } .llm-md-banner:hover { - border-color: var(--wiggly-molab); - transform: translateY(-1px); + background: var(--wiggly-btn-bg-hover); + border-color: var(--wiggly-border-hover); } .llm-md-banner__icon { - font-size: 1.25rem; + font-size: 0.85rem; line-height: 1; } -.llm-md-banner__text { - flex: 1; - line-height: 1.4; +.llm-md-banner__text strong { + font-weight: 700; + margin-right: 0.15rem; } .llm-md-banner__text code { - background: rgba(0, 0, 0, 0.05); - padding: 0.05rem 0.3rem; - border-radius: 3px; - font-size: 0.8rem; + background: rgba(0, 0, 0, 0.06); + padding: 0 0.25rem; + border-radius: 2px; + font-size: 0.9em; } [data-md-color-scheme="slate"] .llm-md-banner__text code { @@ -320,7 +320,7 @@ .llm-md-banner__arrow { color: var(--wiggly-molab); font-weight: 700; - font-size: 1.1rem; + margin-left: 0.15rem; } /* —————————————————————————————————————————— From d087a97c951edad4e03bf4824778f12924f60658 Mon Sep 17 00:00:00 2001 From: "Vincent D. Warmerdam" Date: Fri, 1 May 2026 18:15:00 +0200 Subject: [PATCH 4/5] Polish clanker pill and re-enable dark mode toggle - Drop the page emoji and the green arrow color; the pill is now monochrome with a transparent background and floats right of the H1 so the page title isn't pushed down. - Restore the sun/moon palette toggle so users can switch between the default and slate schemes (extra.css already had the dark overrides). --- mkdocs/assets/stylesheets/extra.css | 54 ++++++++++------------------- mkdocs/overrides/main.html | 9 ++--- zensical.toml | 9 +++++ 3 files changed, 29 insertions(+), 43 deletions(-) diff --git a/mkdocs/assets/stylesheets/extra.css b/mkdocs/assets/stylesheets/extra.css index df17574a..8e2ad1fb 100644 --- a/mkdocs/assets/stylesheets/extra.css +++ b/mkdocs/assets/stylesheets/extra.css @@ -273,53 +273,35 @@ } /* —————————————————————————————————————————— - LLM markdown pill (top of reference pages) + LLM markdown pill (top-right of reference pages) —————————————————————————————————————————— */ -.llm-md-banner { - display: inline-flex; - align-items: center; - gap: 0.4rem; - padding: 0.3rem 0.65rem; - margin: 0 0 1.5rem; +.llm-md-link { + float: right; + margin: 0.65rem 0 0.5rem 1rem; + padding: 0.2rem 0.65rem; border: 1px solid var(--wiggly-border); border-radius: 999px; - background: var(--wiggly-btn-bg); - color: var(--md-primary-fg-color); + background: transparent; + color: var(--wiggly-muted); text-decoration: none; - font-size: 0.72rem; - line-height: 1.3; - transition: background-color 0.15s ease, border-color 0.15s ease; + font-size: 0.7rem; + line-height: 1.5; + transition: color 0.15s ease, border-color 0.15s ease; } -.llm-md-banner:hover { - background: var(--wiggly-btn-bg-hover); +.llm-md-link:hover { + color: var(--md-primary-fg-color); border-color: var(--wiggly-border-hover); } -.llm-md-banner__icon { - font-size: 0.85rem; - line-height: 1; +.llm-md-link code { + background: none; + padding: 0; + font-size: inherit; + color: inherit; } -.llm-md-banner__text strong { - font-weight: 700; - margin-right: 0.15rem; -} - -.llm-md-banner__text code { - background: rgba(0, 0, 0, 0.06); - padding: 0 0.25rem; - border-radius: 2px; - font-size: 0.9em; -} - -[data-md-color-scheme="slate"] .llm-md-banner__text code { - background: rgba(255, 255, 255, 0.08); -} - -.llm-md-banner__arrow { - color: var(--wiggly-molab); - font-weight: 700; +.llm-md-link__arrow { margin-left: 0.15rem; } diff --git a/mkdocs/overrides/main.html b/mkdocs/overrides/main.html index 1adfa774..194d9bfd 100644 --- a/mkdocs/overrides/main.html +++ b/mkdocs/overrides/main.html @@ -12,13 +12,8 @@ {% block content %} {% if page and "reference/" in page.url and page.url != "reference/" %} {% set slug = page.url | replace("reference/", "") | replace("/", "") %} - - 📄 - - Feeding a clanker? - Grab this page as raw markdown — drop the .md URL into your prompt. - - → + + Feeding a clanker? Grab this page as raw .md → {% endif %} {% include "partials/content.html" %} diff --git a/zensical.toml b/zensical.toml index dd9b4974..028ea56f 100644 --- a/zensical.toml +++ b/zensical.toml @@ -86,6 +86,15 @@ code = "Fira Mono" scheme = "default" primary = "grey" accent = "blue grey" +toggle.icon = "lucide/sun" +toggle.name = "Switch to dark mode" + +[[project.theme.palette]] +scheme = "slate" +primary = "grey" +accent = "blue grey" +toggle.icon = "lucide/moon" +toggle.name = "Switch to light mode" # ---------------------------------------------------------------------------- # Extra From d101089a7c2c477443fcd0fb531159983b2951f1 Mon Sep 17 00:00:00 2001 From: "Vincent D. Warmerdam" Date: Fri, 1 May 2026 18:29:25 +0200 Subject: [PATCH 5/5] Switch docs to Geist + Geist Mono Picked via the ui-picker A/B between PT Sans, Inter, DM Sans, and Geist. Geist's Swiss-precision sans pairs naturally with its monospace sibling so headings, body, and code all feel like the same family. --- zensical.toml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/zensical.toml b/zensical.toml index 028ea56f..aa28f335 100644 --- a/zensical.toml +++ b/zensical.toml @@ -79,8 +79,8 @@ features = [ repo = "fontawesome/brands/github" [project.theme.font] -text = "PT Sans" -code = "Fira Mono" +text = "Geist" +code = "Geist Mono" [[project.theme.palette]] scheme = "default"