kitty/docs
Chance Zibolski 51ebfe4912 Vertical tabs: add tab_title_wrap to wrap long titles
A tab title too wide for the sidebar could only be truncated, which is wasteful
now that a title may use several lines. Add tab_title_wrap, accepting no (the
default, truncate as before), yes to wrap at the width of the tab bar, or a
number to wrap at that many cells.

Wrapping happens on grapheme boundaries so a line break can never land inside a
multi-codepoint grapheme, and SGR escapes are treated as zero width so colors
from tab_title_template neither consume cells nor get split in half. Wrapping is
bounded by tab_title_max_lines, and when a title needs more lines than it is
allowed the last line it gets is truncated with an ellipsis, which also makes
dropped lines visible for titles containing explicit newlines.

Only vertical tab bars are affected, since wrapping requires more than one row.
2026-08-01 09:18:15 -07:00
..
_static
_templates
kittens docs: add kitty-action-menu to user kittens list 2026-07-27 11:24:20 +02:00
screenshots
actions.rst
basic.rst
binary.rst
build.rst
changelog.rst Vertical tabs: add tab_title_wrap to wrap long titles 2026-08-01 09:18:15 -07:00
clipboard.rst
color-stack.rst
conf.py ... 2026-07-04 09:23:16 +05:30
conf.rst
deccara.rst
desktop-notifications.rst
dnd-protocol.rst
extract-rst-targets.py
faq.rst
file-transfer-protocol.rst
glossary.rst ... 2026-07-14 08:15:47 +05:30
graphics-protocol.rst Add desktui to the list of applications using the graphics protocol 2026-07-29 00:06:55 +02:00
index.rst
installer.sh
integrations.rst
intro_vid.rst
invocation.rst
keyboard-protocol.rst
kittens_intro.rst
launch.rst
layouts.rst
Makefile
mapping.rst
marks.rst
misc-protocol.rst
multiple-cursors-protocol.rst
notifications.py
open_actions.rst
overview.rst
performance.rst
pipe.rst
pointer-shapes.rst
press-mentions.rst
protocol-extensions.rst
quake-screenshots.rst
quickstart.rst
rc_protocol.rst
remote-control.rst
requirements.txt
sessions.rst
shell-integration.rst
support.html
support.rst
text-sizing-protocol.rst
underlines.rst
unscroll.rst
wide-gamut-colors.rst