You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
78 lines
2.9 KiB
78 lines
2.9 KiB
[README-KeyTab] |
|
|
|
The keytabs shown in the Edit Profile dialog -> Keyboard tab are taken from |
|
*.keytab configuration files located in the system-wide location (typically |
|
/usr/share/applications/konsole on Linux) or the writable location in the |
|
user's home directory (typically ~/.local/share/applications/konsole on Linux). |
|
|
|
Keytabs allow users to configure the behavior of konsole on keyboard events, |
|
especially functions keys. Have a look at doc/user/README.keyboard. |
|
|
|
The syntax of each entry/rule follows the pattern: |
|
|
|
"key" Keyname { ("+"|"-") Modename } ":" (String|Operation) |
|
|
|
Key names are those defined in <qnamespace.h> with the "Qt::Key_" prefix |
|
removed. For a list of key names check the Qt::Key enum at: |
|
https://doc.qt.io/qt-5/qt.html#Key-enum |
|
|
|
Mode names are: |
|
|
|
- Shift : Shift Key pressed |
|
- Alt : Alt Key pressed |
|
- Control : Control Key pressed |
|
|
|
( The VT100 emulation has modes that can affect the sequences emitted |
|
by certain keys. Those modes are under control of the client program. |
|
|
|
- Newline : affects Return and Enter keys, when set makes them send |
|
both \r and \n control characters; when reset makes them |
|
send \r only. |
|
|
|
- Application : affects applications that use the Alternate Screen buffer. |
|
|
|
- Ansi : send ANSI escape and control sequences (v.s. sending VT52 |
|
escape and control sequences). |
|
|
|
Since sending a state to a program that has set the state itself is |
|
positivly wrong and obsolete design, better forget about this nasty |
|
detail. I may well remove this "feature" in a future clean up round. ) |
|
|
|
A "+" preceding a Modename means the Key/mode is pressed/active respectively. |
|
|
|
A "-" preceding a Modename means the Key/mode isn't pressed/active respectively. |
|
|
|
If a mode isn't present in a key combination, its state is ignored. |
|
|
|
Note that the combination of Key and Modes (set/reset) has to be unique. |
|
This means, that |
|
|
|
key A + Shift : "A" |
|
key A : "a" |
|
|
|
will not accept the small letter "a" rule as you'd exepct, you'll have |
|
to add a "- Shift" to the latter rule to make it work. |
|
Use the stdout/stderr dianostics of konsole when modifying keytabs to |
|
find problems like these. |
|
|
|
Supported operations are |
|
|
|
- scrollUpLine : scroll up one line in the history log |
|
- scrollUpPage : scroll up one page in the history log |
|
- scrollDownLine : scroll down one line in the history log |
|
- scrollDownPage : scroll down one page in the history log |
|
- scrollUpToTop : scroll up to the begining of the history log |
|
- scrollDownToBottom : scroll down to the end of the history log |
|
|
|
|
|
Strings have the syntax of C strings, |
|
one may use the following escapes: |
|
|
|
- \E - Escape |
|
- \\ - Backslash |
|
- \" - Double quote |
|
- \t - Tab |
|
- \r - Carriage Return |
|
- \n - New Line |
|
- \b - Backspace |
|
- \xHH - where HH are two hex digits (e.g. \x00 (the NUL character))
|
|
|