help_docs: Extend options for getting links to Zulip content.

Extends the linking to Zulip documentation to cover:

- Getting URLs to messages via the message timestamp.
- Getting links to topics via the three-dots menu.
- Getting links to streams via right-click context menu.

Creates a new tabbed section for using the browser
address bar to copy URLs.
This commit is contained in:
Lauryn Menard
2022-03-02 17:20:28 +01:00
committed by Tim Abbott
parent 453cb409cf
commit b67288db67
2 changed files with 55 additions and 16 deletions

View File

@@ -32,36 +32,74 @@ Stream: #**stream name**
Topic: #**stream name>topic name** Topic: #**stream name>topic name**
``` ```
## Link to a stream or topic from anywhere ## Link to Zulip from anywhere
{start_tabs}
1. Click on a stream or topic in the left sidebar.
1. Copy the URL from your browser's address bar.
{end_tabs}
!!! warn ""
This works for all views, including searches.
All URLs in Zulip are designed to be shareable. All URLs in Zulip are designed to be shareable.
Copying the URL from the browser's address bar will work
for all views, including searches.
### Get a link to a specific message
## Link to a specific message This copies to your clipboard a permanent link to the message,
This will copy to your clipboard a permanent link to the message,
displayed in its thread (i.e. topic view for messages in a stream). displayed in its thread (i.e. topic view for messages in a stream).
Viewing a topic via a message link will never mark messages as read. Viewing a topic via a message link will never mark messages as read.
These links will still work even when the message is
[moved to another topic](/help/move-content-to-another-topic)
or [stream](/help/move-content-to-another-stream) or
if its [topic is resolved](/help/resolve-a-topic).
Zulip uses the same permanent link syntax when [quoting a Zulip uses the same permanent link syntax when [quoting a
message](/help/quote-and-reply). message](/help/quote-and-reply).
{start_tabs} {start_tabs}
{tab|desktop}
{!message-actions-menu.md!} {!message-actions-menu.md!}
1. Click **Copy link to message**. 1. Click **Copy link to message**.
{tab|via-browser-address-bar}
1. Click on the timestamp of the message.
1. Copy the URL from your browser's address bar.
{end_tabs}
### Get a link to a specific topic:
{start_tabs}
{tab|desktop}
{!topic-actions.md!}
1. Click **Copy link to topic**.
{tab|via-browser-address-bar}
1. Click on a topic in the left sidebar.
1. Copy the URL from your browser's address bar.
{end_tabs}
### Get a link to a specific stream:
{start_tabs}
{tab|desktop}
1. Right-click on the stream in the left sidebar.
1. Click **Copy Link**.
{tab|via-browser-address-bar}
1. Click on a stream in the left sidebar.
1. Copy the URL from your browser's address bar.
{end_tabs} {end_tabs}
## Related articles ## Related articles

View File

@@ -78,6 +78,7 @@ TAB_SECTION_LABELS = {
"private-streams": "Private streams", "private-streams": "Private streams",
"via-user-profile": "Via the user's profile", "via-user-profile": "Via the user's profile",
"via-organization-settings": "Via organization settings", "via-organization-settings": "Via organization settings",
"via-browser-address-bar": "Via browser's address bar",
} }