From 143667889743fa32c6e3bd2475f75b375cc4323d Mon Sep 17 00:00:00 2001 From: RadRussianRus Date: Mon, 10 Sep 2018 15:26:49 +0300 Subject: [PATCH] Created Font Scheme (markdown) --- Font-Scheme.md | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 Font-Scheme.md diff --git a/Font-Scheme.md b/Font-Scheme.md new file mode 100644 index 0000000..066f041 --- /dev/null +++ b/Font-Scheme.md @@ -0,0 +1,31 @@ +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](https://github.com/RadRussianRus/sddm-slice/wiki/Font-Scheme-Layer-1)** - font options that are mandatory. +* **[Layer 2](https://github.com/RadRussianRus/sddm-slice/wiki/Font-Scheme-Layer-2)** - common font options. +* **[Layer 3](https://github.com/RadRussianRus/sddm-slice/wiki/Font-Scheme-Layer-3)** - fonts for specific control groups. \ No newline at end of file