CERBERUS/kitty
1
0
Fork 0
mirror of https://github.com/kovidgoyal/kitty.git synced 2026-05-13 16:37:27 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 3

better example of conditional key mapping

Browse source
This commit is contained in:
Kovid Goyal 2024-01-29 21:58:10 +05:30
parent d730c189db
commit 9b8ee54034
No known key found for this signature in database
GPG key ID: 06BC317B515ACE7C
1 changed files with 7 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

9
docs/mapping.rst
View file

@ -189,9 +189,10 @@ has :code:`keyboard protocol` in its title. Run the show-key kitten as::
Press :kbd:`ctrl+shift+t` and instead of a new tab opening, you will
see the key press being reported by the kitten. :code:`--when-focus-on` can test
the focused window using very powerful criteria, see :ref:`search_syntax` for
details. A more practical example unmaps the key when the focused window is running vim::
details. A more practical example unmaps the key when the focused window is
running an editor::
map --when-focus-on var:in_editor
map --when-focus-on var:in_editor kitty_mod+c
In order to make this work, you need to configure your editor as show below:
@ -224,6 +225,10 @@ In order to make this work, you need to configure your editor as show below:
})
These cause the editor to set the :code:`in_editor` variable in kitty and unset it when exiting.
As a result, the :kbd:`ctrl+shift+c` key will be passed to the editor instead of
copying to clipboard. In the editor, you can map it to copy to the clipboard,
thereby allowing use of a common shortcut both inside and outside the editor
for copying to clipboard.
Sending arbitrary text or keys to the program running in kitty
--------------------------------------------------------------------------------