From 7e7caea29bc71b4c9476efdbcb75e18df040f4fb Mon Sep 17 00:00:00 2001 From: hongyi-chen Date: Mon, 3 Aug 2026 10:08:20 +0000 Subject: [PATCH 1/6] docs: copy-edit sweep for terminal docs Fix typos, punctuation, and unclear phrasing; normalize keyboard shortcuts, heading case, and UI element formatting per AGENTS.md. Also restores the Apple logo character (U+F8FF) that had been stripped from four macOS system menu paths. Co-Authored-By: Oz --- .../terminal/appearance/blocks-behavior.mdx | 6 +- .../terminal/appearance/custom-themes.mdx | 4 +- .../terminal/appearance/input-position.mdx | 22 ++++---- .../docs/terminal/appearance/prompt.mdx | 8 +-- .../appearance/size-opacity-blurring.mdx | 2 +- .../terminal/appearance/tabs-behavior.mdx | 4 +- .../terminal/appearance/text-fonts-cursor.mdx | 8 +-- .../docs/terminal/appearance/themes.mdx | 4 +- .../docs/terminal/blocks/block-actions.mdx | 34 +++++------ .../docs/terminal/blocks/block-basics.mdx | 56 +++++++++---------- .../docs/terminal/blocks/block-filtering.mdx | 12 ++-- .../docs/terminal/blocks/block-sharing.mdx | 10 ++-- src/content/docs/terminal/blocks/find.mdx | 6 +- src/content/docs/terminal/blocks/index.mdx | 2 +- .../terminal/blocks/sticky-command-header.mdx | 12 ++-- .../command-completions/autosuggestions.mdx | 20 +++---- .../command-completions/completions.mdx | 14 ++--- src/content/docs/terminal/command-palette.mdx | 8 +-- .../docs/terminal/comparisons/performance.mdx | 6 +- .../comparisons/terminal-features.mdx | 2 +- .../docs/terminal/editor/alias-expansion.mdx | 16 +++--- .../terminal/editor/command-inspector.mdx | 6 +- src/content/docs/terminal/editor/index.mdx | 8 +-- .../editor/syntax-error-highlighting.mdx | 10 ++-- src/content/docs/terminal/editor/vim.mdx | 4 +- .../terminal/entry/command-corrections.mdx | 4 +- .../docs/terminal/entry/command-history.mdx | 6 +- .../docs/terminal/entry/command-search.mdx | 6 +- .../terminal/entry/synchronized-inputs.mdx | 16 +++--- .../docs/terminal/entry/yaml-workflows.mdx | 12 ++-- .../docs/terminal/input/classic-input.mdx | 10 ++-- .../docs/terminal/input/universal-input.mdx | 30 +++++----- .../terminal/integrations-and-plugins.mdx | 14 ++--- .../terminal/more-features/accessibility.mdx | 20 +++---- .../terminal/more-features/audible-bell.mdx | 2 +- .../more-features/files-and-links.mdx | 16 +++--- .../more-features/full-screen-apps.mdx | 10 ++-- .../docs/terminal/more-features/linux.mdx | 2 +- .../more-features/markdown-viewer.mdx | 18 +++--- .../terminal/more-features/notifications.mdx | 10 ++-- .../terminal/more-features/quit-warning.mdx | 14 ++--- .../terminal/more-features/settings-sync.mdx | 8 +-- .../terminal/more-features/text-selection.mdx | 8 +-- .../more-features/working-directory.mdx | 10 ++-- .../sessions/launch-configurations.mdx | 8 +-- .../terminal/sessions/session-navigation.mdx | 6 +- .../terminal/sessions/session-restoration.mdx | 6 +- .../docs/terminal/warpify/ssh-legacy.mdx | 6 +- .../docs/terminal/warpify/subshells.mdx | 18 +++--- .../docs/terminal/windows/global-hotkey.mdx | 16 +++--- src/content/docs/terminal/windows/index.mdx | 2 +- .../docs/terminal/windows/split-panes.mdx | 34 +++++------ .../docs/terminal/windows/tab-configs.mdx | 2 +- src/content/docs/terminal/windows/tabs.mdx | 48 ++++++++-------- 54 files changed, 323 insertions(+), 323 deletions(-) diff --git a/src/content/docs/terminal/appearance/blocks-behavior.mdx b/src/content/docs/terminal/appearance/blocks-behavior.mdx index ac4661304..20f12ac87 100644 --- a/src/content/docs/terminal/appearance/blocks-behavior.mdx +++ b/src/content/docs/terminal/appearance/blocks-behavior.mdx @@ -17,7 +17,7 @@ Warp offers the option to enable Compact mode, which condenses the spacing betwe Compact mode is disabled by default, but can be toggled in the following ways: * Navigate to **Settings** > **Appearance** > **Blocks** > **Compact Mode**. -* Utilize the [Command Palette](/terminal/command-palette/), then search for "Compact mode" to toggle. +* Use the [Command Palette](/terminal/command-palette/), then search for "Compact mode" to toggle. :::note Warp will open with the same compact settings in future sessions. @@ -27,13 +27,13 @@ Warp will open with the same compact settings in future sessions. ## Block dividers -Warp [Blocks](/terminal/blocks/) are divided by horizontal lines that separate individual command input and output, they create a visual break between different commands that you run in a session. +Warp [Blocks](/terminal/blocks/) are divided by horizontal lines that separate individual command input and output. These lines create a visual break between different commands that you run in a session. ### How to toggle block dividers Block dividers are enabled by default, but can be toggled in the following ways: * Navigate to **Settings** > **Appearance** > **Blocks** > **Show block dividers**. -* Utilize the [Command Palette](/terminal/command-palette/), then search for "Block Dividers". +* Use the [Command Palette](/terminal/command-palette/), then search for "Block Dividers". diff --git a/src/content/docs/terminal/appearance/custom-themes.mdx b/src/content/docs/terminal/appearance/custom-themes.mdx index 81bd4fadf..eaf33f9ff 100644 --- a/src/content/docs/terminal/appearance/custom-themes.mdx +++ b/src/content/docs/terminal/appearance/custom-themes.mdx @@ -15,7 +15,7 @@ Examples and a collection of themes can be found in the [Warp themes repository] ## Warp's custom theme repository -We have a [repository of themes hosted on GitHub.](https://github.com/warpdotdev/themes) +We have a [repository of themes hosted on GitHub](https://github.com/warpdotdev/themes). Each theme has a preview generated in the README. @@ -259,7 +259,7 @@ If your theme has an intended custom background image, include a comment in the ## Community -All other Warp-related things can be discussed, please [contact us](/support-and-community/troubleshooting-and-support/sending-us-feedback/). +For anything else Warp-related, please [contact us](/support-and-community/troubleshooting-and-support/sending-us-feedback/). ## Open source dependencies diff --git a/src/content/docs/terminal/appearance/input-position.mdx b/src/content/docs/terminal/appearance/input-position.mdx index d20064919..fd080dea3 100644 --- a/src/content/docs/terminal/appearance/input-position.mdx +++ b/src/content/docs/terminal/appearance/input-position.mdx @@ -7,9 +7,9 @@ description: >- import { Tabs, TabItem } from '@astrojs/starlight/components'; import VideoEmbed from '@components/VideoEmbed.astro'; -You can select from three different input positions, which each have different modes of behavior for the flow of input/output Blocks. +You can select from three different input positions, each with different behavior for the flow of input and output Blocks. -
Input positionBehavior
Start at the top (Classic mode)When you select “start at the top,” the prompt with input will initiate at the top of the view and move down in the view as you enter commands. Blocks of input/output will stack above the prompt and command input. You can scroll up or navigate up to visit past commands. You can enter CTRL-L or the clear command at any time to return the input to the top of the screen while still maintaining your scroll history.
Pin to the top (Reverse mode)When you select “pin to the top,” the prompt with input will display pinned to the top of your terminal view. Blocks of grouped input/output will flow down the view in reverse order with your latest results at the top. You can scroll down or navigate down to visit past commands. For long-running commands, you can also click "Lock scrolling at bottom of block" to continue to follow the stdout.
Pin to the bottom (Warp mode)Warp mode starts with input pinned to the bottom of your terminal view. Blocks of grouped input/output flow up and out of view. You can scroll up or navigate up to visit past commands.
+
Input positionBehavior
Start at the top (Classic mode)When you select “start at the top,” the prompt with input will initiate at the top of the view and move down in the view as you enter commands. Blocks of input/output will stack above the prompt and command input. You can scroll up or navigate up to visit past commands. You can enter Ctrl+L or the clear command at any time to return the input to the top of the screen while still maintaining your scroll history.
Pin to the top (Reverse mode)When you select “pin to the top,” the prompt with input will display pinned to the top of your terminal view. Blocks of grouped input/output will flow down the view in reverse order with your latest results at the top. You can scroll down or navigate down to visit past commands. For long-running commands, you can also click Lock scrolling at bottom of block to continue to follow the stdout.
Pin to the bottom (Warp mode)Warp mode starts with input pinned to the bottom of your terminal view. Blocks of grouped input/output flow up and out of view. You can scroll up or navigate up to visit past commands.
## How to access it @@ -24,19 +24,19 @@ Changes to the input position take place immediately and apply to all open panes - * `CMD-K` will clear the entire list of input/output blocks for a clean view - * `CTRL-L` will move the list of input/output blocks outside of the view and past the scroll so you have a clean view and the ability to easily visit past commands - * For long Blocks, you can press `SHIFT-CMD-UP`/`SHIFT-CMD-DOWN` to scroll to the top/bottom of the selected block. + * `⌘+K` will clear the entire list of input/output blocks for a clean view + * `Ctrl+L` will move the list of input/output blocks outside of the view and past the scroll so you have a clean view and the ability to easily visit past commands + * For long Blocks, you can press `⌘+Shift+↑`/`⌘+Shift+↓` to scroll to the top/bottom of the selected block. - * `CTRL-SHIFT-K` will clear the entire list of input/output blocks for a clean view - * `CTRL-L` will move the list of input/output blocks outside of the view and past the scroll so you have a clear view and the ability to easily visit past commands - * For long Blocks, you can press `CTRL-SHIFT-UP`/`CTRL-SHIFT-DOWN` to scroll to the top/bottom of the selected block. + * `Ctrl+Shift+K` will clear the entire list of input/output blocks for a clean view + * `Ctrl+L` will move the list of input/output blocks outside of the view and past the scroll so you have a clear view and the ability to easily visit past commands + * For long Blocks, you can press `Ctrl+Shift+↑`/`Ctrl+Shift+↓` to scroll to the top/bottom of the selected block. - * `CTRL-SHIFT-K` will clear the entire list of input/output blocks for a clean view - * `CTRL-L` will move the list of input/output blocks outside of the view and past the scroll so you have a clear view and the ability to easily visit past commands - * For long Blocks, you can press `CTRL-SHIFT-UP`/`CTRL-SHIFT-DOWN` to scroll to the top/bottom of the selected block. + * `Ctrl+Shift+K` will clear the entire list of input/output blocks for a clean view + * `Ctrl+L` will move the list of input/output blocks outside of the view and past the scroll so you have a clear view and the ability to easily visit past commands + * For long Blocks, you can press `Ctrl+Shift+↑`/`Ctrl+Shift+↓` to scroll to the top/bottom of the selected block. diff --git a/src/content/docs/terminal/appearance/prompt.mdx b/src/content/docs/terminal/appearance/prompt.mdx index d790297ac..adfba0d54 100644 --- a/src/content/docs/terminal/appearance/prompt.mdx +++ b/src/content/docs/terminal/appearance/prompt.mdx @@ -76,12 +76,12 @@ To enable the Shell prompt: 3. Configure your PS1 variable in your shell's RC file, or install a supported prompt plugin. :::note -The PS1 is a variable used by the shell to generate the prompt, it represents the primary prompt string (hence the "PS") - which the terminal typically displays before typing new commands. +The PS1 is a variable used by the shell to generate the prompt. It represents the primary prompt string (hence "PS"), which the terminal typically displays before you type new commands. ::: ### Multi-line and right-sided prompts -The Shell prompt supports multi-line or right-sided prompts in zsh and fish, not bash. However, you can't have a multiline right-side prompt, only a multiline left prompt. +The Shell prompt supports multi-line or right-sided prompts in zsh and fish, not bash. However, you can't have a multi-line right-side prompt, only a multi-line left prompt. :::note If you want to add a new line to your Shell prompt, run the following based on your shell or prompt: @@ -210,7 +210,7 @@ Although Warp does have support for prezto's prompt, enabling the [prezto utilit ### Disabling unsupported prompts for Warp -We advise using Warp's default prompt or installing one of the supported tools, see [Compatibility Table](/terminal/appearance/prompt/#shell-prompt-compatibility-table). You can disable unsupported prompts for Warp as such: +We advise using Warp's default prompt or installing one of the supported tools. See the [Compatibility Table](/terminal/appearance/prompt/#shell-prompt-compatibility-table). You can disable unsupported prompts for Warp as such: ``` if [[ $TERM_PROGRAM != "WarpTerminal" ]]; then @@ -224,7 +224,7 @@ fi #### iTerm2 -The iTerm2 shell integration breaks Warp and your custom prompt will not be able to be visible with this on. If you're coming from iTerm2 please check your dotfiles for it. We advise disabling the integration for Warp like so: +The iTerm2 shell integration breaks Warp, and your custom prompt won't be visible while it's on. If you're coming from iTerm2, check your dotfiles for it. We advise disabling the integration for Warp like so: ``` if [[ $TERM_PROGRAM != "WarpTerminal" ]]; then diff --git a/src/content/docs/terminal/appearance/size-opacity-blurring.mdx b/src/content/docs/terminal/appearance/size-opacity-blurring.mdx index 75e761767..e1c1b96c8 100644 --- a/src/content/docs/terminal/appearance/size-opacity-blurring.mdx +++ b/src/content/docs/terminal/appearance/size-opacity-blurring.mdx @@ -15,7 +15,7 @@ import VideoEmbed from '@components/VideoEmbed.astro'; To access size settings, go to **Settings** > **Appearance** > **Window**. -* Enable "Open new windows with custom size", then configure your preferred columns and rows. +* Enable **Open new windows with custom size**, then configure your preferred columns and rows. :::note If [Session Restoration](/terminal/sessions/session-restoration/) is enabled, Warp will restore the size of the last window closed when you quit the app. Either make sure the custom-sized window is the last one closed, or disable Session Restoration to ensure Warp launches with the custom-sized window. diff --git a/src/content/docs/terminal/appearance/tabs-behavior.mdx b/src/content/docs/terminal/appearance/tabs-behavior.mdx index 21dd64e01..f6a57f447 100644 --- a/src/content/docs/terminal/appearance/tabs-behavior.mdx +++ b/src/content/docs/terminal/appearance/tabs-behavior.mdx @@ -10,7 +10,7 @@ import DemoVideo from '@components/DemoVideo.astro'; ## Tab indicators -Tab indicators provide visual cues in the tab bar under certain specific conditions: When the current pane is maximized, when panes or tabs are synchronized, and when a command exits with an error. These indicators serve as quick references. +Tab indicators provide visual cues in the tab bar under specific conditions: when the current pane is maximized, when panes or tabs are synchronized, and when a command exits with an error. These indicators serve as quick references. ### How to toggle tab indicators @@ -46,6 +46,6 @@ You can configure the position of the tab close button to be either on the left Navigate to **Settings** > **Appearance** > **Tabs** > **Tab close button position**, then choose from the following options: * Left - the close button will be on the left side of the tab (macOS style) -* Right – the close button will be on the right side of the tab (Windows | Linux style)\ +* Right - the close button will be on the right side of the tab (Windows | Linux style)\ diff --git a/src/content/docs/terminal/appearance/text-fonts-cursor.mdx b/src/content/docs/terminal/appearance/text-fonts-cursor.mdx index 1aafb2aff..8084738e1 100644 --- a/src/content/docs/terminal/appearance/text-fonts-cursor.mdx +++ b/src/content/docs/terminal/appearance/text-fonts-cursor.mdx @@ -10,7 +10,7 @@ sidebar: import VideoEmbed from '@components/VideoEmbed.astro'; :::note -Once a new font is installed in your system, you need to restart Warp for it to show on the list of options. You may also need to check "View all available system fonts" to see the new font. +Once a new font is installed in your system, you need to restart Warp for it to show on the list of options. You may also need to select **View all available system fonts** to see the new font. ::: ## How to use it @@ -29,7 +29,7 @@ From there you can customize: * The default setting prevents text from being blurry on low-DPI displays. :::caution -On Linux, Warp does not support the "Use thin strokes" feature. +On Linux, Warp does not support the **Use thin strokes** feature. ::: * Enforce minimum contrast @@ -47,10 +47,10 @@ To access it, go to **Settings** > **Appearance** > **Cursor** From there you can customize: * Set the cursor type to Bar, Block, or Underline. -* Toggle the Blinking cursor or from the [Command Palette](/terminal/command-palette/), type "Cursor blink" and toggle the setting. +* Toggle **Blinking cursor**, or type "Cursor blink" in the [Command Palette](/terminal/command-palette/) and toggle the setting. :::note -Cursor type preference is disabled while [Vim keybindings](/terminal/editor/vim/) (vim mode) is active. +Cursor type preference is disabled while [Vim keybindings](/terminal/editor/vim/) (vim mode) are active. ::: ## How it works diff --git a/src/content/docs/terminal/appearance/themes.mdx b/src/content/docs/terminal/appearance/themes.mdx index 78ef38856..ec0f87d0a 100644 --- a/src/content/docs/terminal/appearance/themes.mdx +++ b/src/content/docs/terminal/appearance/themes.mdx @@ -51,14 +51,14 @@ Automatically create new themes based on a background image. 1. Go to **Settings** > **Appearance** > **Themes** or search "Open theme picker" within the [Command Palette](/terminal/command-palette/). 2. Click the **+** button in the theme picker. 3. Upload the image and select the background color. -4. Click "Create Theme" to save and accept the new theme. +4. Click **Create Theme** to save and accept the new theme. ### OS theme sync Warp supports synchronizing your theme with the OS’s light and dark themes. To enable this: 1. Open the **Settings** > **Appearance** dialog. -2. Click the toggle "Sync with OS". +2. Toggle **Sync with OS**. 3. You will then be able to select a specific theme for when the OS is in light mode and dark mode. ## How it works diff --git a/src/content/docs/terminal/blocks/block-actions.mdx b/src/content/docs/terminal/blocks/block-actions.mdx index 6d355d7a3..8b32add42 100644 --- a/src/content/docs/terminal/blocks/block-actions.mdx +++ b/src/content/docs/terminal/blocks/block-actions.mdx @@ -20,9 +20,9 @@ There are 2 ways you can access Block actions. ## Copy input / output of block -For command blocks, you can `RIGHT-CLICK` on a Block or click the context menu and copy the Block command, output, or both. +For command blocks, you can right-click on a Block or click the context menu and copy the Block command, output, or both. -For AI blocks, you can `RIGHT-CLICK` to copy the prompt, output, both, or the entire conversation. +For AI blocks, you can right-click to copy the prompt, output, both, or the entire conversation. @@ -39,38 +39,38 @@ Quickly navigate to important Blocks despite where they are in the terminal hist Ways to bookmark a Block: 1. Select **Toggle bookmark** in the block context menu - 2. Use `CMD-B` keybinding to bookmark a selected block + 2. Use `⌘+B` keybinding to bookmark a selected block Navigate to a bookmarked Block, by: * Clicking on the indicator.\ The indicator position reflects the approximate position of the Block in the Block history. Hovering over the indicator will give a snapshot of the Block including its prompt, command, and the last two lines of output. - * Pressing `OPTION-UP` and `OPTION-DOWN` + * Pressing `⌥+↑` and `⌥+↓` Ways to bookmark a Block: 1. Select **Toggle bookmark** in the block context menu - 2. Use `CTRL-SHIFT-B` keybinding to bookmark a selected block + 2. Use `Ctrl+Shift+B` keybinding to bookmark a selected block Navigate to a bookmarked Block, by: * Clicking on the indicator.\ The indicator position reflects the approximate position of the Block in the Block history. Hovering over the indicator will give a snapshot of the Block including its prompt, command, and the last two lines of output. - * Pressing `ALT-UP` and `ALT-DOWN` + * Pressing `Alt+↑` and `Alt+↓` Ways to bookmark a Block: 1. Click on the bookmark icon in the top right corner of a Block 2. Select **Toggle bookmark** in the block context menu - 3. Use `CTRL-SHIFT-B` keybinding to bookmark a selected block + 3. Use `Ctrl+Shift+B` keybinding to bookmark a selected block Navigate to a bookmarked Block, by: * Clicking on the indicator.\ The indicator position reflects the approximate position of the Block in the Block history. Hovering over the indicator will give a snapshot of the Block including its prompt, command, and the last two lines of output. - * Pressing `ALT-UP` and `ALT-DOWN` + * Pressing `Alt+↑` and `Alt+↓` @@ -86,13 +86,13 @@ Quickly find important information within a Block. See the [Find page](/terminal - With a Block selected, press "Find Within Block" or use `CMD-F` to search within a Block. + With a Block selected, press **Find Within Block** or use `⌘+F` to search within a Block. - With a Block selected, press "Find Within Block" or use `CTRL-SHIFT-F` to search within a Block. + With a Block selected, press **Find Within Block** or use `Ctrl+Shift+F` to search within a Block. - With a Block selected, press "Find Within Block" or use `CTRL-SHIFT-F` to search within a Block. + With a Block selected, press **Find Within Block** or use `Ctrl+Shift+F` to search within a Block. @@ -104,15 +104,15 @@ Filter the output lines of a block natively in Warp to quickly focus on a subset - * Using the keybinding `OPT-SHIFT-F` by default to toggle filtering on the selected or latest block - * Selecting `Toggle Block Filter` in the block context menu + * Using the keybinding `⌥+Shift+F` by default to toggle filtering on the selected or latest block + * Selecting **Toggle Block Filter** in the block context menu - * Using the keybinding `ALT-SHIFT-F` to toggle filtering on the selected or latest block - * Selecting `Toggle Block Filter` in the block context menu + * Using the keybinding `Alt+Shift+F` to toggle filtering on the selected or latest block + * Selecting **Toggle Block Filter** in the block context menu - * Using the keybinding `ALT-SHIFT-F` to toggle filtering on the selected or latest block - * Selecting `Toggle Block Filter` in the block context menu + * Using the keybinding `Alt+Shift+F` to toggle filtering on the selected or latest block + * Selecting **Toggle Block Filter** in the block context menu diff --git a/src/content/docs/terminal/blocks/block-basics.mdx b/src/content/docs/terminal/blocks/block-basics.mdx index 07a86d852..dfebc53b9 100644 --- a/src/content/docs/terminal/blocks/block-basics.mdx +++ b/src/content/docs/terminal/blocks/block-basics.mdx @@ -17,14 +17,14 @@ import VideoEmbed from '@components/VideoEmbed.astro'; :::note Try it yourself!\ -Type `xyz` (or some other command that doesn’t exist) and hit `ENTER` +Type `xyz` (or some other command that doesn’t exist) and hit `Enter` ::: ## Create a block -1. Execute a command (type `ls` and hit `ENTER`) in the Input Editor at the bottom of the screen. +1. Execute a command (type `ls` and hit `Enter`) in the Input Editor at the bottom of the screen. 2. Your command and output are grouped into a Block. -3. Try executing a different command (type `echo hello` and hit `ENTER`). +3. Try executing a different command (type `echo hello` and hit `Enter`). 4. Warp adds your newly created Block to the bottom (directly above the input editor). @@ -34,26 +34,26 @@ Type `xyz` (or some other command that doesn’t exist) and hit `ENTER` * Using your mouse: click on a Block. - * Or using your keyboard: hit `CMD-UP` (or `CMD-DOWN` if input is pinned up top) to select the most recently executed Block and use the `UP ↑` and `DOWN ↓` arrow keys to navigate to the desired Block. + * Or using your keyboard: hit `⌘+↑` (or `⌘+↓` if input is pinned up top) to select the most recently executed Block and use the `UP ↑` and `DOWN ↓` arrow keys to navigate to the desired Block. * For long Blocks: * You can click "Jump to the bottom of this block". - * You can press `SHIFT-CMD-UP`/`SHIFT-CMD-DOWN` to scroll to the top/bottom of the selected block. + * You can press `⌘+Shift+↑`/`⌘+Shift+↓` to scroll to the top/bottom of the selected block. * From the [Command Palette](/terminal/command-palette/), you can also "Scroll to the top/bottom of selected block". * Using your mouse: click on a Block. - * Or using your keyboard: hit `CTRL-UP` (or `CTRL-DOWN` if input is pinned up top) to select the most recently executed Block and use the `UP ↑` and `DOWN ↓` arrow keys to navigate to the desired Block. + * Or using your keyboard: hit `Ctrl+↑` (or `Ctrl+↓` if input is pinned up top) to select the most recently executed Block and use the `UP ↑` and `DOWN ↓` arrow keys to navigate to the desired Block. * For long Blocks: * You can click "Jump to the bottom of this block". - * You can press `CTRL-SHIFT-UP`/`CTRL-SHIFT-DOWN` to scroll to the top/bottom of the selected block. + * You can press `Ctrl+Shift+↑`/`Ctrl+Shift+↓` to scroll to the top/bottom of the selected block. * From the [Command Palette](/terminal/command-palette/), you can also "Scroll to the top/bottom of selected block". * Using your mouse: click on a Block. - * Or using your keyboard: hit `CTRL-UP` (or `CTRL-DOWN` if input is pinned up top) to select the most recently executed Block and use the `UP ↑` and `DOWN ↓` arrow keys to navigate to the desired Block. + * Or using your keyboard: hit `Ctrl+↑` (or `Ctrl+↓` if input is pinned up top) to select the most recently executed Block and use the `UP ↑` and `DOWN ↓` arrow keys to navigate to the desired Block. * For long Blocks: * You can click "Jump to the bottom of this block". - * You can press `CTRL-SHIFT-UP`/`CTRL-SHIFT-DOWN` to scroll to the top/bottom of the selected block. + * You can press `Ctrl+Shift+↑`/`Ctrl+Shift+↓` to scroll to the top/bottom of the selected block. * From the [Command Palette](/terminal/command-palette/), you can also "Scroll to the top/bottom of selected block". @@ -64,19 +64,19 @@ Type `xyz` (or some other command that doesn’t exist) and hit `ENTER` - * Click another Block while holding `CMD` to toggle the selection of that Block, or - * Click another Block while holding `SHIFT` to select a range of Blocks, or - * Use `SHIFT-UP ↑` or `SHIFT-DOWN ↓` to expand the active selection (the Block with the thicker border) up or down, respectively. + * Click another Block while holding `⌘` to toggle the selection of that Block, or + * Click another Block while holding `Shift` to select a range of Blocks, or + * Use `Shift+↑` or `Shift+↓` to expand the active selection (the Block with the thicker border) up or down, respectively. - * Click another Block while holding `CTRL-SHIFT` to toggle the selection of that Block, or - * Click another Block while holding `SHIFT` to select a range of Blocks, or - * Use `SHIFT-UP ↑` or `SHIFT-DOWN ↓` to expand the active selection (the Block with the thicker border) up or down, respectively. + * Click another Block while holding `Ctrl+Shift` to toggle the selection of that Block, or + * Click another Block while holding `Shift` to select a range of Blocks, or + * Use `Shift+↑` or `Shift+↓` to expand the active selection (the Block with the thicker border) up or down, respectively. - * Click another Block while holding `CTRL-SHIFT` to toggle the selection of that Block, or - * Click another Block while holding `SHIFT` to select a range of Blocks, or - * Use `SHIFT-UP ↑` or `SHIFT-DOWN ↓` to expand the active selection (the Block with the thicker border) up or down, respectively. + * Click another Block while holding `Ctrl+Shift` to toggle the selection of that Block, or + * Click another Block while holding `Shift` to select a range of Blocks, or + * Use `Shift+↑` or `Shift+↓` to expand the active selection (the Block with the thicker border) up or down, respectively. @@ -88,34 +88,34 @@ Type `xyz` (or some other command that doesn’t exist) and hit `ENTER` * **Mouse or scrollbar** - Scroll using your mouse, trackpad, or the scrollbar. * **Arrow keys** - Select a Block and use `UP ↑` and `DOWN ↓` to move between Blocks. - * **Page scrolling** - Press `PAGE UP` or `PAGE DOWN` to scroll by one page. - * **Jump to top or bottom** - Press `HOME` or `END` to scroll to the top or bottom of terminal output. - * **Scroll within a selected Block** - Press `SHIFT-CMD-UP` or `SHIFT-CMD-DOWN` to scroll to the top or bottom of the selected Block. + * **Page scrolling** - Press `Page Up` or `Page Down` to scroll by one page. + * **Jump to top or bottom** - Press `Home` or `End` to scroll to the top or bottom of terminal output. + * **Scroll within a selected Block** - Press `Ctrl+Shift+↑` or `Ctrl+Shift+↓` to scroll to the top or bottom of the selected Block. * **Scroll one line at a time** - "Scroll Terminal output up/down one line" can be configured with a keyboard shortcut in **Settings** > **Keyboard shortcuts** or accessed from the [Command Palette](/terminal/command-palette/). * When the output of a command is cut off, Warp keeps the [Sticky Command Header](/terminal/blocks/sticky-command-header/) pinned at the top that displays the command the Block corresponds to. Clicking the header will scroll the screen to the start of the Block. * **Mouse or scrollbar** - Scroll using your mouse, trackpad, or the scrollbar. * **Arrow keys** - Select a Block and use `UP ↑` and `DOWN ↓` to move between Blocks. - * **Page scrolling** - Press `PAGE UP` or `PAGE DOWN` to scroll by one page. - * **Jump to top or bottom** - Press `HOME` or `END` to scroll to the top or bottom of terminal output. - * **Scroll within a selected Block** - Press `CTRL-SHIFT-UP` or `CTRL-SHIFT-DOWN` to scroll to the top or bottom of the selected Block. + * **Page scrolling** - Press `Page Up` or `Page Down` to scroll by one page. + * **Jump to top or bottom** - Press `Home` or `End` to scroll to the top or bottom of terminal output. + * **Scroll within a selected Block** - Press `Ctrl+Shift+↑` or `Ctrl+Shift+↓` to scroll to the top or bottom of the selected Block. * **Scroll one line at a time** - "Scroll Terminal output up/down one line" can be configured with a keyboard shortcut in **Settings** > **Keyboard shortcuts** or accessed from the [Command Palette](/terminal/command-palette/). * When the output of a command is cut off, Warp keeps the [Sticky Command Header](/terminal/blocks/sticky-command-header/) pinned at the top that displays the command the Block corresponds to. Clicking the header will scroll the screen to the start of the Block. * **Mouse or scrollbar** - Scroll using your mouse, trackpad, or the scrollbar. * **Arrow keys** - Select a Block and use `UP ↑` and `DOWN ↓` to move between Blocks. - * **Page scrolling** - Press `PAGE UP` or `PAGE DOWN` to scroll by one page. - * **Jump to top or bottom** - Press `HOME` or `END` to scroll to the top or bottom of terminal output. - * **Scroll within a selected Block** - Press `CTRL-SHIFT-UP` or `CTRL-SHIFT-DOWN` to scroll to the top or bottom of the selected Block. + * **Page scrolling** - Press `Page Up` or `Page Down` to scroll by one page. + * **Jump to top or bottom** - Press `Home` or `End` to scroll to the top or bottom of terminal output. + * **Scroll within a selected Block** - Press `Ctrl+Shift+↑` or `Ctrl+Shift+↓` to scroll to the top or bottom of the selected Block. * **Scroll one line at a time** - "Scroll Terminal output up/down one line" can be configured with a keyboard shortcut in **Settings** > **Keyboard shortcuts** or accessed from the [Command Palette](/terminal/command-palette/). * When the output of a command is cut off, Warp keeps the [Sticky Command Header](/terminal/blocks/sticky-command-header/) pinned at the top that displays the command the Block corresponds to. Clicking the header will scroll the screen to the start of the Block. :::note -During long-running or full-screen commands, `PAGE UP`, `PAGE DOWN`, `HOME`, and `END` are forwarded to the running program. See the full list of scrolling shortcuts on the [Keyboard Shortcuts](/getting-started/keyboard-shortcuts/) page. +During long-running or full-screen commands, `Page Up`, `Page Down`, `Home`, and `End` are forwarded to the running program. See the full list of scrolling shortcuts on the [Keyboard Shortcuts](/getting-started/keyboard-shortcuts/) page. ::: diff --git a/src/content/docs/terminal/blocks/block-filtering.mdx b/src/content/docs/terminal/blocks/block-filtering.mdx index aa1c5f750..7214f320e 100644 --- a/src/content/docs/terminal/blocks/block-filtering.mdx +++ b/src/content/docs/terminal/blocks/block-filtering.mdx @@ -26,20 +26,20 @@ To apply a filter to a block: You can also toggle a filter by: - * Using the keybinding `OPT-SHIFT-F` by default to toggle filtering on the selected or latest block - * Selecting `Toggle Block Filter` in the block context menu + * Using the keybinding `⌥+Shift+F` by default to toggle filtering on the selected or latest block + * Selecting **Toggle Block Filter** in the block context menu You can also toggle a filter on/off by: - * Using the keybinding `ALT-SHIFT-F` to toggle filtering on the selected or latest block - * Selecting `Toggle Block Filter` in the block context menu + * Using the keybinding `Alt+Shift+F` to toggle filtering on the selected or latest block + * Selecting **Toggle Block Filter** in the block context menu You can also toggle a filter on/off by: - * Using the keybinding `ALT-SHIFT-F` to toggle filtering on the selected or latest block - * Selecting `Toggle Block Filter` in the block context menu + * Using the keybinding `Alt+Shift+F` to toggle filtering on the selected or latest block + * Selecting **Toggle Block Filter** in the block context menu diff --git a/src/content/docs/terminal/blocks/block-sharing.mdx b/src/content/docs/terminal/blocks/block-sharing.mdx index ee3a3fa6d..2b7e3562c 100644 --- a/src/content/docs/terminal/blocks/block-sharing.mdx +++ b/src/content/docs/terminal/blocks/block-sharing.mdx @@ -21,9 +21,9 @@ Share your blocks with a permalink or HTML embed. You can get started with share To share your blocks, follow these steps: - 1. On a finished block, click the context menu and select **Share...** or select the block and hit `CMD-SHIFT-S`. + 1. On a finished block, click the context menu and select **Share...** or select the block and hit `⌘+Shift+S`. 2. A modal will pop up that lets you title your block and customize it by selecting which parts of the block you want to share (e.g. command, output, prompt, etc.). - 3. Click either "Create link" or "Get embed" depending on how you want to share your block. + 3. Click either **Create link** or **Get embed** depending on how you want to share your block. 4. The link or embed snippet will be copied to your clipboard. @@ -31,7 +31,7 @@ Share your blocks with a permalink or HTML embed. You can get started with share 1. On a finished block, click the context menu and select **Share...**, or set up a key bind for Share Block in **Settings** > **Keyboard shortcuts**. 2. A modal will pop up that lets you title your block and customize it by selecting which parts of the block you want to share (e.g. command, output, prompt, etc.). - 3. Click either "Create link" or "Get embed" depending on how you want to share your block. + 3. Click either **Create link** or **Get embed** depending on how you want to share your block. 4. The link or embed snippet will be copied to your clipboard. @@ -39,7 +39,7 @@ Share your blocks with a permalink or HTML embed. You can get started with share 1. On a finished block, click the context menu and select **Share...**, or set up a key bind for Share Block in **Settings** > **Keyboard shortcuts**. 2. A modal will pop up that lets you title your block and customize it by selecting which parts of the block you want to share (e.g. command, output, prompt, etc.). - 3. Click either "Create link" or "Get embed" depending on how you want to share your block. + 3. Click either **Create link** or **Get embed** depending on how you want to share your block. 4. The link or embed snippet will be copied to your clipboard. @@ -58,7 +58,7 @@ Create and share a permalink to your blocks to collaborate with teammates. Here ## Embedded blocks -Create and embed your blocks on web pages to help your readers follow along with technical writing. Readers can interact with an embedded block as they would with a block in Warp, with a context menu and styling. When you click "Get embed", Warp will copy an `iframe` to your clipboard. Here's an example `iframe`: +Create and embed your blocks on web pages to help your readers follow along with technical writing. Readers can interact with an embedded block as they would with a block in Warp, with a context menu and styling. When you click **Get embed**, Warp will copy an `iframe` to your clipboard. Here's an example `iframe`: ```html