Configuration

juicerstudy reads its configuration from three places in site.toml plus per-page frontmatter:

• A small set of top-level site keys (the same ones every juicer theme uses — title, author, baseURL, etc.).
• A namespaced [juicerstudy] table for theme-specific knobs — palette, typography, sizing, the math opt-in.
• Per-page frontmatter for opt-ins like the right-rail TOC and the page’s own summary lead.

Anything you don’t set keeps the theme’s defaults. juicerstudy uses [juicerstudy] so it doesn’t collide with the keys other themes might want.

Quick example

A complete site.toml exercising every juicerstudy-aware feature:

title    = "Marginalia"
tagline  = "notes from the margins of books"
author   = "a slow reader"
baseURL  = "https://example.com"

theme    = "juicerstudy"
headingShift = 0

[juicerstudy]
# Optional KaTeX rendering. Off by default — sites without math# Optional KaTeX rendering. Off by default — sites without math
# don't pay the script + stylesheet cost.# don't pay the script + stylesheet cost.
math = true

# Logo for the topbar wordmark + the <link rel=icon> fallback.# Logo for the topbar wordmark + the <link rel=icon> fallback.
# Top-level `favicon` wins over this for the icon tag.# Top-level `favicon` wins over this for the icon tag.
logo = "/site-logo.png"

# Palette — a quiet scholarly grey with amber accent.# Palette — a quiet scholarly grey with amber accent.
brand           = "#475569"   # slate-600 — primary# slate-600 — primary
brandStrong     = "#334155"   # slate-700 — hover# slate-700 — hover
brandSoft       = "#f1f5f9"   # slate-100 — backgrounds# slate-100 — backgrounds
accent          = "#b45309"   # amber-700 — secondary, link-like# amber-700 — secondary, link-like
leaf            = "#65a30d"   # lime-600  — success / leaf# lime-600  — success / leaf

brandDark       = "#94a3b8"
brandStrongDark = "#cbd5e1"
brandSoftDark   = "rgb(148 163 184 / .12)"
accentDark      = "#fbbf24"
leafDark        = "#a3e635"

Top-level keys (read by juicerstudy)

[juicerstudy] keys

Optional features

Palette — light mode

Any CSS color expression works: hex (#...), rgb(...), hsl(...), oklch(...), color-mix(...), named colors. The values land in a <style> block emitted after juicerstudy.css.

Palette — dark mode overrides

Set just the ones you want to differ — anything you leave out keeps its light-mode value, which is almost certainly wrong in dark mode, so it’s worth setting all five.

Typography

To swap in a different font, set its @font-face declarations in your own static/site.css, add the file path to customCSS, and set the matching token here.

Sizing

Per-page frontmatter

Keys juicerstudy reads from each page’s frontmatter:

Root landing (_index.md) extras

Keys juicerstudy reads on the root _index.md to drive the landing-page hero:

These are root-only — nested section landings render with a simpler header + subsection-card grid (and ignore the hero keys).

Site-level landing tokens

The root landing also reads two [juicerstudy] keys that control the hero’s CTAs:

Image variants

[images] enabled = true in site.toml turns on responsive image delivery for both the heroImage and any use of the figure shortcode. The build runs magick (ImageMagick 7) once per source, caches by content hash, and reuses across builds. See Reference → Image variants for the full configuration surface.

[images]
enabled = true
widths  = [480, 960, 1600]
formats = ["webp", "original"]
quality = 78

All other juicer engine frontmatter (date, weight, aliases, permalinks, etc.) works as documented in Reference → Frontmatter — juicerstudy doesn’t override or hide any of it.

Shortcodes

juicerstudy ships the standard juicer shortcode set plus one study-specific one:

• Callouts — note, tip, warning, danger
• Layout helpers — figure, collapse, tabs / tab, steps, buttons / button
• Inline — kbd, badge, github
• Embeds — youtube
• Reference — filetree
• juicerstudy-specific — section-list (renders a section’s direct children as a titled list with summaries; useful on authored section landings that want an explicit catalog beside the editorial prose). See the shortcodes reference for the generic shortcode usage and call-site conventions.

Where the values land

The <head> partial emits a <style> block immediately after juicerstudy.css, redefining only the variables you’ve set:

```css

root {

–brand: #475569; /* from juicerstudy.brand / –brand-strong: #334155; / from juicerstudy.brandStrong / / … / } [data-theme=”dark”] { –brand: #94a3b8; / from juicerstudy.brandDark / / … */ }

Anything not set falls through to the defaults declared at the top
of `juicerstudy.css`. The theme always toggles between light and
dark via the `data-theme` attribute on `<html>`, set by the
pre-paint script in `<head>`.

## Going beyond config

Drop a file with the same path under your own site to override
anything in the theme — the ordinary
[theme overlay](/concepts/themes/) pattern:

| You want to change… | Override at… |
|---------------------|--------------|
| The topbar          | `<src>/partials/topbar.html` |
| The footer markup   | `<src>/partials/footer.html` |
| The 404 page        | `<src>/layouts/_default/404.html` |
| The section landing | `<src>/layouts/_default/folder.html` |
| Custom CSS          | `<src>/static/site.css` (and add `"site.css"` to `customCSS` in `site.toml`) |

Site files always win over theme files, so overrides are a
one-file-at-a-time operation — no forking the theme.

## SEO

Every juicer theme ships a shared SEO partial (`partials/seo.html`) that emits the standard meta block: description (with site-level fallback), canonical link, author meta, robots `noindex`, OpenGraph + Twitter cards (via the `ogTags` builtin), Atom feed discovery, and theme-specific JSON-LD. The engine separately writes `sitemap.xml` and `robots.txt`.

### Site-wide keys

```toml
description = "Notes and short courses on linear algebra, written for the curious."
ogImage     = "/og/default.png"

robots   = true
noindex  = false                  # set true for staging/preview domains
disallow = ["/scratch/"]

Per-page frontmatter

---
title: Eigenvalues, intuitively
summary: A one-sentence dek for search results and OG cards.
date: 2026-04-12                  # surfaces in Article JSON-LD
author: ed
image: /img/eigenvalues-card.png
ogTitle: A snappier social headline
ogDescription: Tightened for socials
noindex: true   # excluded from sitemap, JSON-LD suppressed, <meta robots> emitted
---

Structured data emitted

noindex: true suppresses ALL JSON-LD on that page.

Overriding the SEO partial

Drop a file at <src>/partials/seo.html (or seo-jsonld.html for just the structured-data part). Site overrides win over the theme’s copy.