Skip to content

Font Scheme

Eric Kotato edited this page Nov 28, 2024 · 3 revisions

Font scheme is the set of configuration options that changing fonts of various theme elements: buttons, text, etc.

Configuration options are divided by layers - groups of font options. Higher levels are for more granular options. Only layer 1 is required, but since theme.conf already contains these options, they can be omitted in theme.conf.user, but it's recommended to redefine them, as they can define full color scheme.

Each option (except layer 1 options) has additional postfix options:

  • _size: size of text in points.
  • _bold: is text bold (boolean).
  • _italic: is text italic (boolean).
  • _underline: is text underline (boolean).
  • _capitalization: how to capitalize text. Allowed values:
    • upper: uppercase
    • lower: lowercase
    • smallcaps: small capitals
    • capitalize: capitalize first letter of each word
    • any other value if option defined: standart case
    • any other value if option is not defined: theme-defined case

You can use "0/1", "true/false" and "yes/no" for boolean options, real numbers on _size options and font names in base options.

Levels that are higher than 1 have fallback fonts to current or lower levels, so they can be optional and you could set options that you need. Fallback fonts will check every option from left to right for existing, and will use first existing option.

If fallback is shown as "fallback..." it means that fallback's fallback fonts are also applied. Example:

  • option fallbacks are other_option, fall...;
  • fall fallbacks are font;
  • so option fallbacks will be other_option, fall, font.

Current layers

  • Layer 1 - font options that are mandatory.
  • Layer 2 - common font options.
  • Layer 3 - fonts for specific control groups.
Clone this wiki locally