Mirror
/
zulip
mirror of https://github.com/zulip/zulip.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
zulip/templates/zerver/help/configure-default-view.md

72 lines
2.3 KiB
Markdown
Raw Normal View History

user_settings: Add option to disable escape key navigation to default view. Add `escape_navigates_to_default_view` as a bool setting in UserBaseSettings model and implement it as a checkbox that toggles the hotkey implementation of escape to the default view in the advanced user display settings. With /help/ documentation edits from Alya Abbott. Fixes #20043.
2021-10-25 19:17:19 +02:00
# Configure default view
The default view in Zulip is the view you reach after logging in
to the Zulip web app. You can also navigate to the default view via
keyboard shortcuts.
The default views available in Zulip are
[Recent topics](/help/recent-topics) and
[All messages](/help/reading-strategies#all-messages). See
[Reading strategies](/help/reading-strategies) for recommendations
on how to use these views.
You can configure which view is set as your default, and whether
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
the <kbd>Esc</kbd> key navigates to the default view. Also, you can
always reach the default view by using the <kbd>Ctrl</kbd> + <kbd>[</kbd>
shortcut.
user_settings: Add option to disable escape key navigation to default view. Add `escape_navigates_to_default_view` as a bool setting in UserBaseSettings model and implement it as a checkbox that toggles the hotkey implementation of escape to the default view in the advanced user display settings. With /help/ documentation edits from Alya Abbott. Fixes #20043.
2021-10-25 19:17:19 +02:00
## Change default view
Organization administrators can [set the default view for their
organization](/help/configure-default-new-user-settings) to
[**Recent topics**](/help/recent-topics) or
[**All messages**](/help/reading-strategies#all-messages).
**Recent topics** is especially recommended for high-traffic
organizations, and is configured by default.
You can customize your personal default view regardless of
organization settings:
{start_tabs}
{settings_tab|display-settings}
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
1. Under **Advanced**, click on the **Default view** dropdown
and select a view.
user_settings: Add option to disable escape key navigation to default view. Add `escape_navigates_to_default_view` as a bool setting in UserBaseSettings model and implement it as a checkbox that toggles the hotkey implementation of escape to the default view in the advanced user display settings. With /help/ documentation edits from Alya Abbott. Fixes #20043.
2021-10-25 19:17:19 +02:00
1. To see your changes in action, open a new Zulip tab, or use a keyboard
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
shortcut twice to exit the settings and navigate to your default view
(<kbd>Ctrl</kbd> + <kbd>[</kbd> or <kbd>Esc</kbd> if enabled).
user_settings: Add option to disable escape key navigation to default view. Add `escape_navigates_to_default_view` as a bool setting in UserBaseSettings model and implement it as a checkbox that toggles the hotkey implementation of escape to the default view in the advanced user display settings. With /help/ documentation edits from Alya Abbott. Fixes #20043.
2021-10-25 19:17:19 +02:00
[configure-esc]: /help/configure-default-view#set-whether-esc-navigates-to-the-default-view
{end_tabs}
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
## Set whether <kbd>Esc</kbd> navigates to the default view
user_settings: Add option to disable escape key navigation to default view. Add `escape_navigates_to_default_view` as a bool setting in UserBaseSettings model and implement it as a checkbox that toggles the hotkey implementation of escape to the default view in the advanced user display settings. With /help/ documentation edits from Alya Abbott. Fixes #20043.
2021-10-25 19:17:19 +02:00
Zulip has a number of [keyboard shortcuts](/help/keyboard-shortcuts)
designed to enhance the user experience in the app.
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
By default, the <kbd>Esc</kbd> key shortcut will ultimately navigate to
your default view. You can disable this key binding if you would prefer.
This will not disable other <kbd>Esc</kbd> key shortcuts used in Zulip,
and will not affect the behavior of the <kbd>Ctrl</kbd> + <kbd>[</kbd>
shortcut.
user_settings: Add option to disable escape key navigation to default view. Add `escape_navigates_to_default_view` as a bool setting in UserBaseSettings model and implement it as a checkbox that toggles the hotkey implementation of escape to the default view in the advanced user display settings. With /help/ documentation edits from Alya Abbott. Fixes #20043.
2021-10-25 19:17: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
### Toggle whether <kbd>Esc</kbd> navigates to the default view
user_settings: Add option to disable escape key navigation to default view. Add `escape_navigates_to_default_view` as a bool setting in UserBaseSettings model and implement it as a checkbox that toggles the hotkey implementation of escape to the default view in the advanced user display settings. With /help/ documentation edits from Alya Abbott. Fixes #20043.
2021-10-25 19:17:19 +02:00
{start_tabs}
{settings_tab|display-settings}
help_docs: Update `configure-default-view` to use 'toggle'. We'd like to use 'toggle' for consistency when referring to check boxes in help center documentation instructions.
2022-03-21 19:19:14 +01:00
1. Under **Advanced**, toggle **Escape key navigates to
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
default view**, as desired.
user_settings: Add option to disable escape key navigation to default view. Add `escape_navigates_to_default_view` as a bool setting in UserBaseSettings model and implement it as a checkbox that toggles the hotkey implementation of escape to the default view in the advanced user display settings. With /help/ documentation edits from Alya Abbott. Fixes #20043.
2021-10-25 19:17:19 +02:00
{end_tabs}
## Related articles
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
user_settings: Add option to disable escape key navigation to default view. Add `escape_navigates_to_default_view` as a bool setting in UserBaseSettings model and implement it as a checkbox that toggles the hotkey implementation of escape to the default view in the advanced user display settings. With /help/ documentation edits from Alya Abbott. Fixes #20043.
2021-10-25 19:17:19 +02:00
* [Reading strategies](/help/reading-strategies)
* [Recent topics](/help/recent-topics)
* [Keyboard shortcuts](/help/keyboard-shortcuts)