mirror of
https://github.com/kovidgoyal/kitty.git
synced 2024-09-11 14:45:31 +03:00
Start documenting the choose fonts kitten
This commit is contained in:
parent
f887519c1e
commit
5774965e32
41
docs/kittens/choose-fonts.rst
Normal file
41
docs/kittens/choose-fonts.rst
Normal file
@ -0,0 +1,41 @@
|
||||
Changing kitty fonts
|
||||
========================
|
||||
|
||||
.. only:: man
|
||||
|
||||
Overview
|
||||
--------------
|
||||
|
||||
Terminal aficionados spend all day staring at text, as such, getting text
|
||||
rendering just right is very important. kitty has extremely powerful facilities
|
||||
for fine-tuning text rendering. It supports `OpenType features
|
||||
<https://en.wikipedia.org/wiki/List_of_typographic_features>`__ to select
|
||||
alternate glyph shapes, and `Variable fonts
|
||||
<https://en.wikipedia.org/wiki/Variable_font>`__ to control the weight or
|
||||
spacing of a font precisely. You can also :opt:`select which font is used to
|
||||
render particular unicode codepoints <symbol_map>` and you can :opt:`modify
|
||||
font metrics <modify_font>` and even :opt:`adjust the gamma curves
|
||||
<text_composition_strategy>` used for rendering text onto the background color.
|
||||
|
||||
The first step is to select the font faces kitty will use for rendering
|
||||
regular, bold and italic text. kitty comes with a convenient UI for choosing fonts,
|
||||
in the form of the *choose-fonts* kitten. Simply run::
|
||||
|
||||
kitten choose-fonts
|
||||
|
||||
and follow the on screen prompts.
|
||||
|
||||
First, choose the family you want, the list of families can be easily filtered by
|
||||
typing a few letters from the family name you are looking for. The family
|
||||
selection screen shows you a preview of how the family looks.
|
||||
|
||||
.. image:: ../screenshots/family-selection.png
|
||||
:alt: Choosing a family with the choose fonts kitten
|
||||
:width: 600
|
||||
|
||||
Once you select a family by pressing the :kbd:`Enter` key, you
|
||||
are shown previews of what the regular, bold and italic faces look like
|
||||
for that family. You can choose to fine tune any of the faces. Start with
|
||||
fine-tuning the regular face by pressing the :kbd:`R` key. The other styles
|
||||
will be automatically adjusted based on what you select for the regular face.
|
||||
|
@ -11,6 +11,7 @@ Extend with kittens
|
||||
kittens/diff
|
||||
kittens/unicode_input
|
||||
kittens/themes
|
||||
kittens/choose-fonts
|
||||
kittens/hints
|
||||
kittens/remote_file
|
||||
kittens/hyperlinked_grep
|
||||
|
BIN
docs/screenshots/family-selection.png
Normal file
BIN
docs/screenshots/family-selection.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 173 KiB |
Loading…
Reference in New Issue
Block a user