Docs: Describes the priority order of auto bold fonts

This commit is contained in:
pagedown 2021-11-05 17:19:34 +08:00
parent 9be7345ba6
commit 2e95cd7a62
No known key found for this signature in database
GPG Key ID: E921CF18AC8FF6EB
2 changed files with 6 additions and 4 deletions

View File

@ -65,7 +65,7 @@ def find_best_match(family: str, bold: bool = False, italic: bool = False, ignor
] == italic else 0 ] == italic else 0
monospace_match = 1 if candidate['monospace'] else 0 monospace_match = 1 if candidate['monospace'] else 0
is_regular_width = not candidate['expanded'] and not candidate['condensed'] is_regular_width = not candidate['expanded'] and not candidate['condensed']
# prefer demi-bold to bold to heavy, less bold means less chance of # prefer semi-bold to bold to heavy, less bold means less chance of
# overflow # overflow
weight_distance_from_medium = abs(candidate['weight']) weight_distance_from_medium = abs(candidate['weight'])
return style_match, monospace_match, 1 if is_regular_width else 0, 1 - weight_distance_from_medium return style_match, monospace_match, 1 if is_regular_width else 0, 1 - weight_distance_from_medium

View File

@ -33,9 +33,11 @@ opt('font_family', 'monospace',
long_text=''' long_text='''
You can specify different fonts for the bold/italic/bold-italic variants. You can specify different fonts for the bold/italic/bold-italic variants.
To get a full list of supported fonts use the `kitty list-fonts` command. To get a full list of supported fonts use the `kitty list-fonts` command.
By default they are derived automatically, by the OSes font system. Setting By default they are derived automatically, by the OSes font system. When
them manually is useful for font families that have many weight variants like bold_font or bold_italic_font is set to :code:`auto`, the priority of bold
Book, Medium, Thick, etc. For example:: fonts is semi-bold, bold, heavy. Setting them manually is useful for font
families that have many weight variants like Book, Medium, Thick, etc.
For example::
font_family Operator Mono Book font_family Operator Mono Book
bold_font Operator Mono Medium bold_font Operator Mono Medium