Konfigurasi, kustomisasi, pengaturan platform, dan referensi API untuk Pi.

tmux Pengaturan

Pi berfungsi di dalam tmux, tetapi tmux menghapus informasi pengubah dari kunci tertentu secara default. Tanpa konfigurasi, Shift+Enter dan Ctrl+Enter biasanya tidak dapat dibedakan dari Enter biasa.

Konfigurasi yang Direkomendasikan

Tambahkan ke ~/.tmux.conf:

set -g extended-keys on
set -g extended-keys-format csi-u

Kemudian mulai ulang tmux sepenuhnya:

tmux kill-server
tmux

Pi meminta pelaporan kunci yang diperluas secara otomatis ketika protokol keyboard Kitty tidak tersedia. Dengan extended-keys-format csi-u, tmux meneruskan kunci yang dimodifikasi dalam format CSI-u, yang merupakan konfigurasi paling andal. Opsi extended-keys-format memerlukan tmux 3.5 atau lebih baru.

Mengapa csi-u Direkomendasikan

Hanya dengan:

set -g extended-keys on

tmux defaultnya adalah extended-keys-format xterm. Ketika aplikasi meminta pelaporan kunci yang diperluas, kunci yang dimodifikasi diteruskan dalam format xterm modifyOtherKeys seperti:

  • Ctrl+C\x1b[27;5;99~
  • Ctrl+D\x1b[27;5;100~
  • Ctrl+Enter\x1b[27;5;13~

Dengan extended-keys-format csi-u, kunci yang sama diteruskan seperti:

  • Ctrl+C\x1b[99;5u
  • Ctrl+D\x1b[100;5u
  • Ctrl+Enter\x1b[13;5u

Pi mendukung kedua format, namun csi-u adalah pengaturan tmux yang direkomendasikan.

Apa yang Diperbaiki Ini

Tanpa kunci tambahan tmux, kunci Enter yang dimodifikasi akan diciutkan ke urutan lama:

Kunci Tanpa extkey Dengan csi-u
Memasuki \r \r
Shift+Masuk \r \x1b[13;2u
Ctrl+Masuk \r \x1b[13;5u
Alt/Opsi+Enter \x1b\r \x1b[13;3u

Hal ini mempengaruhi pengikatan kunci default (Enter untuk mengirimkan, Shift+Enter untuk baris baru) dan pengikatan kunci khusus apa pun yang menggunakan Enter yang dimodifikasi.

Persyaratan

  • tmux 3.5 atau lebih baru untuk extended-keys-format csi-u (jalankan tmux -V untuk memeriksa)
  • Emulator terminal yang mendukung kunci tambahan (Ghostty, Kitty, iTerm2, WezTerm, Windows Terminal)

Dengan tmux 3.2 hingga 3.4, hilangkan extended-keys-format csi-u; Pi masih mendukung format xterm modifyOtherKeys default tmux.