ayo/kitty
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Update docs of font_family to reference the choose-fonts kitten

Browse source
This commit is contained in:
Kovid Goyal 2024-06-24 11:21:15 +05:30
parent fb19bf057e
commit 9ddcedc126
No known key found for this signature in database
GPG key ID: 06BC317B515ACE7C
2 changed files with 5 additions and 12 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

1
docs/kittens/choose-fonts.rst
View file

@ -49,6 +49,7 @@ above the font supports precise weight adjustment. If you are lucky the font
designer has included descriptive names for font features, which will be
displayed, if not, consult the documentation of the font to see what each feature does.
.. _font_spec_syntax:
The font specification syntax
--------------------------------

16
kitty/options/definition.py
View file

@ -35,18 +35,10 @@
opt('font_family', 'monospace', option_type='parse_font_spec',
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, via the Operating System's font
management. When :opt:`bold_font` or :opt:`bold_italic_font` is set to
:code:`auto` on macOS, 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
italic_font Operator Mono Book Italic
bold_italic_font Operator Mono Medium Italic
The easiest way to select fonts is to run the ``kitten choose-fonts`` command
which will present a nice UI for you to select the fonts you want with previews
and support for selecting variable fonts and font features. If you want to learn
to select fonts manually, read the :ref:`font specification syntax <font_spec_syntax>`.
'''
)