Where Font Schemes Live

Documentation / Contents - Font Scheme

• Overview of the Font Scheme Panel
  • Fonts and Colours Are Separate
  • What Sets It Apart
• The Nine Roles
  • The House Voice
  • The Small and Tiny Sizes
  • Partial Schemes
• Using the Panel
  • The Scheme List
  • The Role Rows
  • Changing One Role
  • The Buttons
    • Apply
    • Save and Save As
    • Defaults and Revert
    • Close
  • Following the Desktop
• Font Descriptors
  • The Leading Dash Is the Whole Rule
  • When the Resolved Font Differs
  • Reading the Nine Samples
• Point Size, DPI, and Why Layout Holds
  • Where DPI Comes From
  • The Panel Fits Itself Before It Draws
  • Changing the Desktop DPI
  • Bitmap Fonts and the Core Path
  • Looking at What a Canonical Application Will Get
• Where Font Schemes Live
  • The Search Path
  • The File
  • Two Names
  • The Built-in Defaults
• Command Line and Keys
  • Command Line
  • Keys
    • On the Main Panel
    • In the Font Dialog
• Fonts, Colours, and the Rest of the Desktop
  • Colour Schemes
  • Monitor Settings and DPI
  • The Scheme Daemon

Other cards

• Copyright Information

Where Font Schemes Live

The Search Path

Font schemes are looked for in this order. The first directory that has a scheme of a given name wins, so a copy of your own shadows a shipped one.

~/.cyanotype/cyfont      your own schemes; the only place anything is saved
<share>/cyfont           the schemes shipped with Blueprint
the build tree's share/cyfont, when running uninstalled

Note that your font schemes live at ~/.cyanotype/cyfont, NOT under ~/.cyanotype/share. That is by contract. To see the resolved list on your own machine, and in precedence order:

cyfont-prefs --dirs

That is the first thing to run when the scheme list comes up empty.

The File

A font scheme is line-oriented text with a .cyfont tail. A version sentinel, a display name, then one role per line.

!cyfont-1
!name: Rivendell
!
! Lines starting with ! or # are comments.

PlainLabelFont        DejaVu Sans-10
BoldLabelFont         DejaVu Sans-10:bold
ObliqueLabelFont      DejaVu Sans-10:bold:oblique
FixedWidthFont        DejaVu Sans Mono-10
SmallPlainLabelFont   DejaVu Sans-8
SmallBoldLabelFont    DejaVu Sans-8:bold
SmallObliqueLabelFont DejaVu Sans-8:bold:oblique
SmallFixedWidthFont   DejaVu Sans Mono-8
TinyBoldLabelFont     DejaVu Sans-7:bold

Two guarantees the file format makes:

• A scheme that names only some roles is legal. The others fall back to the built-in defaults.
• A role name this version does not know is preserved across a rewrite rather than dropped, so a scheme from a later version survives a trip through this panel.

Two Names

A scheme has two names and they are not the same thing.

• The FILE name, minus the .cyfont tail, is what the list shows and what --apply, --scheme and the command line resolve. It is usually lowercase.
• The !name: line is the DISPLAY name, and it is what the daemon publishes.

The panel matches them ignoring case, so "default" in the list and "Default" on the wire are understood to be the same scheme.

The Built-in Defaults

Identical to the shipped default scheme:

PlainLabelFont          DejaVu Sans-10
BoldLabelFont           DejaVu Sans-10:bold
ObliqueLabelFont        DejaVu Sans-10:bold:oblique
FixedWidthFont          DejaVu Sans Mono-10
SmallPlainLabelFont     DejaVu Sans-8
SmallBoldLabelFont      DejaVu Sans-8:bold
SmallObliqueLabelFont   DejaVu Sans-8:bold:oblique
SmallFixedWidthFont     DejaVu Sans Mono-8
TinyBoldLabelFont       DejaVu Sans-7:bold

Bold is Plain's size in bold, not a size larger. Both oblique roles are bold oblique.

Environment

CY_SHARE   override the shipped asset root
HOME       where your own schemes are written; without it, saving fails
CY_LOG     default logging spec

See Also

• Using the Panel
• Command Line and Keys