Mirror
/
zulip
mirror of https://github.com/zulip/zulip.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
zulip/help/keyboard-shortcuts.md

276 lines
8.3 KiB
Markdown
Raw Normal View History

docs: Rename documentation URLs and titles to be the same.
2017-01-25 00:37:21 +01:00
# Keyboard shortcuts
help: Wrap a bunch of very long lines. Now there are no lines longer than 140 characters here.
2017-01-05 23:35:54 +01:00
help: Update keyboard-shortcuts.md. Reorganizes shortcuts and rewords shortcut descriptions. Adds a new "the basics" section at the top. Does not add or remove any shortcuts.
2017-07-28 06:47:50 +02:00
Everything in Zulip can be done with the mouse, but mastering a few keyboard
help center: Improve documentation on the ? in-app reference. Adds a sentence at the end of the intro section of each help center page explaining that you can pull up a Keyboard shortcuts, Message formatting, and Search filters reference from inside the app. Adds/updates the in-app help section at the bottom of the page with instructions for opening the reference. Fixes #23758.
2022-12-06 23:23:43 +01:00
shortcuts will change your experience of the app. Start with the basics below,
and use the convenient [**keyboard shortcuts reference**](#keyboard-shortcuts-reference)
in the Zulip app to add more to your repertoire as needed.
docs: Correct bullet point formatting in keyboard shortcuts.
2017-05-12 03:46:24 +02:00
help: Update keyboard-shortcuts.md. Reorganizes shortcuts and rewords shortcut descriptions. Adds a new "the basics" section at the top. Does not add or remove any shortcuts.
2017-07-28 06:47:50 +02:00
* [The basics](#the-basics)
help: Reorganize keyboard shortcuts documentation. Also remove the unnecessary term "narrow".
2024-02-23 22:22:13 +01:00
* [Search](#search)
* [Scrolling](#scrolling)
docs: Add user guide for *Keyboard shortcuts* feature
2016-12-09 18:20:59 +01:00
* [Navigation](#navigation)
help: Update keyboard-shortcuts.md. Reorganizes shortcuts and rewords shortcut descriptions. Adds a new "the basics" section at the top. Does not add or remove any shortcuts.
2017-07-28 06:47:50 +02:00
* [Composing messages](#composing-messages)
user docs: Update keyboard shortcuts docs with Drafts modal shortcuts.
2017-05-13 03:24:17 +02:00
* [Message actions](#message-actions)
* [Drafts](#drafts)
help: Update keyboard-shortcuts.md. Reorganizes shortcuts and rewords shortcut descriptions. Adds a new "the basics" section at the top. Does not add or remove any shortcuts.
2017-07-28 06:47:50 +02:00
* [Menus](#menus)
help: Rename remaining 'stream' to 'channel' in '/help' docs.
2024-05-06 09:20:58 +02:00
* [Channel settings](#channel-settings)
docs: Add user guide for *Keyboard shortcuts* feature
2016-12-09 18:20:59 +01:00
help: Update keyboard-shortcuts.md. Reorganizes shortcuts and rewords shortcut descriptions. Adds a new "the basics" section at the top. Does not add or remove any shortcuts.
2017-07-28 06:47:50 +02:00
## The basics
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Reply to message**: <kbd>R</kbd> or <kbd>Enter</kbd> — Reply to the
selected message (outlined in blue).
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help: Rename remaining 'stream' to 'channel' in '/help' docs.
2024-05-06 09:20:58 +02:00
* **New channel message**: <kbd>C</kbd> — Start a new topic in the current
channel.
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help: Update "private message" -> "direct message" term. Updates all help center pages to match new DM term in Zulip UI.
2023-02-10 08:04:36 +01:00
* **New direct message**: <kbd>X</kbd>
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
copy_and_paste: Add documentation for keyboard shortcuts for pasting. Fixes: #29209.
2024-03-27 22:47:02 +01:00
* **Paste formatted text**: <kbd>Ctrl</kbd> + <kbd>V</kbd>
help: Document new way to remove pasted formatting.
2024-07-24 20:11:43 +02:00
* **Paste as plain text**: <kbd data-mac-following-key="⌥">Ctrl</kbd> +
<kbd>Shift</kbd> + <kbd>V</kbd>. You can also paste formatted text with
<kbd>Ctrl</kbd> + <kbd>V</kbd>, and press <kbd>Ctrl</kbd> + <kbd>Z</kbd> to
remove formatting.
copy_and_paste: Add documentation for keyboard shortcuts for pasting. Fixes: #29209.
2024-03-27 22:47:02 +01:00
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Cancel compose and save draft**: <kbd>Esc</kbd> or <kbd>Ctrl</kbd> +
<kbd>[</kbd> — Close the compose box and save the unsent message as a
draft.
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **View drafts**: <kbd>D</kbd> — Use the arrow keys and <kbd>Enter</kbd>
to restore a draft. Press <kbd>D</kbd> again to close.
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Next message**: <kbd class="arrow-key">↓</kbd> or <kbd>J</kbd>
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Last message**: <kbd>End</kbd> or <kbd>Shift</kbd> + <kbd>G</kbd> —
Also marks all messages in the current view as read.
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Next unread topic**: <kbd>N</kbd>
docs: Add user guide for *Keyboard shortcuts* feature
2016-12-09 18:20:59 +01:00
hotkey: Add 'narrow to next unread followed topic' hotkey. This commit adds a 'Shift + N' keyboard shortcut, which is used to narrow to the next unread followed topic. Fixes part of #27323.
2023-11-01 12:59:58 +01:00
* **Next unread followed topic**: <kbd>Shift</kbd> + <kbd>N</kbd>
help: Update "private message" -> "direct message" term. Updates all help center pages to match new DM term in Zulip UI.
2023-02-10 08:04:36 +01:00
* **Next unread direct message**: <kbd>P</kbd>
hotkeys: Add "p" to narrow to next unread PM thread. This works simimlar to the "n" key for next topics. This commit does a few things: * It wires up the hotkey to an existing function that could change narrows. * It adds documentation. * It adds logic to make sure the compose box does not open. @showell helped a bit with the wording of comments here. Fixes #4874
2018-02-16 15:56:25 +01:00
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Search messages**: <kbd>/</kbd>
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Toggle keyboard shortcuts view**: <kbd>?</kbd>
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
keyboard-shortcuts: Improve home view labels.
2024-04-17 21:20:54 +02:00
* **Go to your home view**: <kbd>Ctrl</kbd> + <kbd>[</kbd> (or
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
<kbd>Esc</kbd>, [if enabled][disable-escape])
keyboard-shortcuts: Improve home view labels.
2024-04-17 21:20:54 +02:00
until you are in your [home view](/help/configure-home-view).
display_settings: Allow user to set default_view. TextField is used to allow users to set long stream + topic narrow names in the urls. We currently restrict users to only set "all_messages" and "recent_topics" as narrows. This commit achieves 3 things: * Removes recent topics as the default view which loads when hash is empty. * Loads default_view when hash is empty. * Loads default_view on pressing escape key when it is unhandled by other present UI elements. NOTE: After this commit loading zulip with an empty hash will automatically set hash to default_view. Ideally, we'd just display the default view without a hash, but that involves extra complexity. One exception is when user is trying to load an overlay directly, i.e. zulip is loaded with an overlay hash. In this case, we render recent topics is background irrespective of default_view. We consider this last detail to be a bug not important enough to block adding this setting.
2021-03-10 13:56:10 +01:00
settings: Rename "default" views to "home" views in settings and docs. This commit renames "default" views to "home" views in the setting labels, keyboard shortcuts list, help documentation and its urls. This commit does not do changes in variable and class names, setting field in database, API docs and changelog. Fixes part of #27251.
2023-10-18 11:30:32 +02:00
[disable-escape]: /help/configure-home-view#configure-whether-esc-navigates-to-the-home-view
help: Reorganize keyboard shortcuts documentation. Also remove the unnecessary term "narrow".
2024-02-23 22:22:13 +01:00
## Search
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Search messages**: <kbd>/</kbd> or <kbd>Ctrl</kbd> + <kbd>K</kbd>
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help: Rename remaining 'stream' to 'channel' in '/help' docs.
2024-05-06 09:20:58 +02:00
* **Filter channels**: <kbd>Q</kbd>
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Search people**: <kbd>W</kbd>
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help: Reorganize keyboard shortcuts documentation. Also remove the unnecessary term "narrow".
2024-02-23 22:22:13 +01:00
## Scrolling
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Last message**: <kbd>End</kbd> or <kbd>Shift</kbd> + <kbd>G</kbd> —
Also marks all messages in the current view as read.
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **First message**: <kbd>Home</kbd>
help: Update keyboard-shortcuts.md. Reorganizes shortcuts and rewords shortcut descriptions. Adds a new "the basics" section at the top. Does not add or remove any shortcuts.
2017-07-28 06:47:50 +02:00
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Previous message**: <kbd class="arrow-key">↑</kbd> or <kbd>K</kbd>
help: Update keyboard-shortcuts.md. Reorganizes shortcuts and rewords shortcut descriptions. Adds a new "the basics" section at the top. Does not add or remove any shortcuts.
2017-07-28 06:47:50 +02:00
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Next message**: <kbd class="arrow-key">↓</kbd> or <kbd>J</kbd>
help: Update keyboard-shortcuts.md. Reorganizes shortcuts and rewords shortcut descriptions. Adds a new "the basics" section at the top. Does not add or remove any shortcuts.
2017-07-28 06:47:50 +02:00
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Scroll up**: <kbd>PgUp</kbd> or <kbd>Shift</kbd> + <kbd>K</kbd>
help: Update keyboard-shortcuts.md. Reorganizes shortcuts and rewords shortcut descriptions. Adds a new "the basics" section at the top. Does not add or remove any shortcuts.
2017-07-28 06:47:50 +02:00
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Scroll down**: <kbd>PgDn</kbd>, <kbd>Shift</kbd> + <kbd>J</kbd>, or
<kbd>Spacebar</kbd>
docs: Add user guide for *Keyboard shortcuts* feature
2016-12-09 18:20:59 +01:00
help: Reorganize keyboard shortcuts documentation. Also remove the unnecessary term "narrow".
2024-02-23 22:22:13 +01:00
## Navigation
hotkey: Correct Mac equivalent of Alt and handle exceptions separately. Though the correct mapping for Alt in Mac is Option, we had so far been mapping it to Command, since for the 2 pre-existing shortcuts that used Alt, Command was the only key that worked on Mac. However, these are exceptions. Now we map Alt to Option, and handle the 2 exceptions separately, using data attributes on those shortcut elements. This is a prep commit for introducing a hotkey that uses Alt / Option.
2024-01-25 16:02:04 +01:00
* **Go back through viewing history**: <kbd data-mac-key="⌘">Alt</kbd> +
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
<kbd class="arrow-key">←</kbd>
keyboard-shortcuts: Document browse back and forward in history. Documents in help center `/keyboard-shortcuts` and in the app `?` menu the shortcuts used by browsers for navigating back and forward through the open tab's history, which are made to work in Zulip. Also, updates `adjust_mac_shortcuts` to update the shortcut keys for users with Mac user agents. Fixes #18542.
2022-07-13 12:28:12 +02:00
hotkey: Correct Mac equivalent of Alt and handle exceptions separately. Though the correct mapping for Alt in Mac is Option, we had so far been mapping it to Command, since for the 2 pre-existing shortcuts that used Alt, Command was the only key that worked on Mac. However, these are exceptions. Now we map Alt to Option, and handle the 2 exceptions separately, using data attributes on those shortcut elements. This is a prep commit for introducing a hotkey that uses Alt / Option.
2024-01-25 16:02:04 +01:00
* **Go forward through viewing history**: <kbd data-mac-key="⌘">Alt</kbd> +
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
<kbd class="arrow-key">→</kbd>
keyboard-shortcuts: Document browse back and forward in history. Documents in help center `/keyboard-shortcuts` and in the app `?` menu the shortcuts used by browsers for navigating back and forward through the open tab's history, which are made to work in Zulip. Also, updates `adjust_mac_shortcuts` to update the shortcut keys for users with Mac user agents. Fixes #18542.
2022-07-13 12:28:12 +02:00
help: Reorganize keyboard shortcuts documentation. Also remove the unnecessary term "narrow".
2024-02-23 22:22:13 +01:00
* **Go to next unread topic**: <kbd>N</kbd>
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help: Reorganize keyboard shortcuts documentation. Also remove the unnecessary term "narrow".
2024-02-23 22:22:13 +01:00
* **Go to next unread direct message**: <kbd>P</kbd>
hotkeys: Add "p" to narrow to next unread PM thread. This works simimlar to the "n" key for next topics. This commit does a few things: * It wires up the hotkey to an existing function that could change narrows. * It adds documentation. * It adds logic to make sure the compose box does not open. @showell helped a bit with the wording of comments here. Fixes #4874
2018-02-16 15:56:25 +01:00
help: Reorganize keyboard shortcuts documentation. Also remove the unnecessary term "narrow".
2024-02-23 22:22:13 +01:00
* **Go to topic or DM conversation**: <kbd>S</kbd>
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help: Consistently refer to interleaved channel view as "channel feed".
2024-07-09 00:04:04 +02:00
* **Go to channel feed from topic view**: <kbd>S</kbd>
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help: Tweak keyboard navigation docs for combined and DM feeds.
2024-08-20 00:12:05 +02:00
* **Go to direct message feed**: <kbd>Shift</kbd> + <kbd>P</kbd>
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
hotkey: Add `z` shortcut to zoom to message `near` view. A new hotkey, lowercase `z` (for `zoom`) has been implemented to allow the user to go to the near view of the selected message with 1 keypress. Documentation has been added for this both in the help center, and the in-app `Keyboard shortcuts` menu. The effect is identical to clicking on a message's timestamp, which links to that message's near view. Fixes: #24227.
2023-02-01 11:58:08 +01:00
* **Zoom to message in conversation context**: <kbd>Z</kbd> — This view does not mark messages as read.
help: Rename remaining 'stream' to 'channel' in '/help' docs.
2024-05-06 09:20:58 +02:00
* **Cycle between channel views**: <kbd>Shift</kbd> + <kbd>A</kbd>
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
(previous) and <kbd>Shift</kbd> + <kbd>D</kbd> (next)
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help: Tweak keyboard navigation docs for combined and DM feeds.
2024-08-20 00:12:05 +02:00
* **Go to combined feed**: <kbd>A</kbd> — Shows all unmuted messages.
docs: Add user guide for *Keyboard shortcuts* feature
2016-12-09 18:20:59 +01:00
hotkey: Add keyboard shortcut to navigate to starred messages view. This commit adds '*' as a keyboard shortcut to navigate to the starred messages view and the shortcut is documented in various required locations accordingly. Fixes #31397.
2024-08-23 19:58:23 +02:00
* **Go to starred messages**: <kbd>*</kbd>
help: Reorganize keyboard shortcuts documentation. Also remove the unnecessary term "narrow".
2024-02-23 22:22:13 +01:00
* **Go to the conversation you are composing to**: <kbd>Ctrl</kbd> + <kbd>.</kbd>
hotkeys: Map `CTRL + .` to narrow to compose box target. Also adds relevant tests and documentation. We currently do not narrow to a new topic, and instead just narrow to the stream. Similarly, we do not narrow to a PM if any of the recipients are invalid.
2018-11-30 00:20:10 +01:00
help: Update keyboard-shortcuts.md. Reorganizes shortcuts and rewords shortcut descriptions. Adds a new "the basics" section at the top. Does not add or remove any shortcuts.
2017-07-28 06:47:50 +02:00
## Composing messages
help: Wrap a bunch of very long lines. Now there are no lines longer than 140 characters here.
2017-01-05 23:35:54 +01:00
help: Rename remaining 'stream' to 'channel' in '/help' docs.
2024-05-06 09:20:58 +02:00
* **New channel message**: <kbd>C</kbd> — For starting a new topic in a
channel.
help: Tweak docs on keyboard shortcuts for composing messages. - Adjust the order in keyboard shortucts help menu and help center. - Make minor wording improvements.
2023-05-29 03:36:58 +02:00
* **New direct message**: <kbd>X</kbd>
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Reply to message**: <kbd>R</kbd> or <kbd>Enter</kbd> — Reply to the
selected message (outlined in blue). Same behavior as clicking on the
message.
hotkeys: Document `u` hotkey.
2017-05-24 21:32:07 +02:00
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Quote and reply to message**: <kbd>></kbd>
hotkeys: Add '>' as a hotkey for quote and reply to message. Tweaked by tabbott to fix a few minor issues. Fixes #8146.
2018-01-31 04:23:02 +01:00
help: Tweak docs on keyboard shortcuts for composing messages. - Adjust the order in keyboard shortucts help menu and help center. - Make minor wording improvements.
2023-05-29 03:36:58 +02:00
* **Reply directly to sender**: <kbd>Shift</kbd> + <kbd>R</kbd>
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help: Tweak docs on keyboard shortcuts for composing messages. - Adjust the order in keyboard shortucts help menu and help center. - Make minor wording improvements.
2023-05-29 03:36:58 +02:00
* **Reply @-mentioning sender**: <kbd>@</kbd>
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help: Update keyboard-shortcuts.md. Reorganizes shortcuts and rewords shortcut descriptions. Adds a new "the basics" section at the top. Does not add or remove any shortcuts.
2017-07-28 06:47:50 +02:00
### In the compose box
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Send message**: <kbd>Enter</kbd>, <kbd>Tab</kbd> then <kbd>Enter</kbd>,
and/or <kbd>Ctrl</kbd> + <kbd>Enter</kbd>, depending on your settings. See
help: Restructure "Mastering the compose box" article. This help center article should include more features rather than just focusing on the "go to conversation" button. We should broaden and restructure this page to cover other advanced features. Refactors the "Go to conversation" section as step-by-step instructions, and adds a `keyboard_tip`. Adds new section "Toggle between Ctrl+Enter and Enter". Deletes the "Enable Enter to send" help center article, and adds its content as a new subheading in this section. Updates existing links accordingly and adds a URL redirect. Documents "Enable Control + Enter to send". Tweaks intro paragraph of "Mastering the compose box". Fixes: #22817.
2022-09-13 03:18:30 +02:00
[enable enter to send](/help/mastering-the-compose-box#toggle-between-ctrl-enter-and-enter-to-send-a-message).
docs: Update keyboard shortcuts documentation.
2017-06-16 06:55:07 +02:00
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Insert new line**: <kbd>Enter</kbd>, or <kbd>Shift</kbd> + <kbd>Enter</kbd>,
depending on your settings. See
help: Restructure "Mastering the compose box" article. This help center article should include more features rather than just focusing on the "go to conversation" button. We should broaden and restructure this page to cover other advanced features. Refactors the "Go to conversation" section as step-by-step instructions, and adds a `keyboard_tip`. Adds new section "Toggle between Ctrl+Enter and Enter". Deletes the "Enable Enter to send" help center article, and adds its content as a new subheading in this section. Updates existing links accordingly and adds a URL redirect. Documents "Enable Control + Enter to send". Tweaks intro paragraph of "Mastering the compose box". Fixes: #22817.
2022-09-13 03:18:30 +02:00
[enable enter to send](/help/mastering-the-compose-box#toggle-between-ctrl-enter-and-enter-to-send-a-message).
user docs: Update keyboard shortcuts docs with Drafts modal shortcuts.
2017-05-13 03:24:17 +02:00
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Insert italic text**: `*italic*` or <kbd>Ctrl</kbd> + <kbd>I</kbd>
* **Insert bold text**: `**bold**` or <kbd>Ctrl</kbd> + <kbd>B</kbd>
* **Insert link**: `[Zulip website](https://zulip.org)` or <kbd>Ctrl</kbd> +
<kbd>Shift</kbd> + <kbd>L</kbd>
help docs: Add message formatting keyboard shortcuts.
2019-06-10 09:21:04 +02:00
hotkey: Introduce hotkey Alt+P to toggle preview for compose box. On Mac, it's Option+P. Fixes: #18471.
2024-01-16 21:17:07 +01:00
* **Toggle preview mode**: <kbd>Alt</kbd> + <kbd>P</kbd>
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Cancel compose and save draft**: <kbd>Esc</kbd> or <kbd>Ctrl</kbd> +
<kbd>[</kbd> — Close the compose box and save the unsent message as a draft.
help: Update keyboard-shortcuts.md. Reorganizes shortcuts and rewords shortcut descriptions. Adds a new "the basics" section at the top. Does not add or remove any shortcuts.
2017-07-28 06:47:50 +02:00
## Message actions
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Edit last message**: <kbd class="arrow-key">←</kbd> — Open the last
editable message in the current view (if any).
help: Update keyboard-shortcuts.md. Reorganizes shortcuts and rewords shortcut descriptions. Adds a new "the basics" section at the top. Does not add or remove any shortcuts.
2017-07-28 06:47:50 +02:00
### For a selected message (outlined in blue)
actions_popover: Rename "View message source". This commit renames "View message source" to "View original message". The meaning of "original" in this context is very similar to what source/source code means in software jargon, while being easier to understand and translate for a non-tech savvy user.
2024-04-02 08:58:53 +02:00
* **Edit message or view original message**: <kbd>E</kbd>
hotkey: Reorder "Edit selected message or view source" in ? and /help.
2024-02-13 10:59:25 +01:00
popovers: Rename "profile summary" to "user card". This is a briefer and more intuitive name for this frequently accessed part of the Zulip UI.
2022-11-14 18:00:29 +01:00
* **Show message sender's user card**: <kbd>U</kbd>
user docs: Update keyboard shortcuts docs with Drafts modal shortcuts.
2017-05-13 03:24:17 +02:00
hotkey: Add `Shift` + `V` shortcut to toggle read receipts modal. The read receipts option, resides under the triple-dot message actions menu. This made the process of viewing the read receipts take up multiple steps, even via a keyboard-driven workflow. Via this commit, now while focused on any message in a message feed, and pressing `Shift` + `V`, efficiently brings up the read receipts for that message. Fixes part of #24716. Co-Authored-by: SameepAher <sameepaher@gmail.com>
2024-02-13 09:44:39 +01:00
* **View read receipts**: <kbd>Shift</kbd> + <kbd>V</kbd> — Same shortcut
also closes the read receipts menu (if open).
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **View image**: <kbd>V</kbd>
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
hotkey: Use "m" hotkey for moving messages. Fixes #23113.
2022-10-13 08:47:36 +02:00
* **Move message and (optionally) other messages in the same topic**: <kbd>M</kbd>
help: Update message edit history documentation. Co-authored-by: Tim Abbott <tabbott@zulip.com>
2023-07-28 01:54:07 +02:00
* **View message edit and move history**: <kbd>Shift</kbd> +
<kbd>H</kbd>. Message edit history [must be
enabled](/help/disable-message-edit-history).
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Star message**: <kbd>Ctrl</kbd> + <kbd>S</kbd>
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help: Update keyboard-shortcuts.md. Reorganizes shortcuts and rewords shortcut descriptions. Adds a new "the basics" section at the top. Does not add or remove any shortcuts.
2017-07-28 06:47:50 +02:00
* **React with <img alt=":thumbs_up:" class="emoji"
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
src="/static/generated/emoji/images/emoji/unicode/1f44d.png"
title="thumbs up"/>**: <kbd>+</kbd>
help: Update keyboard-shortcuts.md. Reorganizes shortcuts and rewords shortcut descriptions. Adds a new "the basics" section at the top. Does not add or remove any shortcuts.
2017-07-28 06:47:50 +02:00
help: Document `=` keyboard shortcut. Documents the new shortcut in the `?` menu, Keyboard Shortcuts page, and Emoji Reactions page.
2023-03-23 02:24:06 +01:00
* **Toggle first emoji reaction**: <kbd>=</kbd>
unread: Add UI support for marking messages as unread. Fixes #2676. Co-authored-by: Aman Agrawal <amanagr@zulip.com> Co-authored-by: Tim Abbott <tabbott@zulip.com>
2021-08-05 00:59:03 +02:00
* **Mark as unread from selected message**: <kbd>Shift</kbd> + <kbd>U</kbd>
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Collapse/show message**: <kbd>-</kbd>
help: Update keyboard-shortcuts.md. Reorganizes shortcuts and rewords shortcut descriptions. Adds a new "the basics" section at the top. Does not add or remove any shortcuts.
2017-07-28 06:47:50 +02:00
help: Improve documentation for Shift+M keyboard shortcut.
2024-03-19 23:47:33 +01:00
* **Toggle topic mute**: <kbd>Shift</kbd> + <kbd>M</kbd>. This works in both
message views and views that list topics (e.g., [inbox](/help/inbox), [recent
conversations](/help/recent-conversations)). Learn about [muted
topics](/help/mute-a-topic).
user docs: Update keyboard shortcuts docs with Drafts modal shortcuts.
2017-05-13 03:24:17 +02:00
recent-topics: Rename to "Recent conversations" in web-app and docs. Replaces instances of "recent topics" in the web-app and documentation to be "recent conversations". Renames both `recent-topics.md` files in the help center to be `recent-conversations.md` and updates/redirects links to new URL. Does not update instances of "recent topics" in frontend code comments and does not update the main overview changelog, for now. Does not change case study text where "recent topics" was referenced in a quote, but does change generic text references to be "recent conversations".
2022-10-12 19:54:34 +02:00
## Recent conversations
keyboard_shortcuts: Add hotkeys for recent topics.
2020-06-26 10:22:19 +02:00
recent-topics: Rename to "Recent conversations" in web-app and docs. Replaces instances of "recent topics" in the web-app and documentation to be "recent conversations". Renames both `recent-topics.md` files in the help center to be `recent-conversations.md` and updates/redirects links to new URL. Does not update instances of "recent topics" in frontend code comments and does not update the main overview changelog, for now. Does not change case study text where "recent topics" was referenced in a quote, but does change generic text references to be "recent conversations".
2022-10-12 19:54:34 +02:00
* **View recent conversations**: <kbd>T</kbd>
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
recent-topics: Rename to "Recent conversations" in web-app and docs. Replaces instances of "recent topics" in the web-app and documentation to be "recent conversations". Renames both `recent-topics.md` files in the help center to be `recent-conversations.md` and updates/redirects links to new URL. Does not update instances of "recent topics" in frontend code comments and does not update the main overview changelog, for now. Does not change case study text where "recent topics" was referenced in a quote, but does change generic text references to be "recent conversations".
2022-10-12 19:54:34 +02:00
* **Search recent conversations**: <kbd>T</kbd>
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
recent-topics: Rename to "Recent conversations" in web-app and docs. Replaces instances of "recent topics" in the web-app and documentation to be "recent conversations". Renames both `recent-topics.md` files in the help center to be `recent-conversations.md` and updates/redirects links to new URL. Does not update instances of "recent topics" in frontend code comments and does not update the main overview changelog, for now. Does not change case study text where "recent topics" was referenced in a quote, but does change generic text references to be "recent conversations".
2022-10-12 19:54:34 +02:00
* **Escape from recent conversations search**: <kbd>Esc</kbd> or arrow keys
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
recent-topics: Rename to "Recent conversations" in web-app and docs. Replaces instances of "recent topics" in the web-app and documentation to be "recent conversations". Renames both `recent-topics.md` files in the help center to be `recent-conversations.md` and updates/redirects links to new URL. Does not update instances of "recent topics" in frontend code comments and does not update the main overview changelog, for now. Does not change case study text where "recent topics" was referenced in a quote, but does change generic text references to be "recent conversations".
2022-10-12 19:54:34 +02:00
* **Navigate recent conversations**: Use arrow keys or vim keys
(<kbd>J</kbd>, <kbd>K</kbd>, <kbd>L</kbd>, <kbd>H</kbd>).
keyboard_shortcuts: Add hotkeys for recent topics.
2020-06-26 10:22:19 +02:00
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
Use <kbd>Enter</kbd> to engage with elements.
keyboard_shortcuts: Add hotkeys for recent topics.
2020-06-26 10:22:19 +02:00
user docs: Update keyboard shortcuts docs with Drafts modal shortcuts.
2017-05-13 03:24:17 +02:00
## Drafts
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Toggle drafts view**: <kbd>D</kbd>
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help: Update keyboard-shortcuts.md. Reorganizes shortcuts and rewords shortcut descriptions. Adds a new "the basics" section at the top. Does not add or remove any shortcuts.
2017-07-28 06:47:50 +02:00
### Within the drafts view
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Edit selected draft**: <kbd>Enter</kbd>
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Delete selected draft**: <kbd>Backspace</kbd>
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help: Add comma to all uses of "e.g." in help center docs.
2024-07-04 12:10:19 +02:00
Keyboard navigation (e.g., arrow keys) works as expected.
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help: Update keyboard-shortcuts.md. Reorganizes shortcuts and rewords shortcut descriptions. Adds a new "the basics" section at the top. Does not add or remove any shortcuts.
2017-07-28 06:47:50 +02:00
## Menus
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Toggle shortcuts help**: <kbd>?</kbd>
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Toggle gear menu**: <kbd>G</kbd>
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
hotkey: Make g + left / right arrow work to open navbar dropdowns. While gear menu is open, press right arrow to go to personal menu and left arrow to open gear menu again.
2023-10-21 01:28:30 +02:00
* **Open personal menu**: <kbd>G</kbd> + <kbd class="arrow-key">→</kbd>
help_menu: Extract help items from gear menu into a separate popover. Fixes #27202
2023-10-21 13:57:36 +02:00
* **Open help menu**: <kbd>G</kbd> + <kbd class="arrow-key">←</kbd>
help: Update keyboard-shortcuts.md. Reorganizes shortcuts and rewords shortcut descriptions. Adds a new "the basics" section at the top. Does not add or remove any shortcuts.
2017-07-28 06:47:50 +02:00
### For a selected message (outlined in blue)
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Toggle emoji reactions menu**: <kbd>:</kbd>
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Toggle message actions menu**: <kbd>I</kbd>
help: Update keyboard-shortcuts.md. Reorganizes shortcuts and rewords shortcut descriptions. Adds a new "the basics" section at the top. Does not add or remove any shortcuts.
2017-07-28 06:47:50 +02:00
help: Rename remaining 'stream' to 'channel' in '/help' docs.
2024-05-06 09:20:58 +02:00
## Channel settings
help: Update keyboard-shortcuts.md. Reorganizes shortcuts and rewords shortcut descriptions. Adds a new "the basics" section at the top. Does not add or remove any shortcuts.
2017-07-28 06:47:50 +02:00
help: Rename remaining 'stream' to 'channel' in '/help' docs.
2024-05-06 09:20:58 +02:00
* **Scroll through channels**: <kbd class="arrow-key">↑</kbd> and
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
<kbd class="arrow-key">↓</kbd>
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
!!! tip ""
help: Add newline after admonition header for Prettier compatibility. Signed-off-by: Anders Kaseorg <anders@zulip.com>
2021-09-10 00:44:29 +02:00
help: Rename remaining 'stream' to 'channel' in '/help' docs.
2024-05-06 09:20:58 +02:00
Pressing <kbd class="arrow-key">↑</kbd> from the first channel
in the list moves you to the **Filter channels** input.
help: Update keyboard-shortcuts.md. Reorganizes shortcuts and rewords shortcut descriptions. Adds a new "the basics" section at the top. Does not add or remove any shortcuts.
2017-07-28 06:47:50 +02:00
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Switch between tabs**: <kbd class="arrow-key">←</kbd> and
<kbd class="arrow-key">→</kbd> — Switch between the **Subscribed**
help: Rename remaining 'stream' to 'channel' in '/help' docs.
2024-05-06 09:20:58 +02:00
and **All channels** tabs.
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help: Rename remaining 'stream' to 'channel' in '/help' docs.
2024-05-06 09:20:58 +02:00
* **Create new channel**: <kbd>N</kbd>
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help: Rename remaining 'stream' to 'channel' in '/help' docs.
2024-05-06 09:20:58 +02:00
### For a selected channel
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help: Rename remaining 'stream' to 'channel' in '/help' docs.
2024-05-06 09:20:58 +02:00
* **View channel messages**: <kbd>Shift</kbd> + <kbd>V</kbd>
user docs: Document Streams menu hotkeys. Also includes refactoring to **Keyboard shortcuts** user docs.
2017-05-24 20:51:49 +02:00
help-docs: Use `<kbd>` HTML elements for references to keyboard keys. Updates references to keyboard keys in the help center docs to use `<kbd>` HTML elements, which also means updating them to be as the key would appear on a keyboard. Previously, uppercase and lowercase letters were used to indicate when/if the `Shift` key was being used, and even that was not consistent throughout the documentation. For CSS styling, adds a similar rule for `<kbd>` elements that is used in `/static/styles/app_components.css`. And updates the CSS class used in `/static/js/portico/help.js` for `adjust_mac_shortcuts` accordingly. Also, takes advantage of revising these pages for making small updates for current help center documentation practices.
2022-06-02 01:56:59 +02:00
* **Toggle subscription**: <kbd>Shift</kbd> + <kbd>S</kbd>
help center: Improve documentation on the ? in-app reference. Adds a sentence at the end of the intro section of each help center page explaining that you can pull up a Keyboard shortcuts, Message formatting, and Search filters reference from inside the app. Adds/updates the in-app help section at the bottom of the page with instructions for opening the reference. Fixes #23758.
2022-12-06 23:23:43 +01:00
## Keyboard shortcuts reference
A summary of the keyboard shortcuts above is available in the Zulip app.
{start_tabs}
help: Document new help menu. Updates help center docs to reflect the new dedicated help menu. - Adds `keyboard_tip` to document the `?` keyboard shortcut. Fixes #27384.
2023-10-26 03:56:57 +02:00
{tab|desktop-web}
{relative|help|keyboard-shortcuts}
!!! keyboard_tip ""
You can also use <kbd>?</kbd> to open the keyboard shortcuts reference.
help: Offer links to "Keyboard shortcuts" for logged in users. - Replaces instructions for opening the keyboard shortcuts reference with `{relative|gear|keyboard-shortcuts}`.
2023-07-21 03:22:29 +02:00
help center: Improve documentation on the ? in-app reference. Adds a sentence at the end of the intro section of each help center page explaining that you can pull up a Keyboard shortcuts, Message formatting, and Search filters reference from inside the app. Adds/updates the in-app help section at the bottom of the page with instructions for opening the reference. Fixes #23758.
2022-12-06 23:23:43 +01:00
{end_tabs}
## Related articles
* [Reading strategies](/help/reading-strategies)