mirror of
https://github.com/zulip/zulip.git
synced 2025-11-02 21:13:36 +00:00
help: Wrap a bunch of very long lines.
Now there are no lines longer than 140 characters here.
This commit is contained in:
@@ -1,7 +1,7 @@
|
||||
# Add custom emoji
|
||||
|
||||
If you are an administrator of a Zulip organization, you can add custom emojis
|
||||
to your organization for other members to use.
|
||||
If you are an administrator of a Zulip organization, you can add
|
||||
custom emojis to your organization for other members to use.
|
||||
|
||||
{!go-to-the.md!} [Emoji Settings](/#administration/emoji-settings)
|
||||
{!admin.md!}
|
||||
@@ -9,18 +9,23 @@ to your organization for other members to use.
|
||||
5. In the green section labeled **Add a New Emoji**, find the **Emoji name** and
|
||||
**Emoji URL** fields.
|
||||
|
||||
* In the **Emoji name** field, enter a phrase for your emoji. Only alphanumeric characters, dashes, and underscores are allowed, but dashes and underscores cannot end an emoji phrase.
|
||||
* In the **Emoji name** field, enter a phrase for your emoji. Only
|
||||
alphanumeric characters, dashes, and underscores are allowed,
|
||||
but dashes and underscores cannot end an emoji phrase.
|
||||
|
||||
Users will use the designated emoji phrase surrounded by colons to
|
||||
insert your emoji into their messages.
|
||||
Users will use the designated emoji phrase surrounded by
|
||||
colons to insert your emoji into their messages.
|
||||
|
||||
* In the **Emoji URL** field, insert the link to your custom emoji's image. The
|
||||
link must start with **http://** or **https://**.
|
||||
* In the **Emoji URL** field, insert the link to your custom
|
||||
emoji's image. The link must start with **http://** or
|
||||
**https://**.
|
||||
|
||||
Please note that the image will be scaled down to 25x25 pixels in users' messages.
|
||||
Please note that the image will be scaled down to 25x25 pixels
|
||||
in users' messages.
|
||||
|
||||
6. After filling out the **Emoji name** and **Emoji URL** fields, click the blue
|
||||
**Add emoji** button to add your custom emoji to your Zulip organization.
|
||||
6. After filling out the **Emoji name** and **Emoji URL** fields,
|
||||
click the blue **Add emoji** button to add your custom emoji to your
|
||||
Zulip organization.
|
||||
|
||||
7. Upon clicking the **Add emoji** button, you will receive a notification
|
||||
labeled **Custom emoji added!** in the **Add a New Emoji** section, confirming
|
||||
|
||||
@@ -19,12 +19,25 @@ Zulip fully supports Unicode. To use Unicode in your message:
|
||||
2. Compose a [new message or reply](/help/#posting-and-replying)
|
||||
3. Paste the emoji into the message box.
|
||||
|
||||
**Note**: You can browse the [Unicode Consortium's full list of emoji](http://unicode.org/emoji/charts/full-emoji-list.html), however emoji on Zulip may appear different than the ones listed.
|
||||
**Note**: You can browse the
|
||||
[Unicode Consortium's full list of emoji](http://unicode.org/emoji/charts/full-emoji-list.html),
|
||||
however emoji on Zulip may appear different than the ones listed.
|
||||
|
||||
### Using emoji codes
|
||||
1. Start by composing a [new message or reply](/help/#posting-and-replying)
|
||||
2. Type in the emoji code. For example `:smile:` produces the following icon:<img src="/static/generated/emoji/images/emoji/smile.png" alt="smile" style="width: 3%;"/>.
|
||||
1. Start by composing a
|
||||
[new message or reply](/help/#posting-and-replying)
|
||||
2. Type in the emoji code. For example `:smile:` produces the
|
||||
following icon:<img
|
||||
src="/static/generated/emoji/images/emoji/smile.png" alt="smile"
|
||||
style="width: 3%;"/>.
|
||||
|
||||
**Note**: If you are unsure of the code for any particular emoji visit [Emoji Cheat Sheet](http://www.webpagefx.com/tools/emoji-cheat-sheet/) for a complete list. Furthermore, after typing `:` and any two letters an autocomplete menu will appear displaying five emoji codes. These emoji contain the letters you typed and are sorted alphabetically by code. You can also cycle through these suggestions by using the `↑` and `↓` arrow keys.
|
||||
!!! tip ""
|
||||
If you are unsure of the code for any particular emoji visit
|
||||
[Emoji Cheat Sheet](http://www.webpagefx.com/tools/emoji-cheat-sheet/)
|
||||
for a complete list. Furthermore, after typing `:` and any two
|
||||
letters an autocomplete menu will appear displaying five emoji
|
||||
codes. These emoji contain the letters you typed and are sorted
|
||||
alphabetically by code. You can also cycle through these
|
||||
suggestions by using the `↑` and `↓` arrow keys.
|
||||
|
||||

|
||||

|
||||
|
||||
@@ -1,8 +1,14 @@
|
||||
# Add or invite someone to a stream
|
||||
|
||||
You might want to add a user to a particular stream that they haven't subscribed to yet so that they can send and read messages in that stream. In Zulip, you can add users to a public stream even if you aren't subscribed to that particular stream, but you must be subscribed to a private stream in order to invite a user to join that stream.
|
||||
You might want to add a user to a particular stream that they haven't
|
||||
subscribed to yet so that they can send and read messages in that
|
||||
stream. In Zulip, you can add users to a public stream even if you
|
||||
aren't subscribed to that particular stream, but you must be
|
||||
subscribed to a private stream in order to invite a user to join that
|
||||
stream.
|
||||
|
||||
You can add users to streams, both public and private, that you're subscribed to.
|
||||
You can add users to streams, both public and private, that you're
|
||||
subscribed to.
|
||||
|
||||
{!subscriptions.md!}
|
||||
{!filter-streams.md!}
|
||||
|
||||
@@ -2,10 +2,20 @@
|
||||
|
||||

|
||||
|
||||
When having a conversation in Zulip, it is sometimes necessary to call the attention of another member. You can alert ("**@mention**") other users with a particular stream-message from within the body of the message itself. Type `@` and then begin typing their email address or one of their names, and the system will offer you tab-completions. The completed `@mention` will look something like: `@**name**`, and it will appear as **@name** in your posted message.
|
||||
When having a conversation in Zulip, it is sometimes necessary to call
|
||||
the attention of another member. You can alert ("**@mention**") other
|
||||
users with a particular stream-message from within the body of the
|
||||
message itself. Type `@` and then begin typing their email address or
|
||||
one of their names, and the system will offer you tab-completions. The
|
||||
completed `@mention` will look something like: `@**name**`, and it
|
||||
will appear as **@name** in your posted message.
|
||||
|
||||
If you attempt to `@mention` someone who is not subscribed to the current stream, Zulip will ask if you would like to subscribe them to the stream:
|
||||
If you attempt to `@mention` someone who is not subscribed to the
|
||||
current stream, Zulip will ask if you would like to subscribe them to
|
||||
the stream:
|
||||
|
||||

|
||||
|
||||
You can view any mentions calling your attention by clicking on the "@-mentions" view in the left sidebar.
|
||||
!!! tip ""
|
||||
You can view any mentions calling your attention by clicking on the
|
||||
"@-mentions" view in the left sidebar.
|
||||
|
||||
@@ -1,13 +1,21 @@
|
||||
# Change the date and time format
|
||||
|
||||

|
||||
|
||||
By default, messages in Zulip are displayed with a 12-hour timestamp. If you are used to seeing time displayed in a 24-hour format, you can change the Zulip timestamp format from a 12-hour format to a 24-hour format. You may want to do this to avoid confusion between A.M. and P.M. hours.
|
||||
By default, messages in Zulip are displayed with a 12-hour
|
||||
timestamp. If you are used to seeing time displayed in a 24-hour
|
||||
format, you can change the Zulip timestamp format from a 12-hour
|
||||
format to a 24-hour format. You may want to do this to avoid confusion
|
||||
between A.M. and P.M. hours.
|
||||
|
||||
You can easily change the date and time format your messages are displayed in by following a few steps.
|
||||
You can easily change the date and time format your messages are
|
||||
displayed in by following a few steps.
|
||||
|
||||
{!go-to-the.md!} [Display Settings](/#settings/display-settings)
|
||||
{!settings.md!}
|
||||
|
||||
2. Select the option labeled **Display time in 24-hour format (17:00 instead of 5:00 PM)**, then reload the page in order for the change to take effect.
|
||||
2. Select the option labeled **Display time in 24-hour format (17:00
|
||||
instead of 5:00 PM)**, then reload the page in order for the change
|
||||
to take effect.
|
||||
|
||||

|
||||
|
||||
@@ -2,7 +2,9 @@
|
||||
|
||||
You can easily change the topic of a message by following the following steps.
|
||||
|
||||
{!message-actions.md!} the pencil () icon to begin editing your message.
|
||||
{!message-actions.md!} the pencil
|
||||
() icon to begin editing your
|
||||
message.
|
||||
|
||||
2. In the field labeled **Topic**, enter the new topic name for your message.
|
||||
|
||||
@@ -21,7 +23,9 @@ your message's topic.
|
||||
|
||||
* **Change later messages to this topic**
|
||||
|
||||
This option changes the topic of the selected message as well as the topic of any messages under the same topic that were sent after the selected message.
|
||||
This option changes the topic of the selected message as well
|
||||
as the topic of any messages under the same topic that were
|
||||
sent after the selected message.
|
||||
|
||||
!!! tip ""
|
||||
You may want to select this option if you feel that some of your
|
||||
@@ -29,7 +33,9 @@ your message's topic.
|
||||
|
||||
* **Change previous and following messages to this topic**
|
||||
|
||||
This option changes the topic of the selected message as well as any messages under the same topic that were sent before and after the selected message.
|
||||
This option changes the topic of the selected message as well
|
||||
as any messages under the same topic that were sent before and
|
||||
after the selected message.
|
||||
|
||||
!!! tip ""
|
||||
You may want to select this option to change the topic for all
|
||||
|
||||
@@ -1,9 +1,14 @@
|
||||
# Create a stream
|
||||
On Zulip, streams are similar to conversation threads or subjects. Streams are located on the left sidebar.
|
||||
Streams can be either:
|
||||
|
||||
* **Public streams** - Public streams are for open discussions. All users can subscribe to public streams and discuss there.
|
||||
* **Private streams** - Private streams are for confidential discussions and are only visible to users who've been invited to subscribe to them.
|
||||
In Zulip, streams are like mailing lists in an email tool; each has a
|
||||
set of subscribers. Your current subscriptions are visible in the left
|
||||
sidebar. Streams can be either:
|
||||
|
||||
* **Public streams** - Public streams are for open discussions. All
|
||||
users can subscribe to public streams and discuss there.
|
||||
* **Private streams** - Private streams are for confidential
|
||||
discussions and are only visible to users who've been invited to
|
||||
subscribe to them.
|
||||
|
||||
## Create a new stream
|
||||
|
||||
|
||||
@@ -1,26 +1,38 @@
|
||||
# Deactivate your account
|
||||
|
||||
We'd be sorry to see you go, but you can follow the following steps to deactivate your Zulip account.
|
||||
We'd be sorry to see you go, but you can follow the following steps to
|
||||
deactivate your Zulip account.
|
||||
|
||||
{!go-to-the.md!} [Your Account](/#settings/your-account)
|
||||
{!settings.md!}
|
||||
|
||||
2. Click the **Deactivate your account** button on the bottom of the **Your account** section.
|
||||
2. Click the **Deactivate your account** button on the bottom of the
|
||||
**Your account** section.
|
||||
|
||||

|
||||
|
||||
4. After clicking the **Deactivate Account** button, a modal window titled **Deactivate Your Account** will appear.
|
||||
4. After clicking the **Deactivate Account** button, a modal window
|
||||
titled **Deactivate Your Account** will appear.
|
||||
|
||||

|
||||
|
||||
5. To confirm the deletion of your account, click the **Deactivate now** button. Please note that any bots that you maintain will be disabled.
|
||||
5. To confirm the deletion of your account, click the **Deactivate
|
||||
now** button. Please note that any bots that you maintain will be
|
||||
disabled.
|
||||
|
||||
6. After clicking the **Deactivate now** button, you will be logged out and returned to the Zulip login page.
|
||||
6. After clicking the **Deactivate now** button, you will be logged
|
||||
out and returned to the Zulip login page.
|
||||
|
||||
Please note that you cannot register a Zulip account using the email address of a deactivated account.
|
||||
Please note that you cannot register a Zulip account using the email
|
||||
address of a deactivated account.
|
||||
|
||||
In addition, if you're the only administrator in the realm, you cannot deactivate your account; you need to make another user an administrator first before you can deactivate your account.
|
||||
In addition, if you're the only administrator in the realm, you cannot
|
||||
deactivate your account; you need to make another user an
|
||||
administrator first before you can deactivate your account.
|
||||
|
||||
## Reactivating an account
|
||||
|
||||
If you regret deactivating your account, you can ask a Zulip realm administrator to [reactivate](/help/deactivate-or-reactivate-a-user#reactivate-a-user) your account.
|
||||
If you regret deactivating your account, you can ask a Zulip realm
|
||||
administrator to
|
||||
[reactivate](/help/deactivate-or-reactivate-a-user#reactivate-a-user)
|
||||
your account.
|
||||
|
||||
@@ -1,15 +1,21 @@
|
||||
# Press Enter to send
|
||||
|
||||
By default, Zulip sends your message when you press enter (or return) on your keyboard. If you want to turn this off, simply uncheck the **Press Enter to send** box below the compose field:
|
||||
By default, Zulip sends your message when you press enter (or return)
|
||||
on your keyboard. If you want to turn this off, simply uncheck the
|
||||
**Press Enter to send** box below the compose field:
|
||||
|
||||

|
||||
|
||||
You will now see a **Send** button below the compose field looking like this.
|
||||
You will now see a **Send** button below the compose field looking
|
||||
like this.
|
||||
|
||||

|
||||
|
||||
With the box unchecked, you will have to click the **Send** button to send your message. Pressing enter will no longer send your message.
|
||||
With the box unchecked, you will have to click the **Send** button to
|
||||
send your message. Pressing enter will no longer send your message.
|
||||
|
||||
If you’d like to re-enable the press enter to send feature, just check the **Press Enter to send** box again, and you will be able to send your messages by pressing enter.
|
||||
If you’d like to re-enable the press enter to send feature, just check
|
||||
the **Press Enter to send** box again, and you will be able to send
|
||||
your messages by pressing enter.
|
||||
|
||||
**[Go to "Table of contents"](/help/#using-zulip)**
|
||||
|
||||
@@ -1,10 +1,15 @@
|
||||
# Message formatting
|
||||
|
||||
Zulip uses a variant of GitHub Flavored Markdown (GFM) to allow you to easily format your messages.
|
||||
Zulip uses a variant of GitHub Flavored Markdown (GFM) to allow you to
|
||||
easily format your messages.
|
||||
|
||||
## Summary
|
||||
|
||||
For a summary of message formatting in Zulip, click the  icon located at the bottom left of your messaging box or the cog () in the upper right corner of the right sidebar and choose “Message formatting” from the drop-down menu.
|
||||
For a summary of message formatting in Zulip, click the
|
||||
 icon located at the bottom
|
||||
left of your messaging box or the cog
|
||||
() in the upper right corner of the
|
||||
right sidebar and choose “Message formatting” from the drop-down menu.
|
||||
|
||||
The following modal window will appear.
|
||||
|
||||
@@ -12,7 +17,8 @@ The following modal window will appear.
|
||||
|
||||
## Emphasis
|
||||
|
||||
You can surround your text with a combination of asterisks `*` and tildes `~` to emphasize words or phrases in your messages.
|
||||
You can surround your text with a combination of asterisks `*` and
|
||||
tildes `~` to emphasize words or phrases in your messages.
|
||||
|
||||
### Italics
|
||||
|
||||
@@ -34,13 +40,17 @@ For strikethrough text, surround your text with `~~two tildes~~`.
|
||||
|
||||
### Extra emphasis
|
||||
|
||||
To add more variety, flavor, and emphasis to your messages, you can combine different styles of formatting.
|
||||
To add more variety, flavor, and emphasis to your messages, you can
|
||||
combine different styles of formatting.
|
||||
|
||||

|
||||
|
||||
## Links
|
||||
|
||||
To include hyperlinks in your messages, you can either enter the link's url address directly or surround the link's display text with`[brackets]` and the url address of the link in `(parentheses)` immediately after.
|
||||
To include hyperlinks in your messages, you can either enter the
|
||||
link's url address directly or surround the link's display text
|
||||
with`[brackets]` and the url address of the link in `(parentheses)`
|
||||
immediately after.
|
||||
|
||||

|
||||
|
||||
@@ -48,7 +58,9 @@ Zulip currently does not support image embedding through links.
|
||||
|
||||
## Stream Links
|
||||
|
||||
To link to another stream in one of your messages, you can either type `#streamName` and click the stream name in the popup, or you can start with `#` and surround your message with double asteriks `**`.
|
||||
To link to another stream in one of your messages, you can either type
|
||||
`#streamName` and click the stream name in the popup, or you can start
|
||||
with `#` and surround your message with double asteriks `**`.
|
||||
|
||||

|
||||
|
||||
@@ -56,13 +68,16 @@ To link to another stream in one of your messages, you can either type `#streamN
|
||||
|
||||
## Lists
|
||||
|
||||
Begin each item in your list with `* an asterisk followed by a space` to include lists in your messages.
|
||||
Begin each item in your list with `* an asterisk followed by a space`
|
||||
to include lists in your messages.
|
||||
|
||||

|
||||
|
||||
## Emojis
|
||||
|
||||
Zulip features a variety of emojis provided by the [Noto Project](https://code.google.com/p/noto/). To include emojis in your messages, surround the emoji phrase with `:colons:`.
|
||||
Zulip features a variety of emojis provided by the
|
||||
[Noto Project](https://code.google.com/p/noto/). To include emojis in
|
||||
your messages, surround the emoji phrase with `:colons:`.
|
||||
|
||||
A dropdown will appear with suggested emojis as you enter the emoji phrase.
|
||||
|
||||
@@ -72,13 +87,16 @@ A complete list of emojis can be found [here](http://www.webpagefx.com/tools/emo
|
||||
|
||||
## Mentions
|
||||
|
||||
To call the attention of another member, you can alert them by typing `@**username**`
|
||||
To call the attention of another member, you can alert them by typing
|
||||
`@**username**`
|
||||
|
||||
If you type `@` and then begin typing the user's email address or the user's name, the system will offer you auto-completion suggestions.
|
||||
If you type `@` and then begin typing the user's email address or the
|
||||
user's name, the system will offer you auto-completion suggestions.
|
||||
|
||||

|
||||
|
||||
Typing `@**all**` will alert all users in the stream, and a confirmation message will appear.
|
||||
Typing `@**all**` will alert all users in the stream, and a
|
||||
confirmation message will appear.
|
||||
|
||||

|
||||
|
||||
@@ -92,11 +110,15 @@ You can surround a portion of code with ``
|
||||
|
||||

|
||||
|
||||
Multi-line blocks of code are either fenced by lines with <code>`````` three back-ticks```<code>```</code></code> or indented with four spaces.
|
||||
Multi-line blocks of code are either fenced by lines with <code>``````
|
||||
three back-ticks```<code>```</code></code> or indented with four
|
||||
spaces.
|
||||
|
||||

|
||||
|
||||
In addition, to highlight language syntax, add the file extension of the language (for example, Python would be **.py**) right after the first set of back-ticks.
|
||||
In addition, to highlight language syntax, add the file extension of
|
||||
the language (for example, Python would be **.py**) right after the
|
||||
first set of back-ticks.
|
||||
|
||||

|
||||
|
||||
@@ -104,6 +126,8 @@ In addition, to highlight language syntax, add the file extension of the languag
|
||||
|
||||
## Quotes
|
||||
|
||||
To insert quotes, you can either add a greater-than symbol ```>``` and a space before your phrase or submit it as a quote block by following the code syntax highlighting format.
|
||||
To insert quotes, you can either add a greater-than symbol ```>``` and
|
||||
a space before your phrase or submit it as a quote block by following
|
||||
the code syntax highlighting format.
|
||||
|
||||

|
||||
|
||||
@@ -57,7 +57,9 @@ as a “**realm**”.
|
||||
* Verify that your message has been successfully sent
|
||||
* What to do if the server returns an error
|
||||
* Send a status message
|
||||
* [@-mention a team member](/help/at-mention-a-team-member) (needs a note that you can't @mention when editing messages, since they may have already read the message / not clear how to notif them)
|
||||
* [@-mention a team member](/help/at-mention-a-team-member) (needs a
|
||||
note that you can't @mention when editing messages, since they may
|
||||
have already read the message / not clear how to notif them)
|
||||
* Make an announcement
|
||||
* Send a message in a different language
|
||||
* [Reply to a message](/help/reply-to-a-message)
|
||||
@@ -411,9 +413,10 @@ of the message is unchanged.
|
||||
|
||||
Zulip uses a subset of
|
||||
[GitHub Flavored Markdown](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet#tables)
|
||||
(GFM), To see the current subset, go to the cog
|
||||
(<img alt="cog" class="inline" src="/static/images/help/cog.png" />) in the upper right corner of the
|
||||
right sidebar and choose “Message formatting” from the drop-down menu.
|
||||
(GFM), To see the current subset, go to the cog (<img alt="cog"
|
||||
class="inline" src="/static/images/help/cog.png" />) in the upper
|
||||
right corner of the right sidebar and choose “Message formatting” from
|
||||
the drop-down menu.
|
||||
|
||||
**[Go back to “Other common questions”](#other-common-questions)** |
|
||||
**[Go back to “Table of contents”](#using-zulip)**
|
||||
@@ -438,9 +441,10 @@ right sidebar and choose “Message formatting” from the drop-down menu.
|
||||
|
||||
If you have messaged multiple individual users, their names will
|
||||
appear at the bottom of the right sidebar. In that case, a pale green
|
||||
circle (<span class="indicator green"></span>) means that some are recently but not currently active, while others are state unknown. A regular green circle
|
||||
(<span class="indicator green solid"></span>) means they
|
||||
are all at least recently active.
|
||||
circle (<span class="indicator green"></span>) means that some are
|
||||
recently but not currently active, while others are state unknown. A
|
||||
regular green circle (<span class="indicator green solid"></span>)
|
||||
means they are all at least recently active.
|
||||
|
||||
**[Go back to “Other common questions”](#other-common-questions)** |
|
||||
**[Go back to “Table of contents”](#using-zulip)**
|
||||
|
||||
@@ -1,32 +1,46 @@
|
||||
# Invite a friend to Zulip
|
||||
|
||||
By default, all users in a Zulip organization can invite users to their Zulip organization. To do so, simply follow the following steps.
|
||||
By default, all users in a Zulip organization can invite users to
|
||||
their Zulip organization. To do so, simply follow the following steps.
|
||||
|
||||
1. Click the cog () in the upper right corner of the right sidebar.
|
||||
1. Click the cog () in the upper
|
||||
right corner of the right sidebar.
|
||||
|
||||
2. Select **Invite users** from the dropdown menu that appears.
|
||||
|
||||

|
||||
|
||||
3. After clicking **Invite users**, a modal window titled **Invite users to Zulip** will appear.
|
||||
3. After clicking **Invite users**, a modal window titled **Invite
|
||||
users to Zulip** will appear.
|
||||
|
||||

|
||||
|
||||
4. In the box labeled **Emails (one on each line or comma-separated)**, enter the email addresses of the users that you want to invite. Insert a comma or a separate line between each email.
|
||||
4. In the box labeled **Emails (one on each line or
|
||||
comma-separated)**, enter the email addresses of the users that you
|
||||
want to invite. Insert a comma or a separate line between each
|
||||
email.
|
||||
|
||||

|
||||
|
||||
5. In the section labeled **Streams they should join**, select the options of any streams that you want the users you invite to be subscribed to by default. Only streams that you're subscribed to are displayed; the **Check all** option selects all streams, while the **Uncheck all** option deselects all streams.
|
||||
5. In the section labeled **Streams they should join**, select the
|
||||
options of any streams that you want the users you invite to be
|
||||
subscribed to by default. Only streams that you're subscribed to
|
||||
are displayed; the **Check all** option selects all streams, while
|
||||
the **Uncheck all** option deselects all streams.
|
||||
|
||||

|
||||
|
||||
6. After you have finished inputting all fields, click the blue **Invite** button in the bottom right corner. A section labeled **Users invited successfully.** will appear in the modal to confirm the success of your invitation.
|
||||
6. After you have finished inputting all fields, click the blue
|
||||
**Invite** button in the bottom right corner. A section labeled
|
||||
**Users invited successfully.** will appear in the modal to confirm
|
||||
the success of your invitation.
|
||||
|
||||

|
||||
|
||||
## Invitation email example
|
||||
|
||||
Users who are invited to Zulip email will receive an email similar to the example below.
|
||||
Users who are invited to Zulip email will receive an email similar to
|
||||
the example below.
|
||||
|
||||
```
|
||||
MIME-Version: 1.0
|
||||
@@ -39,7 +53,8 @@ Date: [timestamp]
|
||||
|
||||
Hi there,
|
||||
|
||||
[user] ([user's email]) wants you to join them on Zulip -- the group communication tool you've always wished you had at work.
|
||||
[user] ([user's email]) wants you to join them on Zulip -- the group
|
||||
communication tool you've always wished you had at work.
|
||||
|
||||
To get started, visit the link below:
|
||||
<[invite link]>
|
||||
|
||||
@@ -1,5 +1,7 @@
|
||||
# Keyboard Shortcuts
|
||||
Keyboard shortcuts allow a user to use Zulip easily and efficiently for a better user experience.
|
||||
|
||||
Keyboard shortcuts allow a user to use Zulip easily and efficiently
|
||||
for a better user experience.
|
||||
|
||||
Zulip keyboard shortcuts are divided into four categories:
|
||||
* [Navigation](#navigation)
|
||||
@@ -8,34 +10,72 @@ Zulip keyboard shortcuts are divided into four categories:
|
||||
* [Menus](#menus)
|
||||
|
||||
## Navigation
|
||||
* **Initiate a search** `/` - This shortcut moves the user's cursor to the message search bar at the top of the window to allow them to begin searching for messages belonging to a specific topic, stream, view, etc. in the realm.
|
||||
* **Search people** `q` - This shortcut moves the user's cursor to the user search bar in the right sidebar to to allow them to begin searching for a particular user in the realm.
|
||||
* **Search streams** `w` - This shortcut moves the user's cursor to the stream search bar in the left sidebar to to allow them to begin searching for a particular stream in the realm.
|
||||
* **Previous message** `k` `Up arrow` - This shortcut allows the user to scroll up to the previous message in their view.
|
||||
* **Next message** `j` `Down arrow` - This shortcut allows the user to scroll down to the next message in their view.
|
||||
* **Scroll up** `K` `PgUp` - This shortcut allows the user to scroll up through the messages in their view.
|
||||
* **Scroll down** `J` `PgDn` `Spacebar` - This shortcut allows the user to scroll down through the messages in their view.
|
||||
* **Last message** `End` - This shortcut allows the user to scroll to the most recent message in their view.
|
||||
|
||||
* **Initiate a search** `/` - This shortcut moves the user's cursor to
|
||||
the message search bar at the top of the window to allow them to
|
||||
begin searching for messages belonging to a specific topic, stream,
|
||||
view, etc. in the realm.
|
||||
* **Search people** `q` - This shortcut moves the user's cursor to the
|
||||
user search bar in the right sidebar to to allow them to begin
|
||||
searching for a particular user in the realm.
|
||||
* **Search streams** `w` - This shortcut moves the user's cursor to
|
||||
the stream search bar in the left sidebar to to allow them to begin
|
||||
searching for a particular stream in the realm.
|
||||
* **Previous message** `k` `Up arrow` - This shortcut allows the user
|
||||
to scroll up to the previous message in their view.
|
||||
* **Next message** `j` `Down arrow` - This shortcut allows the user to
|
||||
scroll down to the next message in their view.
|
||||
* **Scroll up** `K` `PgUp` - This shortcut allows the user to scroll
|
||||
up through the messages in their view.
|
||||
* **Scroll down** `J` `PgDn` `Spacebar` - This shortcut allows the
|
||||
user to scroll down through the messages in their view.
|
||||
* **Last message** `End` - This shortcut allows the user to scroll to
|
||||
the most recent message in their view.
|
||||
|
||||
## Composing messages
|
||||
* **Reply to message** `Enter` `r` - This shortcut allows the user to begin replying to the selected message (outlined in blue).
|
||||
* **Reply to author** `R` - This shortcut allows the user to begin writing a private message to the author of the selected message (outlined in blue).
|
||||
* **Reply to message** `Enter` `r` - This shortcut allows the user to
|
||||
begin replying to the selected message (outlined in blue).
|
||||
* **Reply to author** `R` - This shortcut allows the user to begin
|
||||
writing a private message to the author of the selected message
|
||||
(outlined in blue).
|
||||
* **Reply to message mentioning the author** `Enter` `@` - This
|
||||
shortcut allows the user to begin replying to the selected message
|
||||
(outlined in blue), @-mentioning the author of the selected message.
|
||||
* **New stream message** `c` - This shortcut allows the user to begin composing a new stream message.
|
||||
* **New private message** `C` - This shortcut allows the user to begin composing a new private message.
|
||||
* **Send message** `Tab key` then `Enter` - This shortcut allows the user to send the message that they've written.
|
||||
* **Cancel compose** `Esc` - This shortcut allows the user to cancel and discard their unsent message.
|
||||
* **New stream message** `c` - This shortcut allows the user to begin
|
||||
composing a new stream message.
|
||||
* **New private message** `C` - This shortcut allows the user to begin
|
||||
composing a new private message.
|
||||
* **Send message** `Tab key` then `Enter` - This shortcut allows the
|
||||
user to send the message that they've written.
|
||||
* **Cancel compose** `Esc` - This shortcut allows the user to cancel
|
||||
and discard their unsent message.
|
||||
|
||||
## Narrowing
|
||||
* **Narrow by stream** `s` - This shortcut narrows the view to show all messages in the stream of the selected message (outlined in blue).
|
||||
* **Narrow by topic** `S` - This shortcut narrows the view to show all messages with the topic of the selected message (outlined in blue).
|
||||
* **Narrow to all private messages** `v` - This shortcut narrows the view to show all of the user's private messages.
|
||||
* **Cycle between stream narrows** `A` `D` - This shortcut allows the user to cycle through the narrows showing the messages of a stream according to Stream order in the left sidebar. `A` allows the user to navigate to the previous stream narrow, and `D` allows the user to navigate to the next stream narrow.
|
||||
* **Return to home view** `Esc` - This shortcut makes the user return to the Home view, showing all messages in the realm.
|
||||
|
||||
* **Narrow by stream** `s` - This shortcut narrows the view to show
|
||||
all messages in the stream of the selected message (outlined in
|
||||
blue).
|
||||
* **Narrow by topic** `S` - This shortcut narrows the view to show all
|
||||
messages with the topic of the selected message (outlined in blue).
|
||||
* **Narrow to all private messages** `v` - This shortcut narrows the
|
||||
view to show all of the user's private messages.
|
||||
* **Cycle between stream narrows** `A` `D` - This shortcut allows the
|
||||
user to cycle through the narrows showing the messages of a stream
|
||||
according to Stream order in the left sidebar. `A` allows the user
|
||||
to navigate to the previous stream narrow, and `D` allows the user
|
||||
to navigate to the next stream narrow.
|
||||
* **Return to home view** `Esc` - This shortcut makes the user return
|
||||
to the Home view, showing all messages in the realm.
|
||||
|
||||
## Menus
|
||||
* **Open message actions menu** `i` - This shortcut shows the available message actions of the selected message (outlined in blue).
|
||||
* **Edit a message you sent** `i` then `Enter` - This shortcut allows the user to edit the selected message (outlined in blue) if the user authored the selected message. If the selected message was written by another user, this shortcut will enable the user to view the source code of the message.
|
||||
* **Show these keyboard shortcuts** `?` - This shortcut makes a modal window with a guide to all possible keyboard shortcuts appear.
|
||||
|
||||
* **Open message actions menu** `i` - This shortcut shows the
|
||||
available message actions of the selected message (outlined in
|
||||
blue).
|
||||
* **Edit a message you sent** `i` then `Enter` - This shortcut allows
|
||||
the user to edit the selected message (outlined in blue) if the user
|
||||
authored the selected message. If the selected message was written
|
||||
by another user, this shortcut will enable the user to view the
|
||||
source code of the message.
|
||||
* **Show these keyboard shortcuts** `?` - This shortcut makes a modal
|
||||
window with a guide to all possible keyboard shortcuts appear.
|
||||
|
||||
@@ -1,28 +1,44 @@
|
||||
# Message display settings
|
||||
|
||||

|
||||
|
||||
By default, messages in Zulip are displayed in English with a 12-hour timestamp, and the user list is displayed on the right side of the window.
|
||||
By default, messages in Zulip are displayed in English with a 12-hour
|
||||
timestamp, and the user list is displayed on the right side of the
|
||||
window.
|
||||
|
||||
However, there are a few reasons you might want to modify your message display settings. For example, you may want to do this if you speak a non-English language as your first language, are used to a 24-hour convention for displaying time, or have a narrow screen and want to conserve space.
|
||||
However, there are a few reasons you might want to modify your message
|
||||
display settings. For example, you may want to do this if you speak a
|
||||
non-English language as your first language, are used to a 24-hour
|
||||
convention for displaying time, or have a narrow screen and want to
|
||||
conserve space.
|
||||
|
||||
## Display options
|
||||
Listed below are the current message display settings that Zulip supports. After editing your message display settings, you will need to reload your screen for any changes you make to take effect.
|
||||
|
||||
Listed below are the current message display settings that Zulip
|
||||
supports. After editing your message display settings, you will need
|
||||
to reload your screen for any changes you make to take effect.
|
||||
|
||||
### Select default language
|
||||
|
||||

|
||||
|
||||
See **[Changing the Default Language](/help/change-your-language)** to learn more about this option.
|
||||
|
||||
### Display user list on left side in narrow windows
|
||||
|
||||

|
||||
|
||||

|
||||
|
||||
See **[Move the user list to the left sidebar](/help/move-the-users-list-to-the-left-sidebar)** to learn more about this option.
|
||||
See
|
||||
**[Move the user list to the left sidebar](/help/move-the-users-list-to-the-left-sidebar)**
|
||||
to learn more about this option.
|
||||
|
||||
## Display time in 24-hour format
|
||||

|
||||
|
||||

|
||||
|
||||
See **[Change the date and time format](/help/change-the-date-and-time-format)** to learn more about this option.
|
||||
See
|
||||
**[Change the date and time format](/help/change-the-date-and-time-format)**
|
||||
to learn more about this option.
|
||||
|
||||
@@ -1,17 +1,22 @@
|
||||
# Move the user list to the left sidebar
|
||||
|
||||
By default, the **Users** list is displayed on the right side of the Zulip window.
|
||||
On mobile devices with narrow screens, the **Users** list is hidden to save space.
|
||||
If you would like to see the **Users** list on your mobile device, you can
|
||||
choose to move it to the left side of the screen.
|
||||
By default, the **Users** list is displayed on the right side of the
|
||||
Zulip window. On mobile devices with narrow screens, the **Users**
|
||||
list is hidden to save space. If you would like to see the **Users**
|
||||
list on your mobile device, you can choose to move it to the left side
|
||||
of the screen.
|
||||
|
||||
You can easily change the location of the **Users** list by following a few steps.
|
||||
|
||||
{!go-to-the.md!} [Display Settings](/#settings/display-settings)
|
||||
{!settings.md!}
|
||||
|
||||
4. Select the option labeled **Display user list on left side in narrow windows**, then reload the page in order for the change to take effect.
|
||||
2. Select the option labeled **Display user list on left side in
|
||||
narrow windows**, then reload the page in order for the change to
|
||||
take effect.
|
||||
|
||||

|
||||
|
||||
When this option is selected, the user list located on the right by default will be listed under the **Streams** section in the left sidebar when the window size is under 1165 pixels.
|
||||
When this option is selected, the user list located on the right by
|
||||
default will be listed under the **Streams** section in the left
|
||||
sidebar when the window size is under 1165 pixels.
|
||||
|
||||
@@ -1,11 +1,14 @@
|
||||
# Previewing your message
|
||||
|
||||
You can preview your message before you send it by clicking the **eye** () icon.
|
||||
You can preview your message before you send it by clicking the
|
||||
**eye** () icon.
|
||||
|
||||

|
||||
|
||||

|
||||
|
||||
To resume editing, click the **pencil and paper** () icon that has replaced the eye icon.
|
||||
To resume editing, click the **pencil and paper**
|
||||
() icon that
|
||||
has replaced the eye icon.
|
||||
|
||||
**[Go to "Table of contents"](/help/#using-zulip)**
|
||||
|
||||
@@ -27,7 +27,8 @@ top of your chat window.
|
||||
|
||||
### Filtering Messages
|
||||
|
||||
You can search for messages that match certain criteria, like the author of the message, the stream they were sent in, etc.
|
||||
You can search for messages that match certain criteria, like the
|
||||
author of the message, the stream they were sent in, etc.
|
||||
|
||||
* Filter your messages with so-called *operators* of the form `operator:operand`.
|
||||
|
||||
@@ -38,7 +39,8 @@ You can search for messages that match certain criteria, like the author of the
|
||||
* You can combine the *operators* with the keyword search described formerly.
|
||||
|
||||
* To see a list of search operators, go to the cog
|
||||
() in the upper right corner of the right sidebar and choose “Search help” from the drop-down menu:
|
||||
() in the upper right corner of
|
||||
the right sidebar and choose “Search help” from the drop-down menu:
|
||||
|
||||
<p align="center"><img src="/static/images/help/search-messages/search-help.png" width="400"></p>
|
||||
|
||||
@@ -47,8 +49,11 @@ Here are a few examples on how to use search operators:
|
||||
* Example 1<p align="top"><img src="/static/images/help/search-messages/search-example-1.png" width="600"></p>
|
||||
*Explanation*: Search for all messages in the stream *Scotland* that contain a link. <br/><br/>
|
||||
|
||||
* Example 2<p align="top"><img src="/static/images/help/search-messages/search-example-2.png" width="600"></p>
|
||||
*Explanation*: Search for all messages from the user *iago@zulip.com* in the stream *errors* that contain the words *bug* and *code*. <br/><br/>
|
||||
* Example 2<p align="top"><img
|
||||
*src="/static/images/help/search-messages/search-example-2.png"
|
||||
*width="600"></p> Explanation*: Search for all messages from the user
|
||||
**iago@zulip.com* in the stream *errors* that contain the words *bug*
|
||||
*and *code*. <br/><br/>
|
||||
|
||||
* Example 3<p align="top"><img src="/static/images/help/search-messages/search-example-3.png" width="600"></p>
|
||||
*Explanation*: Search for all messages that you starred.
|
||||
|
||||
@@ -1,23 +1,35 @@
|
||||
# Private Message
|
||||
|
||||
Zulip allows users to send private messages to each other.
|
||||
## There are two ways to send a Private Message :
|
||||
|
||||
## There are two ways to send a Private Message:
|
||||
|
||||
### Way 1:
|
||||
* To submit a new private message, first click on the `New Private Message` button located at the bottom of your screen.
|
||||
|
||||
* To submit a new private message, first click on the `New Private
|
||||
Message` button located at the bottom of your screen.
|
||||
|
||||
* The following box will be displayed
|
||||

|
||||
|
||||
* In the **one or more people...** field, input the username or email address of the user you want to privately message.
|
||||
When you begin typing an email address or username, autocomplete suggestions will appear.
|
||||
* In the **one or more people...** field, input the username or email
|
||||
address of the user you want to privately message. When you begin
|
||||
typing an email address or username, autocomplete suggestions will
|
||||
appear.
|
||||
|
||||
* If you attempt to input a nonexistent username or email address, an error message will appear.
|
||||
* If you attempt to input a nonexistent username or email address, an
|
||||
error message will appear.
|
||||
|
||||
### Way 2:
|
||||
+ You also can click on the **user's name** in the `USERS` panel on the right and click on `down arrow` that
|
||||
gets visible when hovering over the name and click on the option `Compose a private message to <user's name>`
|
||||
and write the message in the compose box.
|
||||
|
||||
You can always discard your message by clicking the **x** () icon located at the top-right corner of your compose box.
|
||||
* You also can click on the **user's name** in the `USERS` panel on
|
||||
the right and click on `down arrow` that gets visible when hovering
|
||||
over the name and click on the option `Compose a private message to
|
||||
<user's name>` and write the message in the compose box.
|
||||
|
||||
You can always discard your message by clicking the **x**
|
||||
() icon located at the top-right corner
|
||||
of your compose box.
|
||||
|
||||
**[Go back to “Streams and private messages”](/help/streams-and-private-messages)**
|
||||
|
||||
|
||||
@@ -1,20 +1,31 @@
|
||||
## Sending a new stream message
|
||||
|
||||

|
||||
|
||||
To submit a new stream message, first click the **New stream message** button located at the bottom of your screen.
|
||||
To submit a new stream message, first click the **New stream message**
|
||||
button located at the bottom of your screen.
|
||||
|
||||

|
||||
|
||||
A box similar to the one shown in the above image will appear.
|
||||
|
||||
In the **Stream** field, input the name of the stream you want your message to be located in. When you begin typing a stream name, autocomplete suggestions will appear.
|
||||
In the **Stream** field, input the name of the stream you want your
|
||||
message to be located in. When you begin typing a stream name,
|
||||
autocomplete suggestions will appear.
|
||||
|
||||

|
||||
|
||||
If you attempt to input a nonexistent stream name, an error message will appear.
|
||||
If you attempt to input a nonexistent stream name, an error message
|
||||
will appear.
|
||||
|
||||
Once you have entered your stream name, enter the topic for your message in the **Topic** field. Your topic name can be no longer than 52 characters.
|
||||
Once you have entered your stream name, enter the topic for your
|
||||
message in the **Topic** field. Your topic name can be no longer than
|
||||
52 characters.
|
||||
|
||||
Finally, enter your message in the box labeled **Compose your message here...** or messaging box. You can now send your message to the specified stream under the specified topic.
|
||||
Finally, enter your message in the box labeled **Compose your message
|
||||
here...** or messaging box. You can now send your message to the
|
||||
specified stream under the specified topic.
|
||||
|
||||
You can always delete your message by clicking the **x** () icon located at the top-right corner of your messaging box.
|
||||
You can always delete your message by clicking the **x**
|
||||
() icon located at the top-right corner
|
||||
of your messaging box.
|
||||
|
||||
@@ -7,39 +7,55 @@ if your login page doesn't have some of the options described here!
|
||||
|
||||
## Signing in with your email address
|
||||
|
||||
You can sign into your Zulip organization using your email address by following a few simple steps.
|
||||
You can sign into your Zulip organization using your email address by
|
||||
following a few simple steps.
|
||||
|
||||
1. In the field labeled **Email**, enter the email address that you used to sign up for Zulip. Please note that the **Email** field is case-sensitive.
|
||||
1. In the field labeled **Email**, enter the email address that you
|
||||
used to sign up for Zulip. Please note that the **Email** field is
|
||||
case-sensitive.
|
||||
|
||||
!!! tip ""
|
||||
If you've forgotten which email you used to sign up for Zulip, you can try searching your email accounts for the e-mail you received when you first signed up. The subject line is "Welcome to Zulip".
|
||||
If you've forgotten which email you used to sign up for
|
||||
Zulip, you can try searching your email accounts for the
|
||||
e-mail you received when you first signed up. The subject line
|
||||
is "Welcome to Zulip".
|
||||
|
||||
2. In the field labeled **Password**, enter your password. Please note that the **Password** field is case-sensitive.
|
||||
2. In the field labeled **Password**, enter your password. Please note
|
||||
that the **Password** field is case-sensitive.
|
||||
|
||||
!!! tip ""
|
||||
If you've forgotten your password, see the [Change your password](/help/change-your-password) page for instructions on how to reset it.
|
||||
If you've forgotten your password, see the
|
||||
[Change your password](/help/change-your-password) page for
|
||||
instructions on how to reset it.
|
||||
|
||||
## Signing in with your Google account
|
||||
|
||||
If your organization has enabled Google authentication, you can sign into Zulip using your Google account by following a few simple steps.
|
||||
If your organization has enabled Google authentication, you can sign
|
||||
into Zulip using your Google account by following a few simple steps.
|
||||
|
||||
1. Click the **Sign in with Google** button located under the **Login** button and **Forgot your password?** link.
|
||||
1. Click the **Sign in with Google** button located under the
|
||||
**Login** button and **Forgot your password?** link.
|
||||
|
||||

|
||||
|
||||
2. If you are not signed into a Google account, Google will ask you to enter the credentials to your Google account.
|
||||
2. If you are not signed into a Google account, Google will ask you to
|
||||
enter the credentials to your Google account.
|
||||
|
||||

|
||||
|
||||
3. If you're signing into Zulip with a Google account for the first time, you will be taken to a page titled **Request for permission**.
|
||||
3. If you're signing into Zulip with a Google account for the first
|
||||
time, you will be taken to a page titled **Request for
|
||||
permission**.
|
||||
|
||||

|
||||
|
||||
Zulip requires knowledge of your email address and basic profile info, such as your name, for login purposes.
|
||||
Zulip requires knowledge of your email address and basic profile
|
||||
info, such as your name, for login purposes.
|
||||
|
||||
4. Click the **Allow** button to finish your Google login.
|
||||
|
||||
If you click the **Deny** button, Zulip cannot finish logging you in, and you will be redirected to the Zulip login page.
|
||||
If you click the **Deny** button, Zulip cannot finish logging you
|
||||
in, and you will be redirected to the Zulip login page.
|
||||
|
||||
## Signing in with your GitHub account
|
||||
|
||||
@@ -50,11 +66,13 @@ Zulip using your GitHub account by following a few simple steps.
|
||||
|
||||

|
||||
|
||||
2. If you are not signed into a GitHub account, GitHub will ask you to enter the credentials for your GitHub account.
|
||||
2. If you are not signed into a GitHub account, GitHub will ask you to
|
||||
enter the credentials for your GitHub account.
|
||||
|
||||

|
||||
|
||||
3. If you're signing into Zulip with a GitHub account for the first time, you will be taken to a page titled **Authorize application**.
|
||||
3. If you're signing into Zulip with a GitHub account for the first
|
||||
time, you will be taken to a page titled **Authorize application**.
|
||||
|
||||

|
||||
|
||||
|
||||
@@ -1,17 +1,29 @@
|
||||
# Streams and private messages
|
||||
|
||||

|
||||
|
||||
Zulip supports both **private messaging** and group chats via conversation **streams**.
|
||||
|
||||
**Streams** are either:
|
||||
* **Public** - Public streams are for open discussions. All users can subscribe to public streams and discuss there. Any Zulip user can join any public stream in the realm, and can view the complete message history of any public stream without joining the stream.
|
||||
* **Private** - Private streams are for confidential discussions and are only visible to users who've been invited to subscribe to them. Users who are not members of a private stream cannot subscribe to the stream or read or send messages in the stream.
|
||||
* **Public** - Public streams are for open discussions. All users can
|
||||
subscribe to public streams and discuss there. Any Zulip user can
|
||||
join any public stream in the realm, and can view the complete
|
||||
message history of any public stream without joining the stream.
|
||||
* **Private** - Private streams are for confidential discussions and
|
||||
are only visible to users who've been invited to subscribe to
|
||||
them. Users who are not members of a private stream cannot subscribe
|
||||
to the stream or read or send messages in the stream.
|
||||
|
||||
**Private messaging** can either be done in a **one-on-one** or in a **group** conversation. They can only be seen by users that are in the group.
|
||||
**Private messaging** can either be done in a **one-on-one** or in a
|
||||
**group** conversation. They can only be seen by users that are in
|
||||
the group.
|
||||
|
||||
## Sending a new stream message
|
||||
|
||||
Read about sending a new stream message [here](/help/send-a-stream-message).
|
||||
|
||||
## Private messaging
|
||||
|
||||

|
||||
|
||||

|
||||
@@ -19,29 +31,43 @@ Read about sending a new stream message [here](/help/send-a-stream-message).
|
||||
See **["Send a private message"](/help/send-a-private-message)** to learn more about sending a private message.
|
||||
|
||||
## Other features
|
||||
While sending either a stream or private message, several features located below the messaging box in the bottom-left corner can aid you in composing your message.
|
||||
|
||||
While sending either a stream or private message, several features
|
||||
located below the messaging box in the bottom-left corner can aid you
|
||||
in composing your message.
|
||||
|
||||
### Emoji
|
||||
|
||||

|
||||
|
||||
Clicking the **smiley face** () icon allows a box to appear featuring Zulip's vast collection of emojis. You can select an emoji to include in your message.
|
||||
Clicking the **smiley face**
|
||||
() icon allows a
|
||||
box to appear featuring Zulip's vast collection of emojis. You can
|
||||
select an emoji to include in your message.
|
||||
|
||||
### Attach files
|
||||
|
||||

|
||||
|
||||
Clicking the **paper clip** () icon allows you to select a file from your computer and attach it to your message, uploading it to Zulip to share with your peers.
|
||||
Clicking the **paper clip**
|
||||
() icon allows you to
|
||||
select a file from your computer and attach it to your message,
|
||||
uploading it to Zulip to share with your peers.
|
||||
|
||||

|
||||
|
||||
While the file is uploading, a blue box labeled **Uploading...** will appear, and a link to your file will be included in your message once the file has been uploaded.
|
||||
While the file is uploading, a blue box labeled **Uploading...** will
|
||||
appear, and a link to your file will be included in your message once
|
||||
the file has been uploaded.
|
||||
|
||||
### Formatting
|
||||
|
||||

|
||||
|
||||
Clicking the **A** () icon will reveal a modal window with a summary of message formatting in Zulip. For more information on message formatting, see our [message formatting guide](/help/format-your-message-using-markdown).
|
||||
Clicking the **A** () icon
|
||||
will reveal a modal window with a summary of message formatting in
|
||||
Zulip. For more information on message formatting, see our
|
||||
[message formatting guide](/help/format-your-message-using-markdown).
|
||||
|
||||
### Restore draft
|
||||
Read about restoring the draft of a message [here](/help/restore-the-last-unsent-message).
|
||||
|
||||
@@ -1,11 +1,15 @@
|
||||
# The #announce stream
|
||||
|
||||
The #announce stream is just like other streams in most ways, but it's conventionally used for realm-wide announcements.
|
||||
The #announce stream is just like other streams in most ways, but it's
|
||||
conventionally used for realm-wide announcements.
|
||||
|
||||

|
||||
|
||||
By default, everybody is subscribed to this stream. For this reason, you'll want to keep the traffic on it low, so that people don't mute it and miss an important announcement.
|
||||
By default, everybody is subscribed to this stream. For this reason,
|
||||
you'll want to keep the traffic on it low, so that people don't mute
|
||||
it and miss an important announcement.
|
||||
|
||||
Additionally, Zulip's notification bot uses this stream for its messages.
|
||||
Additionally, Zulip's notification bot uses this stream for its
|
||||
messages.
|
||||
|
||||
|
||||
|
||||
@@ -2,28 +2,48 @@
|
||||
|
||||
Zulip allows you to easily attach files, including images, sound, and video by:
|
||||
|
||||
- *Clicking the Paperclip Icon* Use the paperclip icon () located under the message field.
|
||||
- *Dragging* You may also drag and drop files on the message field. The files are uploaded to a server and a link is supplied, but a thumbnail is displayed if possible. The link to the file will be in Markdown format: `[link_text](link_URL)`
|
||||
- *Clicking the Paperclip Icon* Use the paperclip icon
|
||||
() located under the
|
||||
message field.
|
||||
- *Dragging* You may also drag and drop files on the message
|
||||
field. The files are uploaded to a server and a link is supplied,
|
||||
but a thumbnail is displayed if possible. The link to the file will
|
||||
be in Markdown format: `[link_text](link_URL)`
|
||||
|
||||

|
||||
|
||||
If you wish to give your image a caption or title, you may add text before or after the generated link. Any text you add in the box will not break the link to your file so long as the file link remains intact.
|
||||
If you wish to give your image a caption or title, you may add text
|
||||
before or after the generated link. Any text you add in the box will
|
||||
not break the link to your file so long as the file link remains
|
||||
intact.
|
||||
|
||||
---
|
||||
|
||||
After submitting your message, you will see a clickable thumbnail if your file is a common image type (i.e. PNG, JPEG, etc.). All other files will simply have a link displayed.
|
||||
After submitting your message, you will see a clickable thumbnail if
|
||||
your file is a common image type (i.e. PNG, JPEG, etc.). All other
|
||||
files will simply have a link displayed.
|
||||
|
||||

|
||||
|
||||
### Link Behavior
|
||||
|
||||
Clicking all file links will open a new tab that will either 1. display the file if it is an image or 2. download the file automatically to your computer.
|
||||
Clicking all file links will open a new tab that will
|
||||
either 1. display the file if it is an image or 2. download the file
|
||||
automatically to your computer.
|
||||
|
||||
If the file has a thumbnail, clicking it will open a lightbox modal with varying options depending on the media type. Images may be opened in new tabs or downloaded, while videos from Youtube may only be opened (and not downloaded). You can exit out of a lightbox by clicking the space around the media preview or by clicking the exit button found in the upper right-hand corner.
|
||||
If the file has a thumbnail, clicking it will open a lightbox modal
|
||||
with varying options depending on the media type. Images may be opened
|
||||
in new tabs or downloaded, while videos from Youtube may only be
|
||||
opened (and not downloaded). You can exit out of a lightbox by
|
||||
clicking the space around the media preview or by clicking the exit
|
||||
button found in the upper right-hand corner.
|
||||
|
||||
|
||||
### Sharing Files from External Websites
|
||||
|
||||
Images and videos shared from external websites, such as Imgur or Youtube, may have previews generated as well. Clicking previews of images/videos from external websites will lead to the same lightbox behavior described above.
|
||||
Images and videos shared from external websites, such as Imgur or
|
||||
Youtube, may have previews generated as well. Clicking previews of
|
||||
images/videos from external websites will lead to the same lightbox
|
||||
behavior described above.
|
||||
|
||||

|
||||
|
||||
@@ -1,10 +1,14 @@
|
||||
# Viewing information about a message
|
||||
|
||||
To view more information about a message, first locate the message you want to learn more about in your view. Click on the name of the user that sent the message; the message sender's name turns blue upon hover.
|
||||
To view more information about a message, first locate the message you
|
||||
want to learn more about in your view. Click on the name of the user
|
||||
that sent the message; the message sender's name turns blue upon
|
||||
hover.
|
||||
|
||||

|
||||
|
||||
Upon clicking on the message sender's name, a tooltip will appear with more information about the message.
|
||||
Upon clicking on the message sender's name, a tooltip will appear with
|
||||
more information about the message.
|
||||
|
||||

|
||||
|
||||
@@ -24,20 +28,32 @@ Upon clicking on the message sender's name, a tooltip will appear with more info
|
||||
|
||||
In this example, the message was sent at **December 20, 2016** at **8:23:20 A.M. PST (UTC -8)**.
|
||||
|
||||
4. Clicking the **Send a private message** link allows you to directly send a private message to the message sender.
|
||||
4. Clicking the **Send a private message** link allows you to directly
|
||||
send a private message to the message sender.
|
||||
|
||||

|
||||
|
||||
In this example, clicking on the link transforms your messaging box to send a private message to **King Hamlet**.
|
||||
In this example, clicking on the link transforms your messaging
|
||||
box to send a private message to **King Hamlet**.
|
||||
|
||||
5. Clicking the **Narrow to private message** link narrows your view to display all private messages exchanged between the message sender and you by using the search operator `pm-with`.
|
||||
5. Clicking the **Narrow to private message** link narrows your view
|
||||
to display all private messages exchanged between the message
|
||||
sender and you by using the search operator `pm-with`.
|
||||
|
||||

|
||||
|
||||
In this example, clicking on the link transforms your view to show all private messages exchanged between **King Hamlet** and you by using the search operator `pm-with:hamlet@zulip.com`.
|
||||
In this example, clicking on the link transforms your view to show
|
||||
all private messages exchanged between **King Hamlet** and you by
|
||||
using the search operator `pm-with:hamlet@zulip.com`.
|
||||
|
||||
6. Clicking the **Narrow to messages sent by** link narrows your view to display all messages the message sender sent to streams that you're subscribed to and private group chats you're both in using the search operator by `sender`.
|
||||
6. Clicking the **Narrow to messages sent by** link narrows your view
|
||||
to display all messages the message sender sent to streams that
|
||||
you're subscribed to and private group chats you're both in using
|
||||
the search operator by `sender`.
|
||||
|
||||

|
||||
|
||||
In this example, clicking on the link transforms your view to show all messages sent by **King Hamlet** sent to public streams you're subscribed to as well as private group chats you're both in by using the search operator `sender:hamlet@zulip.com`.
|
||||
In this example, clicking on the link transforms your view to show
|
||||
all messages sent by **King Hamlet** sent to public streams you're
|
||||
subscribed to as well as private group chats you're both in by
|
||||
using the search operator `sender:hamlet@zulip.com`.
|
||||
|
||||
@@ -1,13 +1,19 @@
|
||||
# View the exact time a message was sent
|
||||
|
||||
To see the exact time that a particular message was sent, look for the message's timestamp located on the right-hand side of the message's content.
|
||||
To see the exact time that a particular message was sent, look for the
|
||||
message's timestamp located on the right-hand side of the message's
|
||||
content.
|
||||
|
||||

|
||||
|
||||
Depending on your settings, the message's timestamp is displayed in either a 12-hour or 24-hour format; to change the format your messages are displayed in, see [here](/help/change-the-date-and-time-format).
|
||||
Depending on your settings, the message's timestamp is displayed in
|
||||
either a 12-hour or 24-hour format; to change the format your messages
|
||||
are displayed in, see [here](/help/change-the-date-and-time-format).
|
||||
|
||||
## Message information tooltip
|
||||
|
||||

|
||||
|
||||
The message information tooltip offers more details on when a message was sent, such as its date. To view the message information tooltip, simply click on the name of the user that sent the message.
|
||||
The message information tooltip offers more details on when a message
|
||||
was sent, such as its date. To view the message information tooltip,
|
||||
simply click on the name of the user that sent the message.
|
||||
|
||||
Reference in New Issue
Block a user