CERBERUS/kitty
1
0
Fork 0
mirror of https://github.com/kovidgoyal/kitty.git synced 2026-07-11 18:23:20 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Start work on documenting text sizing protocol

Browse source
This commit is contained in:
Kovid Goyal 2025-01-15 12:21:48 +05:30
parent 4e76a3d1c6
commit 484155ca89
No known key found for this signature in database
GPG key ID: 06BC317B515ACE7C
2 changed files with 24 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

1
docs/protocol-extensions.rst
View file

@ -27,6 +27,7 @@ please do so by opening issues in the `GitHub bug tracker
underlines
graphics-protocol
keyboard-protocol
text-sizing-protocol
file-transfer-protocol
desktop-notifications
pointer-shapes

23
docs/text-sizing-protocol.rst Normal file
View file

@ -0,0 +1,23 @@
The text sizing protocol
==============================================
Classically, because the terminal is a grid of equally spaced characters, only
a single text size was supported in terminals, with one minor exception, some
characters were allowed to be rendered in two cells, to accommodate East Asian
square aspect ratio characters and Emoji. Here by single text size we mean the
font size of all text on the screen is the same.
This protocol allows text to be displayed in the terminal in different sizes
both larger and smaller than the base text. It also solves the long standing
problem of robustly determining the width (in cells) a character should have.
Applications can interleave text of different sizes on the screen allowing for
typographic niceties like headlines, superscripts, etc.
Note that this protocol is fully backwards compatible, terminals that implement
it will continue to work just the same with applications that do not use it.
Because of this, it is not fully flexible in the font sizes it allows, as it
still has to work with the grid based character cell fundamental nature of the
terminal.
Quickstart
--------------