From 62fd83998a586f902e22550804ceaae867c6f26a Mon Sep 17 00:00:00 2001 From: Alexandre Boucaud Date: Thu, 14 May 2026 12:37:53 +0200 Subject: [PATCH 1/2] Port the lightcone style to the docs --- docs/assets/favicon.svg | 1 + docs/assets/logo.svg | 1 + docs/stylesheets/extra.css | 48 ++++++++++++++++++++++++++++++++++++++ zensical.toml | 17 ++++++++++++++ 4 files changed, 67 insertions(+) create mode 100644 docs/assets/favicon.svg create mode 100644 docs/assets/logo.svg create mode 100644 docs/stylesheets/extra.css diff --git a/docs/assets/favicon.svg b/docs/assets/favicon.svg new file mode 100644 index 0000000..011c383 --- /dev/null +++ b/docs/assets/favicon.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/assets/logo.svg b/docs/assets/logo.svg new file mode 100644 index 0000000..011c383 --- /dev/null +++ b/docs/assets/logo.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/stylesheets/extra.css b/docs/stylesheets/extra.css new file mode 100644 index 0000000..44482d5 --- /dev/null +++ b/docs/stylesheets/extra.css @@ -0,0 +1,48 @@ +@import url('https://fonts.googleapis.com/css2?family=EB+Garamond:ital,wght@0,400..800;1,400..800&family=Libre+Baskerville:ital,wght@0,400;0,700;1,400&family=Inter:wght@300;400;500;600&family=JetBrains+Mono:wght@400;500&display=swap'); + +/* Light mode — parchment + blue-ink palette */ +:root > * { + --md-primary-fg-color: #4e5a70; + --md-primary-fg-color--light: #6b7a8d; + --md-primary-fg-color--dark: #3a4456; + --md-accent-fg-color: #426b78; + --md-default-bg-color: #f8f7f3; + --md-default-bg-color--light: #ffffff; + --md-default-bg-color--dark: #f1efe9; + --md-text-font: "Libre Baskerville", Georgia, serif; + --md-code-font: "JetBrains Mono", "Fira Code", monospace; +} + +/* Apply parchment to all major surface areas */ +body, +.md-header, +.md-main, +.md-main__inner, +.md-content, +.md-tabs { + background-color: #f8f7f3; +} + +/* Dark mode — charcoal base, blue-ink hue */ +[data-md-color-scheme="slate"] { + --md-default-bg-color: #221f20; + --md-hue: 219; +} + +[data-md-color-scheme="slate"] body, +[data-md-color-scheme="slate"] .md-header, +[data-md-color-scheme="slate"] .md-main, +[data-md-color-scheme="slate"] .md-main__inner, +[data-md-color-scheme="slate"] .md-content, +[data-md-color-scheme="slate"] .md-tabs { + background-color: #221f20; +} + +/* Sidebar */ +.md-sidebar { + background-color: #f8f7f3; +} + +[data-md-color-scheme="slate"] .md-sidebar { + background-color: #2c2829; +} diff --git a/zensical.toml b/zensical.toml index 23be2cb..84f5020 100644 --- a/zensical.toml +++ b/zensical.toml @@ -5,6 +5,7 @@ site_author = "Lightcone Research Team" repo_url = "https://github.com/LightconeResearch/lightcone-cli" copyright = "© 2026 Lightcone Research" docs_dir = "docs" +extra_css = ["stylesheets/extra.css"] nav = [ {"Home" = "index.md"}, @@ -63,6 +64,8 @@ nav = [ [project.theme] variant = "modern" +logo = "assets/logo.svg" +favicon = "assets/favicon.svg" features = [ "navigation.tabs", "navigation.sections", @@ -71,3 +74,17 @@ features = [ "search.highlight", "content.code.copy", ] + +[[project.theme.palette]] +scheme = "default" +primary = "custom" +accent = "custom" +toggle.icon = "lucide/sun" +toggle.name = "Switch to dark mode" + +[[project.theme.palette]] +scheme = "slate" +primary = "custom" +accent = "custom" +toggle.icon = "lucide/moon" +toggle.name = "Switch to light mode" From 7fca7bb81a82c832c0f1ba1fac941082498110b9 Mon Sep 17 00:00:00 2001 From: Alexandre Boucaud Date: Thu, 14 May 2026 13:02:02 +0200 Subject: [PATCH 2/2] Refine docs theme: fix dark mode contrast and surface colors - Apply parchment background to all surfaces (header, sidebars, main) - Match dark mode surfaces to charcoal base (#221f20) - Lighten dark mode nav active state, links, and inline code for readability Co-Authored-By: Claude Sonnet 4.6 --- docs/stylesheets/extra.css | 29 +++++++++++++++++++---------- 1 file changed, 19 insertions(+), 10 deletions(-) diff --git a/docs/stylesheets/extra.css b/docs/stylesheets/extra.css index 44482d5..e454c12 100644 --- a/docs/stylesheets/extra.css +++ b/docs/stylesheets/extra.css @@ -1,6 +1,7 @@ @import url('https://fonts.googleapis.com/css2?family=EB+Garamond:ital,wght@0,400..800;1,400..800&family=Libre+Baskerville:ital,wght@0,400;0,700;1,400&family=Inter:wght@300;400;500;600&family=JetBrains+Mono:wght@400;500&display=swap'); -/* Light mode — parchment + blue-ink palette */ +/* ── Light mode ─────────────────────────────────────────────────────────── */ + :root > * { --md-primary-fg-color: #4e5a70; --md-primary-fg-color--light: #6b7a8d; @@ -13,17 +14,18 @@ --md-code-font: "JetBrains Mono", "Fira Code", monospace; } -/* Apply parchment to all major surface areas */ body, .md-header, .md-main, .md-main__inner, .md-content, -.md-tabs { +.md-tabs, +.md-sidebar { background-color: #f8f7f3; } -/* Dark mode — charcoal base, blue-ink hue */ +/* ── Dark mode ──────────────────────────────────────────────────────────── */ + [data-md-color-scheme="slate"] { --md-default-bg-color: #221f20; --md-hue: 219; @@ -34,15 +36,22 @@ body, [data-md-color-scheme="slate"] .md-main, [data-md-color-scheme="slate"] .md-main__inner, [data-md-color-scheme="slate"] .md-content, -[data-md-color-scheme="slate"] .md-tabs { +[data-md-color-scheme="slate"] .md-tabs, +[data-md-color-scheme="slate"] .md-sidebar { background-color: #221f20; } -/* Sidebar */ -.md-sidebar { - background-color: #f8f7f3; +[data-md-color-scheme="slate"] .md-nav__link--active, +[data-md-color-scheme="slate"] .md-nav__item--active > .md-nav__link { + background-color: rgba(106, 147, 160, 0.20); + color: #f8f7f3; } -[data-md-color-scheme="slate"] .md-sidebar { - background-color: #2c2829; +[data-md-color-scheme="slate"] .md-content a { + color: #85c0d0; +} + +[data-md-color-scheme="slate"] .md-content :not(pre) > code { + background-color: rgba(76, 63, 70, 0.15); + color: #c8dde5; }