keryx font use¶

Description¶

Points a theme's card text at an installed font.

$ keryx font use brand
card.font_bold -> brand (project scope)
note: a project font resolves only inside this project — `keryx font promote` puts
      it in your user library if the theme is meant to be reusable
edited theme "starter"

Usage¶

keryx font use <key> [--theme <keyword>] [--mono]

Flag	Meaning	Default
`--theme`	the theme to change	the configured default theme
`--mono`	set the monospace face (the URL closer) instead of the body face	`false`

Why not `theme edit`¶

keryx theme edit <kw> --set card.font_bold=brand writes the same value, and is still there if you want it. The difference is that font use resolves the key first.

theme edit will record a font that does not exist. Nothing complains, and the mistake surfaces later as a reel silently drawn in the fallback face — the kind of quiet degradation that costs an hour to trace. font use refuses up front:

$ keryx font use nosuchfont
ERRO font "nosuchfont": no font found for that key

The write itself goes through the same code path as theme edit, so a theme inherited from your user library is forked into the project exactly as it would be otherwise.

It warns when a theme will not travel¶

A theme is often reusable; a font is only available where it is installed. When the two disagree, use says so — and continues, because neither case is wrong:

Font scope	Warning
`project`	resolves only inside this project — promote it if the theme is meant to be reusable
`system`	carried by nothing — install it with `font add` so the reel renders the same way on another machine

Which faces a card uses¶

A card draws body lines in the bold face and the closing URL card in the mono face. --mono targets the second.

Confirming it landed¶

keryx theme show does not currently display the card font fields, so it will not reflect the change. Read ~/.keryx/themes.yaml (or the project's .keryx.yaml) to confirm:

themes:
  starter:
    card:
      font_bold: brand