help: Move static/images/help to starlight_help/src/images.

Astro was importing these images and doing it's own processing anyways,
there was not a reason for these images to stay in the static folder.

For channels-and-topics.png, we keep the help center directory as the
source directory for two symlinks since that is where the image is
likely to stay the longest.
This commit is contained in:
Shubham Padia
2025-09-19 13:02:05 +00:00
committed by Tim Abbott
parent 50545d04db
commit 3b1f4a9d09
54 changed files with 30 additions and 35 deletions

View File

@@ -24,7 +24,7 @@ Starlight is a full-featured documentation theme built on top of the
for content driven websites. The content for the help center articles are for content driven websites. The content for the help center articles are
[MDX](https://mdxjs.com/) files, which live at `starlight_help/src/content/docs` [MDX](https://mdxjs.com/) files, which live at `starlight_help/src/content/docs`
in the [main Zulip server repository](https://github.com/zulip/zulip). in the [main Zulip server repository](https://github.com/zulip/zulip).
Images are usually linked from `static/images/help/`. Images are usually linked from `starlight_help/src/images`.
Zulip help center documentation is available under `/help/` on any Zulip server; Zulip help center documentation is available under `/help/` on any Zulip server;
(e.g., <https://zulip.com/help/> or `http://localhost:9991/help/` in (e.g., <https://zulip.com/help/> or `http://localhost:9991/help/` in
@@ -284,7 +284,7 @@ Zulip browser window in a screenshot; instead, it should only show
relevant parts of the app. In addition, the screenshot should always relevant parts of the app. In addition, the screenshot should always
come _after_ the text that describes it, never before. come _after_ the text that describes it, never before.
Images used in the help center can be found at `static/images/help`. Images used in the help center can be found at `starlight_help/src/images`.
## MDX features and custom Zulip components ## MDX features and custom Zulip components

View File

@@ -14,4 +14,4 @@ bullet
### What it looks like ### What it looks like
![Markdown bullets](../../../../../static/images/help/markdown-bullets.png) ![Markdown bullets](../../../images/markdown-bullets.png)

View File

@@ -26,7 +26,7 @@ def fib(n):
### What it looks like ### What it looks like
![Markdown code](../../../../../static/images/help/markdown-code.png) ![Markdown code](../../../images/markdown-code.png)
<ZulipTip> <ZulipTip>
A widget in the top right corner of code blocks allows you to easily A widget in the top right corner of code blocks allows you to easily

View File

@@ -6,4 +6,4 @@
### What it looks like ### What it looks like
![Markdown emoji](../../../../../static/images/help/markdown-emoji.png) ![Markdown emoji](../../../images/markdown-emoji.png)

View File

@@ -7,4 +7,4 @@
### What it looks like ### What it looks like
![Markdown emphasis](../../../../../static/images/help/markdown-emphasis.png) ![Markdown emphasis](../../../images/markdown-emphasis.png)

View File

@@ -17,8 +17,8 @@ Our next meeting is scheduled for <time:2024-08-06T17:00:00+01:00>.
A person in San Francisco will see: A person in San Francisco will see:
![Global time San Francisco example](../../../../../static/images/help/global-time-example-sf.png) ![Global time San Francisco example](../../../images/global-time-example-sf.png)
While someone in London will see: While someone in London will see:
![Global time London example](../../../../../static/images/help/global-time-example-london.png) ![Global time London example](../../../images/global-time-example-london.png)

View File

@@ -11,4 +11,4 @@ Displayed:
### What it looks like ### What it looks like
![Markdown LaTeX](../../../../../static/images/help/markdown-latex.png) ![Markdown LaTeX](../../../images/markdown-latex.png)

View File

@@ -11,4 +11,4 @@ Custom linkifier: For example, #2468 can automatically link to an issue in your
### What it looks like ### What it looks like
![Markdown links](../../../../../static/images/help/markdown-links.png) ![Markdown links](../../../images/markdown-links.png)

View File

@@ -8,4 +8,4 @@ For example, if you are **Ada Starr**:
### What it looks like ### What it looks like
![Markdown status](../../../../../static/images/help/markdown-status.png) ![Markdown status](../../../images/markdown-status.png)

View File

@@ -17,4 +17,4 @@ Wildcard mentions: @**all**, @**everyone**, @**channel**, @**topic** (two `*`)
### What it looks like ### What it looks like
![Markdown mentions](../../../../../static/images/help/markdown-mentions.png) ![Markdown mentions](../../../images/markdown-mentions.png)

View File

@@ -14,4 +14,4 @@ import {Steps} from "@astrojs/starlight/components";
### What it looks like ### What it looks like
![Markdown numbered lists](../../../../../static/images/help/markdown-numbered-lists.png) ![Markdown numbered lists](../../../images/markdown-numbered-lists.png)

View File

@@ -16,4 +16,4 @@ Under the line
### What it looks like ### What it looks like
![Markdown paragraph](../../../../../static/images/help/markdown-paragraph.png) ![Markdown paragraph](../../../images/markdown-paragraph.png)

View File

@@ -9,4 +9,4 @@ Coffee
### What it looks like ### What it looks like
![Markdown polls](../../../../../static/images/help/markdown-polls.png) ![Markdown polls](../../../images/markdown-polls.png)

View File

@@ -15,4 +15,4 @@ quote in two paragraphs
### What it looks like ### What it looks like
![Markdown quotes](../../../../../static/images/help/markdown-quotes.png) ![Markdown quotes](../../../images/markdown-quotes.png)

View File

@@ -21,8 +21,8 @@ Leave the heading blank if you like.
Collapsed spoilers: Collapsed spoilers:
![Spoiler collapsed](../../../../../static/images/help/spoiler-collapsed.png) ![Spoiler collapsed](../../../images/spoiler-collapsed.png)
Expanded spoilers: Expanded spoilers:
![Spoiler expanded](../../../../../static/images/help/spoiler-expanded.png) ![Spoiler expanded](../../../images/spoiler-expanded.png)

View File

@@ -18,4 +18,4 @@ import ZulipTip from "../../../components/ZulipTip.astro";
### What it looks like ### What it looks like
![Markdown table](../../../../../static/images/help/markdown-table.png) ![Markdown table](../../../images/markdown-table.png)

View File

@@ -12,4 +12,4 @@ Last task
Tasks are marked (and unmarked) as completed by clicking the checkboxes Tasks are marked (and unmarked) as completed by clicking the checkboxes
on the left. on the left.
![Markdown todo-lists](../../../../../static/images/help/markdown-todo.png) ![Markdown todo-lists](../../../images/markdown-todo.png)

View File

@@ -4,7 +4,7 @@ conversations are happening, and to read one conversation at a time.
Here is what topics look like in Zulip. Here is what topics look like in Zulip.
![Channels and topics](../../../../../static/images/help/channels-and-topics.png) ![Channels and topics](../../../images/channels-and-topics.png)
Topics are one of the most wonderful aspects of using Zulip: Topics are one of the most wonderful aspects of using Zulip:

View File

@@ -75,7 +75,7 @@ users** menu option if you have permission to invite users.
## Example email invitation ## Example email invitation
![Email invitation](../../../../static/images/help/example-invitation-email.png) ![Email invitation](../../images/example-invitation-email.png)
## Create a reusable invitation link ## Create a reusable invitation link

View File

@@ -15,7 +15,7 @@ import ChevronRightIcon from "~icons/zulip-icon/chevron-right";
Here is an overview of all the information and actions you can take in Zulip's Here is an overview of all the information and actions you can take in Zulip's
compose box. compose box.
![Compose box information and actions](../../../../static/images/help/compose-actions.png) ![Compose box information and actions](../../images/compose-actions.png)
## Composing to a different conversation ## Composing to a different conversation

View File

@@ -12,7 +12,7 @@ import MessageLongPressMenu from "./include/_MessageLongPressMenu.mdx";
There are many ways to interact with a Zulip message. Here's an overview of the There are many ways to interact with a Zulip message. Here's an overview of the
message actions in the web and desktop apps: message actions in the web and desktop apps:
![Message actions](../../../../static/images/help/message-actions.png) ![Message actions](../../images/message-actions.png)
In the mobile app, the message actions menu lets you: In the mobile app, the message actions menu lets you:

View File

@@ -122,7 +122,7 @@ configure SCIM provisioning for Zulip.
* Delete the other default entries leaving only the **active** and * Delete the other default entries leaving only the **active** and
**name.formatted** mappings, until your list looks like the **name.formatted** mappings, until your list looks like the
image below. image below.
![Attribute Mappings](../../../../static/images/help/entraid-scim-mappings.png) ![Attribute Mappings](../../images/entraid-scim-mappings.png)
1. Once your configuration is complete, set the **Provisioning 1. Once your configuration is complete, set the **Provisioning
Status** to **On** and then click **Save** to start the Microsoft Status** to **On** and then click **Save** to start the Microsoft
Entra provisioning service. Entra provisioning service.

View File

@@ -146,7 +146,7 @@ When pasting a large amount of text, you can convert it to a text file upload.
### What it looks like ### What it looks like
![Markdown image](../../../../static/images/help/markdown-image.png) ![Markdown image](../../images/markdown-image.png)
## File upload limits ## File upload limits

View File

@@ -32,7 +32,7 @@ user list styles. To avoid distraction, you can
Here is an overview of all the information and actions you can take in Zulip's Here is an overview of all the information and actions you can take in Zulip's
user list. user list.
![User list information and actions](../../../../static/images/help/user-list-actions.png) ![User list information and actions](../../images/user-list-actions.png)
## Filter users ## Filter users

View File

Before

Width:  |  Height:  |  Size: 180 KiB

After

Width:  |  Height:  |  Size: 180 KiB

View File

Before

Width:  |  Height:  |  Size: 168 KiB

After

Width:  |  Height:  |  Size: 168 KiB

View File

Before

Width:  |  Height:  |  Size: 23 KiB

After

Width:  |  Height:  |  Size: 23 KiB

View File

Before

Width:  |  Height:  |  Size: 134 KiB

After

Width:  |  Height:  |  Size: 134 KiB

View File

Before

Width:  |  Height:  |  Size: 17 KiB

After

Width:  |  Height:  |  Size: 17 KiB

View File

Before

Width:  |  Height:  |  Size: 23 KiB

After

Width:  |  Height:  |  Size: 23 KiB

View File

Before

Width:  |  Height:  |  Size: 11 KiB

After

Width:  |  Height:  |  Size: 11 KiB

View File

Before

Width:  |  Height:  |  Size: 13 KiB

After

Width:  |  Height:  |  Size: 13 KiB

View File

Before

Width:  |  Height:  |  Size: 9.8 KiB

After

Width:  |  Height:  |  Size: 9.8 KiB

View File

Before

Width:  |  Height:  |  Size: 4.8 KiB

After

Width:  |  Height:  |  Size: 4.8 KiB

View File

Before

Width:  |  Height:  |  Size: 12 KiB

After

Width:  |  Height:  |  Size: 12 KiB

View File

Before

Width:  |  Height:  |  Size: 6.5 KiB

After

Width:  |  Height:  |  Size: 6.5 KiB

View File

Before

Width:  |  Height:  |  Size: 27 KiB

After

Width:  |  Height:  |  Size: 27 KiB

View File

Before

Width:  |  Height:  |  Size: 19 KiB

After

Width:  |  Height:  |  Size: 19 KiB

View File

Before

Width:  |  Height:  |  Size: 38 KiB

After

Width:  |  Height:  |  Size: 38 KiB

View File

Before

Width:  |  Height:  |  Size: 9.5 KiB

After

Width:  |  Height:  |  Size: 9.5 KiB

View File

Before

Width:  |  Height:  |  Size: 24 KiB

After

Width:  |  Height:  |  Size: 24 KiB

View File

Before

Width:  |  Height:  |  Size: 6.8 KiB

After

Width:  |  Height:  |  Size: 6.8 KiB

View File

Before

Width:  |  Height:  |  Size: 3.2 KiB

After

Width:  |  Height:  |  Size: 3.2 KiB

View File

Before

Width:  |  Height:  |  Size: 11 KiB

After

Width:  |  Height:  |  Size: 11 KiB

View File

Before

Width:  |  Height:  |  Size: 33 KiB

After

Width:  |  Height:  |  Size: 33 KiB

View File

Before

Width:  |  Height:  |  Size: 112 KiB

After

Width:  |  Height:  |  Size: 112 KiB

View File

Before

Width:  |  Height:  |  Size: 39 KiB

After

Width:  |  Height:  |  Size: 39 KiB

View File

Before

Width:  |  Height:  |  Size: 67 KiB

After

Width:  |  Height:  |  Size: 67 KiB

View File

Before

Width:  |  Height:  |  Size: 274 KiB

After

Width:  |  Height:  |  Size: 274 KiB

View File

@@ -1 +1 @@
../help/channels-and-topics.png ../../../starlight_help/src/images/channels-and-topics.png

View File

@@ -1,3 +0,0 @@
<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px" width="100%" height="100%" viewBox="0 0 512 512" style="enable-background:new 0 0 512 512;" xml:space="preserve" fill="#5f5ffc">
<path d="M448,71.9c-17.3-13.4-41.5-9.3-54.1,9.1L214,344.2l-99.1-107.3c-14.6-16.6-39.1-17.4-54.7-1.8 c-15.6,15.5-16.4,41.6-1.7,58.1c0,0,120.4,133.6,137.7,147c17.3,13.4,41.5,9.3,54.1-9.1l206.3-301.7 C469.2,110.9,465.3,85.2,448,71.9z"/>
</svg>

Before

Width:  |  Height:  |  Size: 487 B

View File

@@ -1,3 +0,0 @@
<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px" width="100%" height="100%" viewBox="0 0 512 512" style="enable-background:new 0 0 512 512;" xml:space="preserve" fill="#b8b8b8">
<path d="M459.319,229.668c0,22.201-17.992,40.193-40.205,40.193H269.85v149.271c0,22.207-17.998,40.199-40.196,40.193 c-11.101,0-21.149-4.492-28.416-11.763c-7.276-7.281-11.774-17.324-11.769-28.419l-0.006-149.288H40.181 c-11.094,0-21.134-4.492-28.416-11.774c-7.264-7.264-11.759-17.312-11.759-28.413C0,207.471,17.992,189.475,40.202,189.475h149.267 V40.202C189.469,17.998,207.471,0,229.671,0c22.192,0.006,40.178,17.986,40.19,40.187v149.288h149.282 C441.339,189.487,459.308,207.471,459.319,229.668z"/>
</svg>

Before

Width:  |  Height:  |  Size: 756 B

View File

@@ -0,0 +1 @@
../../../../starlight_help/src/images/channels-and-topics.png

View File

@@ -40,7 +40,7 @@ no matter how many other conversations are going on.
If anything is out of place, its easy to move messages, rename and split If anything is out of place, its easy to move messages, rename and split
topics, or even move a topic to a different channel. topics, or even move a topic to a different channel.
![Channels and topics](/static/images/help/channels-and-topics.png) ![Channels and topics](/static/images/landing-page/why-zulip/channels-and-topics.png)
<br /> <br />