From 9dc159f65424ea2422185b7972d00c67bcc801f2 Mon Sep 17 00:00:00 2001 From: Zanie Blue Date: Mon, 10 Nov 2025 11:49:33 -0600 Subject: [PATCH] Fix search; fix zensical dependency --- docs/.overrides/main.html | 8 ++++++ docs/requirements.in | 2 +- docs/requirements.txt | 51 +++++++++++----------------------- docs/stylesheets/extra.css | 57 ++++++++++++++++++++++++++++++++++---- 4 files changed, 76 insertions(+), 42 deletions(-) diff --git a/docs/.overrides/main.html b/docs/.overrides/main.html index 60b19cfe8..4257c7c2a 100644 --- a/docs/.overrides/main.html +++ b/docs/.overrides/main.html @@ -61,6 +61,9 @@ Replace the mkdocs header entirely to look more like Mintlify's theme {% include ".icons/material/menu.svg" %} + + +
@@ -91,6 +94,11 @@ Replace the mkdocs header entirely to look more like Mintlify's theme
{% include "partials/search.html" %} + + +
diff --git a/docs/requirements.in b/docs/requirements.in index 197cb236c..724270412 100644 --- a/docs/requirements.in +++ b/docs/requirements.in @@ -1,5 +1,5 @@ black>=23.10.0 -zensical +zensical>=0.0.5 mdformat>=0.7.17 mdformat-mkdocs>=2.0.4 mdformat-admon>=2.0.2 diff --git a/docs/requirements.txt b/docs/requirements.txt index 41c93098a..d11365568 100644 --- a/docs/requirements.txt +++ b/docs/requirements.txt @@ -1,47 +1,39 @@ # This file was autogenerated by uv via the following command: # uv pip compile docs/requirements.in -o docs/requirements.txt --universal -p 3.12 babel==2.15.0 - # via - # mkdocs-git-revision-date-localized-plugin - # mkdocs-material + # via mkdocs-git-revision-date-localized-plugin beautifulsoup4==4.13.4 # via # markdownify # mkdocs-llmstxt black==24.4.2 # via -r docs/requirements.in -certifi==2024.7.4 - # via requests -charset-normalizer==3.3.2 - # via requests -click==8.1.7 +click==8.3.0 # via # black # mkdocs -colorama==0.4.6 + # zensical +colorama==0.4.6 ; sys_platform == 'win32' # via # click # mkdocs - # mkdocs-material +deepmerge==2.0 + # via zensical ghp-import==2.1.0 # via mkdocs gitdb==4.0.12 # via gitpython gitpython==3.1.44 # via mkdocs-git-revision-date-localized-plugin -idna==3.7 - # via requests jinja2==3.1.4 - # via - # mkdocs - # mkdocs-material + # via mkdocs linkify-it-py==2.0.3 # via markdown-it-py -markdown==3.6 +markdown==3.10 # via # mkdocs - # mkdocs-material # pymdown-extensions + # zensical markdown-it-py==3.0.0 # via # mdformat @@ -84,9 +76,7 @@ mergedeep==1.3.4 # mkdocs-get-deps mkdocs==1.6.0 # via - # -r docs/requirements.in # mkdocs-git-revision-date-localized-plugin - # mkdocs-material # mkdocs-redirects mkdocs-get-deps==0.2.0 # via mkdocs @@ -94,10 +84,6 @@ mkdocs-git-revision-date-localized-plugin==1.3.0 # via -r docs/requirements.in mkdocs-llmstxt==0.2.0 # via -r docs/requirements.in -mkdocs-material==9.5.29 - # via -r docs/requirements.in -mkdocs-material-extensions==1.3.1 - # via mkdocs-material mkdocs-redirects==1.2.2 # via -r docs/requirements.in more-itertools==10.3.0 @@ -108,8 +94,6 @@ packaging==24.1 # via # black # mkdocs -paginate==0.5.6 - # via mkdocs-material pathspec==0.12.1 # via # black @@ -119,25 +103,22 @@ platformdirs==4.2.2 # black # mkdocs-get-deps pygments==2.18.0 - # via mkdocs-material -pymdown-extensions==10.8.1 - # via mkdocs-material + # via zensical +pymdown-extensions==10.16.1 + # via zensical python-dateutil==2.9.0.post0 # via ghp-import pytz==2025.1 # via mkdocs-git-revision-date-localized-plugin -pyyaml==6.0.1 +pyyaml==6.0.3 # via # mkdocs # mkdocs-get-deps # pymdown-extensions # pyyaml-env-tag + # zensical pyyaml-env-tag==0.1 # via mkdocs -regex==2024.5.15 - # via mkdocs-material -requests==2.32.3 - # via mkdocs-material six==1.16.0 # via # markdownify @@ -150,7 +131,7 @@ typing-extensions==4.14.0 # via beautifulsoup4 uc-micro-py==1.0.3 # via linkify-it-py -urllib3==2.2.2 - # via requests watchdog==4.0.1 # via mkdocs +zensical==0.0.5 + # via -r docs/requirements.in diff --git a/docs/stylesheets/extra.css b/docs/stylesheets/extra.css index 4391d13e2..82e3516a5 100644 --- a/docs/stylesheets/extra.css +++ b/docs/stylesheets/extra.css @@ -258,7 +258,7 @@ modifications */ It has no children, so it is not considered a section */ .md-nav--primary > .md-nav__list > .md-nav__item:first-of-type { font-size: 0.85rem; - margin-bottom: 0.75em; + margin-bottom: 0.25em; font-weight: bold; } } @@ -366,10 +366,6 @@ modifications */ margin-left: auto; } -/* Enhanced search bar styling for better prominence */ -.md-search { - order: 2; -} /* Make search field more prominent and centered */ @media screen and (min-width: 60em) { @@ -554,7 +550,6 @@ modifications */ box-shadow: 0 1px 0 0 rgba(255, 255, 255, 0.025); } -/* Refine header layout for centered search */ @media screen and (min-width: 76.25em) { /* Hide the search modal's button that appears in the header */ @@ -647,4 +642,54 @@ modifications */ margin-left: 0.5rem; flex-shrink: 0; } + + /* Show and style mobile search button */ + .md-header__button.md-icon[for="__search"] { + display: inline-flex; + align-items: center; + justify-content: center; + width: 1.875rem; + height: 1.75rem; + padding: 0; + background-color: transparent; + border: 1px solid rgba(0, 0, 0, 0.08); + border-radius: 0.5rem; + order: 9; + margin-left: 0.5rem; + margin-right: 0.75rem; /* Extra spacing from Discord/GitHub */ + transition: all 0.15s ease; + } + + .md-header__button.md-icon[for="__search"]:hover { + background-color: rgba(0, 0, 0, 0.03); + border-color: rgba(0, 0, 0, 0.15); + } + + .md-header__button.md-icon[for="__search"] svg { + width: 16px; + height: 16px; + color: rgba(0, 0, 0, 0.6); + } + + .md-header__button.md-icon[for="__search"]:hover svg { + color: rgba(0, 0, 0, 0.85); + } + + /* Dark mode mobile search button */ + [data-md-color-scheme="astral-dark"] .md-header__button.md-icon[for="__search"] { + border-color: rgba(255, 255, 255, 0.1); + } + + [data-md-color-scheme="astral-dark"] .md-header__button.md-icon[for="__search"]:hover { + background-color: rgba(255, 255, 255, 0.05); + border-color: rgba(255, 255, 255, 0.2); + } + + [data-md-color-scheme="astral-dark"] .md-header__button.md-icon[for="__search"] svg { + color: rgba(255, 255, 255, 0.6); + } + + [data-md-color-scheme="astral-dark"] .md-header__button.md-icon[for="__search"]:hover svg { + color: rgba(255, 255, 255, 0.85); + } }