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
monospace_match = 1 if candidate['monospace'] else 0
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
weight_distance_from_medium = abs(candidate['weight'])
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='''
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.
By default they are derived automatically, by the OSes font system. Setting
them manually is useful for font families that have many weight variants like
Book, Medium, Thick, etc. For example::
By default they are derived automatically, by the OSes font system. When
bold_font or bold_italic_font is set to :code:`auto`, the priority of bold
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
bold_font Operator Mono Medium