diff --git a/docs/overrides/main.css b/docs/overrides/main.css deleted file mode 100644 index c31ed6e..0000000 --- a/docs/overrides/main.css +++ /dev/null @@ -1,43 +0,0 @@ -/* - * main.css - * - * Custom stylesheet for the MkDocs Material site, attached through the - * top-level extra_css option (see mkdocs.yml) and therefore loaded after - * the theme's main.css and palette.css, so every rule in this file wins - * the cascade. - * - * Material for MkDocs only ships prebuilt palette rules for the named - * Material colors, so the teal brand palette (intentionally different - * from the upstream documentation theme) is applied here by overriding - * the theme's CSS custom properties per color scheme: - * - * primary #0e6b64 (deep teal: top bar, active nav, tabs) - * primary dark #0a4f4a (pressed / dark variant of the primary bar) - * primary light #17857c (hover / light variant of the primary bar) - * accent #0d7d70 (light-scheme links, ~5.0:1 contrast on white) - * accent light #6fd0c2 (dark-scheme links, contrast on the slate bg) - */ - -/* primary: deep teal (both schemes) */ -[data-md-color-scheme="default"], -[data-md-color-scheme="slate"] { - --md-primary-fg-color: #0e6b64; - --md-primary-fg-color--light: #17857c; - --md-primary-fg-color--dark: #0a4f4a; -} - -/* accent: teal on the light scheme (also colors the in-text links, since - Material 9 derives --md-typeset-a-color from the primary color by - default) */ -[data-md-color-scheme="default"] { - --md-accent-fg-color: #0d7d70; - --md-accent-fg-color--transparent: #0d7d701a; - --md-typeset-a-color: #0d7d70; -} - -/* accent: light teal on the dark (slate) scheme */ -[data-md-color-scheme="slate"] { - --md-accent-fg-color: #6fd0c2; - --md-accent-fg-color--transparent: #6fd0c21a; - --md-typeset-a-color: #6fd0c2; -} diff --git a/mkdocs.yml b/mkdocs.yml index 92b4822..a007aef 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -22,21 +22,20 @@ theme: palette: - scheme: default # Teal brand palette (intentionally different from the upstream - # documentation theme). These entries set the data-md-color-* page - # attributes (scheme switching / persistence), but Material ships - # no prebuilt rules for custom hex values, so the actual CSS - # variable overrides live in docs/overrides/main.css (attached via - # extra_css). Deep teal (#0e6b64) top bar, teal (#0d7d70) links. - primary: "#0e6b64" - accent: "#0d7d70" + # documentation theme), built only from Material's named colors so + # the site needs no custom CSS. Teal top bar, teal links. + primary: teal + accent: teal toggle: icon: material/brightness-4 name: Switch to dark mode - scheme: slate - # Same teal top bar on the slate neutrals, light teal (#6fd0c2) - # links for contrast on the dark background. - primary: "#0e6b64" - accent: "#6fd0c2" + # Same teal top bar on the slate neutrals. The slate links are + # derived from the primary color by the theme, so the same teal + # accent keeps both schemes consistent (Material ships prebuilt + # accent rules for the base color names only). + primary: teal + accent: teal toggle: icon: material/brightness-7 name: Switch to light mode @@ -54,13 +53,6 @@ theme: - search.suggest - toc -# Material for MkDocs only ships prebuilt palette rules for the named -# Material colors, so the teal palette is applied through this extra -# stylesheet (loaded after the theme CSS, see the file header in -# docs/overrides/main.css for the color choices). -extra_css: - - overrides/main.css - markdown_extensions: - admonition - attr_list