7ce87c66ac
In our current implementation, loose lists and tight lists look the same visually. Loose lists are lists with blank lines between list items, and the contents of a list item should be enclosed in a paragraph tag in that case. For unordered lists, paragraph tags have a bottom margin in starlight and thus looses lists look much more spaced out than tight lists. That is not the behaviour we had in mind while writing the documentation, the reason we had all these loose lists is to make the documentation easy to write and read. So we attempt to remove all the blank lines and fix the problem at source. Since paragraph tags are used for other purposes in a list in starlight, it won't be a wise decision to let the source be as is and just change things in css, other expected behaviours might break in that case. See this topic for more details: https://chat.zulip.org/#narrow/channel/19-documentation/topic/new.20help.20center.3A.20regressions/near/2226084 All the changes were made by a one-off script which has not been commited to the repo. The script wasn't perfect and could not decide between blank lines that make a list loose vs blank lines necessary for a sub-list or a code block inside a list item. A manual review of all the changes was done before making this commit to ensure that no unintended changes were made to the help center files.
5.9 KiB
Link to a message or conversation
Zulip makes it easy to share links to messages, topics, and channels. You can link from one Zulip conversation to another, or share links to Zulip conversations in issue trackers, emails, or other external tools.
Link to a channel within Zulip
Channel links are automatically formatted as #channel name.
{start_tabs}
{!start-composing.md!}
-
Type
#followed by a few letters from the channel name. -
Pick the desired channel from the autocomplete.
-
Pick the top option from the autocomplete to link to the channel without selecting a topic.
!!! tip ""
To link to the channel you're composing to, type `#>`, and pick the
top option from the autocomplete.
{end_tabs}
When you paste a channel link into Zulip, it's automatically formatted as
#**channel name**. You can paste as plain text if you prefer with Ctrl + Shift + V.
You can create a channel link manually by typing #**channel name**
Link to a topic within Zulip
Topic links are automatically formatted as #channel > topic.
{start_tabs}
{!start-composing.md!}
-
Type
#followed by a few letters from the channel name. -
Pick the desired channel from the autocomplete.
-
Type a few letters from the topic name.
-
Pick the desired topic from the autocomplete.
!!! tip ""
To link to a topic in the channel you're composing to, type `#>`
followed by a few letters from the topic name, and pick the desired
topic from the autocomplete.
{end_tabs}
When you paste a topic link into Zulip, it's automatically formatted as
#**channel name>topic name**. You can paste as plain text if you prefer with
Ctrl + Shift + V.
You can create a topic link manually by typing #**channel name>topic name**.
Link to Zulip from anywhere
All URLs in Zulip are designed to be shareable, including:
- Links to messages, topics, and channels.
- Search URLs, though note that personal
filters (e.g.,
is:followed) will be applied according to the user who's viewing the URL.
In addition, links to messages, topics, and channels are permanent:
- Message links will still work even when the message is moved to another topic or channel, or if its topic is resolved. Zulip uses the same permanent link syntax when quoting a message.
- Topic links will still work even when the topic is renamed, moved to another channel, or resolved.
!!! tip ""
When some messages are [moved out of a
topic](/help/move-content-to-another-topic) and others are left in place,
links to that topic will follow the location of the message whose ID is
encoded in the topic URL (usually the first or last message in the topic).
- Channel links will still work even when a channel is renamed or archived.
When you copy a Zulip link and paste it anywhere that accepts HTML formatting (e.g., your email, GitHub, docs, etc.), the link will be formatted as it would be in Zulip (e.g., #channel > topic). To paste the plain URL, you can paste without formatting (likely Ctrl + Shift + V in your browser).
Get a link to a specific message
This copies to your clipboard a permanent link to the message, displayed in the context of its conversation. To preserve your reading status, messages won't be automatically marked as read when you view a conversation via a message link.
When you paste a message link into the compose box, it gets automatically formatted to be easy to read:
#**channel name>topic name@message ID**
When you send your message, the link will appear as #channel > topic @ 💬.
{start_tabs}
{tab|desktop-web}
{!message-actions-menu.md!}
- Click Copy link to message.
!!! tip ""
If using Zulip in a browser, you can also click on the timestamp
of a message, and copy the URL from your browser's address bar.
{end_tabs}
When you paste a message link into Zulip, it is automatically formatted for you. You can paste as plain text if you prefer with Ctrl + Shift + V.
Get a link to a specific topic
{start_tabs}
{tab|desktop-web}
{!topic-actions.md!}
- Click Copy link to topic.
!!! tip ""
If using Zulip in a browser, you can also click on a topic name,
and copy the URL from your browser's address bar.
{tab|mobile}
Access this feature by following the web app instructions in your mobile device browser.
Implementation of this feature in the mobile app is tracked on GitHub. If you're interested in this feature, please react to the issue's description with 👍.
{end_tabs}
Get a link to a specific channel
{start_tabs}
{tab|desktop-web}
{!channel-actions.md!}
- Click Copy link to channel.
{tab|mobile}
Access this feature by following the web app instructions in your mobile device browser.
Implementation of this feature in the mobile app is tracked on GitHub. If you're interested in this feature, please react to the issue's description with 👍.
{end_tabs}