# Editorial — fonts

This theme **bundles** a Latin subset of two open-licence (SIL OFL 1.1)
serif families, so it looks correct the moment it is activated — no admin
setup required. The bundled faces are declared in `fonts.json` and land in
the typography picker as `source=template` rows.

| Slot    | Bundled family    | Weights / styles          | Role                                                        |
|---------|-------------------|---------------------------|-------------------------------------------------------------|
| Heading | Playfair Display  | 700 normal, 900 italic    | Didone display face for the masthead wordmark and headlines |
| Body    | Source Serif 4    | 400 normal, 400 italic    | Long-read body type; italic for marginalia and captions     |

The bundled woff2 files and their licence record live in `assets/fonts/`
(`OFL.txt`). Every `font-family` in the theme is routed through
`var(--font-heading, ...)`, `var(--font-body, ...)` and `var(--font-mono, ...)`
with a fallback stack, so the layout is usable before any font is assigned
and the admin font picker stays in full control.

## Assigning the bundled faces

1. In the BlockNinja admin, open **Settings → Theme → Typography**.
2. In the **Bundled** tab, assign **Playfair Display** to the *Heading* slot.
3. Assign **Source Serif 4** to the *Body* slot.
4. Leave *Mono* as the system default, or assign **JetBrains Mono** from the
   Google Fonts tab — it is used for the masthead kicker, datelines and the
   colophon ISSN.

## Optional upgrades (Google Fonts tab)

- **Spectral** (`google:Spectral`) — a refined small-caps serif. Assign it to
  the body slot if you want the small-caps section labels to carry true
  small-caps rather than the synthesized `font-variant: small-caps` fallback.
- **Newsreader** (`google:Newsreader`) — an alternative reading serif for the
  body slot; swaps in without any CSS change via `var(--font-body)`.
- **JetBrains Mono** (`google:JetBrains Mono`) — for the *Mono* slot
  (kicker / dateline / ISSN).

## Bundling a commercial display face (out of scope for Wave A)

If the brand locks in a licensed display face (e.g. *Migra* or *PP Editorial
New*) in place of Playfair Display, licence and subset the woff2 set, drop it
in `assets/fonts/`, and add the family + variants to `fonts.json`. The CSS
does not change — the same `var(--font-heading)` consumer picks up whichever
face an admin assigns.
