docs: add guide for setting quick terminal toggle keybind

This commit is contained in:
Ronit Gandhi
2024-12-28 10:12:15 +05:30
committed by Mitchell Hashimoto
parent bee2188014
commit 38643ec4fe
2 changed files with 11 additions and 1 deletions

View File

@ -1380,6 +1380,9 @@ keybind: Keybinds = .{},
/// * `center` - Terminal appears at the center of the screen. /// * `center` - Terminal appears at the center of the screen.
/// ///
/// Changing this configuration requires restarting Ghostty completely. /// Changing this configuration requires restarting Ghostty completely.
///
/// Note: There is no default keybind for toggling the quick terminal.
/// To enable this feature, bind the `toggle_quick_terminal` action to a key.
@"quick-terminal-position": QuickTerminalPosition = .top, @"quick-terminal-position": QuickTerminalPosition = .top,
/// The screen where the quick terminal should show up. /// The screen where the quick terminal should show up.

View File

@ -380,10 +380,17 @@ pub const Action = union(enum) {
/// is preserved between appearances, so you can always press the keybinding /// is preserved between appearances, so you can always press the keybinding
/// to bring it back up. /// to bring it back up.
/// ///
/// To enable the quick terminally globally so that Ghostty doesn't
/// have to be focused, prefix your keybind with `global`. Example:
///
/// ```ini
/// keybind = global:cmd+grave_accent=toggle_quick_terminal
/// ```
///
/// The quick terminal has some limitations: /// The quick terminal has some limitations:
/// ///
/// - It is a singleton; only one instance can exist at a time. /// - It is a singleton; only one instance can exist at a time.
/// - It does not support tabs. /// - It does not support tabs, but it does support splits.
/// - It will not be restored when the application is restarted /// - It will not be restored when the application is restarted
/// (for systems that support window restoration). /// (for systems that support window restoration).
/// - It supports fullscreen, but fullscreen will always be a non-native /// - It supports fullscreen, but fullscreen will always be a non-native