mirror of
				https://github.com/zulip/zulip.git
				synced 2025-11-04 05:53:43 +00:00 
			
		
		
		
	Creates a URLRedirect for this help center article to go to the new "Moving to Zulip" guide. Updates the astro.config.mjs file for the changes to the help center sidebar that have been made as part of the replacement of this help center guide. Fixes #31499.
		
			
				
	
	
		
			353 lines
		
	
	
		
			8.5 KiB
		
	
	
	
		
			JavaScript
		
	
	
	
	
	
			
		
		
	
	
			353 lines
		
	
	
		
			8.5 KiB
		
	
	
	
		
			JavaScript
		
	
	
	
	
	
import { defineConfig } from 'astro/config';
 | 
						|
import starlight from '@astrojs/starlight';
 | 
						|
 | 
						|
// https://astro.build/config
 | 
						|
export default defineConfig({
 | 
						|
	base: 'help-beta',
 | 
						|
	integrations: [
 | 
						|
		starlight({
 | 
						|
			title: 'Zulip help center',
 | 
						|
			pagination: false,
 | 
						|
			customCss: [
 | 
						|
				'./src/styles/main.css'
 | 
						|
			],
 | 
						|
			sidebar: [
 | 
						|
				{
 | 
						|
					label: 'Zulip homepage',
 | 
						|
					link: 'https://zulip.com'
 | 
						|
				},
 | 
						|
				{
 | 
						|
					label: 'Help center home',
 | 
						|
					slug: 'index'
 | 
						|
				},
 | 
						|
				{
 | 
						|
					label: 'Guides',
 | 
						|
					items: [
 | 
						|
						'getting-started-with-zulip',
 | 
						|
						'trying-out-zulip',
 | 
						|
						'zulip-cloud-or-self-hosting',
 | 
						|
						'moving-to-zulip',
 | 
						|
						'moderating-open-organizations',
 | 
						|
						'setting-up-zulip-for-a-class',
 | 
						|
						'using-zulip-for-a-class',
 | 
						|
						'using-zulip-via-email'
 | 
						|
					]
 | 
						|
				},
 | 
						|
				{
 | 
						|
					label: 'Getting started',
 | 
						|
					items: [
 | 
						|
						'join-a-zulip-organization',
 | 
						|
						'set-up-your-account',
 | 
						|
						'introduction-to-topics',
 | 
						|
						{
 | 
						|
							label: 'Starting a new topic',
 | 
						|
							link: '/introduction-to-topics#how-to-start-a-new-topic'
 | 
						|
						},
 | 
						|
						'finding-a-conversation-to-read',
 | 
						|
						'reading-conversations',
 | 
						|
						'starting-a-new-direct-message',
 | 
						|
						'replying-to-messages',
 | 
						|
						'messaging-tips',
 | 
						|
						'keyboard-shortcuts'
 | 
						|
					]
 | 
						|
				},
 | 
						|
				{
 | 
						|
					label: 'Setting up your organization',
 | 
						|
					items: [
 | 
						|
						'migrating-from-other-chat-tools',
 | 
						|
						'create-your-organization-profile',
 | 
						|
						'customize-organization-settings',
 | 
						|
						'create-channels',
 | 
						|
						'customize-settings-for-new-users',
 | 
						|
						'invite-users-to-join',
 | 
						|
						'create-user-groups',
 | 
						|
						'set-up-integrations'
 | 
						|
					]
 | 
						|
				},
 | 
						|
				{
 | 
						|
					label: 'Account basics',
 | 
						|
					items: [
 | 
						|
						'edit-your-profile',
 | 
						|
						'change-your-name',
 | 
						|
						'change-your-email-address',
 | 
						|
						'change-your-profile-picture',
 | 
						|
						'change-your-password',
 | 
						|
						'configure-email-visibility',
 | 
						|
						'logging-in',
 | 
						|
						'logging-out',
 | 
						|
						'switching-between-organizations',
 | 
						|
						'import-your-settings',
 | 
						|
						'review-your-settings',
 | 
						|
						'deactivate-your-account'
 | 
						|
					]
 | 
						|
				}, 
 | 
						|
				{
 | 
						|
					label: 'Preferences',
 | 
						|
					items: [
 | 
						|
						'dark-theme',
 | 
						|
						'font-size',
 | 
						|
						'change-your-language',
 | 
						|
						'change-your-timezone',
 | 
						|
						'change-the-time-format',
 | 
						|
						'configure-emoticon-translations',
 | 
						|
						'configure-home-view',
 | 
						|
						'enable-full-width-display',
 | 
						|
						'manage-your-uploaded-files'
 | 
						|
					]
 | 
						|
				},
 | 
						|
				{
 | 
						|
					label: 'Writing messages',
 | 
						|
					items: [
 | 
						|
						'format-your-message-using-markdown',
 | 
						|
						'mention-a-user-or-group',
 | 
						|
						'link-to-a-message-or-conversation',
 | 
						|
						'format-a-quote',
 | 
						|
						'quote-and-reply',
 | 
						|
						'emoji-and-emoticons',
 | 
						|
						'insert-a-link',
 | 
						|
						'share-and-upload-files',
 | 
						|
						'animated-gifs-from-giphy',
 | 
						|
						'text-emphasis',
 | 
						|
						'paragraph-and-section-formatting',
 | 
						|
						'bulleted-lists',
 | 
						|
						'numbered-lists',
 | 
						|
						'tables',
 | 
						|
						'code-blocks',
 | 
						|
						'latex',
 | 
						|
						'spoilers',
 | 
						|
						'me-action-messages',
 | 
						|
						'create-a-poll',
 | 
						|
						'collaborative-to-do-lists',
 | 
						|
						'global-times',
 | 
						|
						'start-a-call'
 | 
						|
					]
 | 
						|
				},
 | 
						|
				{
 | 
						|
					label: 'Sending messages',
 | 
						|
					items: [
 | 
						|
						'open-the-compose-box',
 | 
						|
						'mastering-the-compose-box',
 | 
						|
						'resize-the-compose-box',
 | 
						|
						'typing-notifications',
 | 
						|
						'preview-your-message-before-sending',
 | 
						|
						'verify-your-message-was-successfully-sent',
 | 
						|
						'edit-a-message',
 | 
						|
						'delete-a-message',
 | 
						|
						'view-and-edit-your-message-drafts',
 | 
						|
						'schedule-a-message',
 | 
						|
						'message-a-channel-by-email'
 | 
						|
					]
 | 
						|
				},
 | 
						|
				{
 | 
						|
					label: 'Reading messages',
 | 
						|
					items: [
 | 
						|
						'reading-strategies',
 | 
						|
						'inbox',
 | 
						|
						'recent-conversations',
 | 
						|
						'combined-feed',
 | 
						|
						'channel-feed',
 | 
						|
						'left-sidebar',
 | 
						|
						'message-actions',
 | 
						|
						'marking-messages-as-read',
 | 
						|
						'marking-messages-as-unread',
 | 
						|
						'configure-unread-message-counters',
 | 
						|
						'emoji-reactions',
 | 
						|
						'view-your-mentions',
 | 
						|
						'star-a-message',
 | 
						|
						'view-images-and-videos',
 | 
						|
						'view-messages-sent-by-a-user',
 | 
						|
						'link-to-a-message-or-conversation',
 | 
						|
						'search-for-messages',
 | 
						|
						'printing-messages',
 | 
						|
						'view-the-markdown-source-of-a-message',
 | 
						|
						'view-the-exact-time-a-message-was-sent',
 | 
						|
						'view-a-messages-edit-history',
 | 
						|
						'collapse-a-message',
 | 
						|
						'read-receipts'
 | 
						|
					]
 | 
						|
				},
 | 
						|
				{
 | 
						|
					label: 'People',
 | 
						|
					items: [
 | 
						|
						'user-list',
 | 
						|
						'status-and-availability',
 | 
						|
						'user-cards',
 | 
						|
						'view-someones-profile',
 | 
						|
						'direct-messages',
 | 
						|
						'user-groups',
 | 
						|
						'find-administrators',
 | 
						|
					]
 | 
						|
				},
 | 
						|
				{
 | 
						|
					label: 'Channels',
 | 
						|
					items: [
 | 
						|
						'introduction-to-channels',
 | 
						|
						'create-a-channel',
 | 
						|
						'pin-a-channel',
 | 
						|
						'change-the-color-of-a-channel',
 | 
						|
						'unsubscribe-from-a-channel',
 | 
						|
						'manage-inactive-channels',
 | 
						|
						'move-content-to-another-channel',
 | 
						|
						'view-channel-subscribers',
 | 
						|
					]
 | 
						|
				},
 | 
						|
				{
 | 
						|
					label: 'Topics',
 | 
						|
					items: [
 | 
						|
						'introduction-to-topics',
 | 
						|
						'rename-a-topic',
 | 
						|
						'resolve-a-topic',
 | 
						|
						'move-content-to-another-topic',
 | 
						|
						'delete-a-topic',
 | 
						|
					]
 | 
						|
				},
 | 
						|
				{
 | 
						|
					label: 'Notifications',
 | 
						|
					items: [
 | 
						|
						'channel-notifications',
 | 
						|
						'topic-notifications',
 | 
						|
						'follow-a-topic',
 | 
						|
						'dm-mention-alert-notifications',
 | 
						|
						'mute-a-channel',
 | 
						|
						'mute-a-topic',
 | 
						|
						'mute-a-user',
 | 
						|
						'email-notifications',
 | 
						|
						'desktop-notifications',
 | 
						|
						'mobile-notifications',
 | 
						|
						'do-not-disturb',
 | 
						|
					]
 | 
						|
				},
 | 
						|
				{
 | 
						|
					label: 'Apps',
 | 
						|
					items: [
 | 
						|
						{ 
 | 
						|
							'label': 'Download apps for every platform',
 | 
						|
							link: 'https://zulip.com/apps/'
 | 
						|
						},
 | 
						|
						'desktop-app-install-guide',
 | 
						|
						'supported-browsers',
 | 
						|
						'configure-how-links-open',
 | 
						|
						'connect-through-a-proxy',
 | 
						|
						'custom-certificates',
 | 
						|
					]
 | 
						|
				},
 | 
						|
				{
 | 
						|
					label: 'Zulip Administration',
 | 
						|
					link: '#',
 | 
						|
					attrs: {
 | 
						|
						class: 'non-clickable-sidebar-heading'
 | 
						|
					}
 | 
						|
				},
 | 
						|
				{
 | 
						|
					label: 'Organization basics',
 | 
						|
					items: [
 | 
						|
						'review-your-organization-settings',
 | 
						|
						'organization-type',
 | 
						|
						'communities-directory',
 | 
						|
						'import-from-mattermost',
 | 
						|
						'import-from-slack',
 | 
						|
						'import-from-rocketchat',
 | 
						|
						'configure-authentication-methods',
 | 
						|
						'saml-authentication',
 | 
						|
						'scim',
 | 
						|
						'export-your-organization',
 | 
						|
						'change-organization-url',
 | 
						|
						'deactivate-your-organization',
 | 
						|
						'analytics',
 | 
						|
						'linking-to-zulip',
 | 
						|
						'gdpr-compliance',
 | 
						|
					]
 | 
						|
				}, 
 | 
						|
				{
 | 
						|
					label: 'Users',
 | 
						|
					items: [
 | 
						|
						'roles-and-permissions',
 | 
						|
						'invite-new-users',
 | 
						|
						'restrict-account-creation',
 | 
						|
						'guest-users',
 | 
						|
						'manage-a-user',
 | 
						|
						'deactivate-or-reactivate-a-user',
 | 
						|
						'custom-profile-fields',
 | 
						|
						'configure-default-new-user-settings',
 | 
						|
						'configure-organization-language',
 | 
						|
						'manage-user-groups',
 | 
						|
						'change-a-users-role',
 | 
						|
						'change-a-users-name',
 | 
						|
						'manage-user-channel-subscriptions',
 | 
						|
						'restrict-name-and-email-changes',
 | 
						|
						'restrict-profile-picture-changes',
 | 
						|
						'restrict-permissions-of-new-members',
 | 
						|
					]
 | 
						|
				},
 | 
						|
				{
 | 
						|
					label: 'Channel Management',
 | 
						|
					items: [
 | 
						|
						'create-a-channel',
 | 
						|
						'channel-permissions',
 | 
						|
						'public-access-option',
 | 
						|
						'channel-posting-policy',
 | 
						|
						'configure-who-can-create-channels',
 | 
						|
						'configure-who-can-invite-to-channels',
 | 
						|
						'add-or-remove-users-from-a-channel',
 | 
						|
						'set-default-channels-for-new-users',
 | 
						|
						'rename-a-channel',
 | 
						|
						'change-the-channel-description',
 | 
						|
						'change-the-privacy-of-a-channel',
 | 
						|
						'archive-a-channel',
 | 
						|
					]
 | 
						|
				},
 | 
						|
				{
 | 
						|
					label: 'Organization Settings',
 | 
						|
					items: [
 | 
						|
						'custom-emoji',
 | 
						|
						'add-a-custom-linkifier',
 | 
						|
						'require-topics',
 | 
						|
						'restrict-direct-messages',
 | 
						|
						'restrict-wildcard-mentions',
 | 
						|
						'restrict-moving-messages',
 | 
						|
						'restrict-message-editing-and-deletion',
 | 
						|
						'disable-message-edit-history',
 | 
						|
						'allow-image-link-previews',
 | 
						|
						'hide-message-content-in-emails',
 | 
						|
						'message-retention-policy',
 | 
						|
						'digest-emails',
 | 
						|
						'disable-welcome-emails',
 | 
						|
						'configure-automated-notices',
 | 
						|
						'configure-multi-language-search',				
 | 
						|
					]
 | 
						|
				},
 | 
						|
				{
 | 
						|
					label: 'Bots & Integrations',
 | 
						|
					items: [
 | 
						|
						'bots-overview',
 | 
						|
						'integrations-overview',
 | 
						|
						'add-a-bot-or-integration',
 | 
						|
						'generate-integration-url',
 | 
						|
						'edit-a-bot',
 | 
						|
						'deactivate-or-reactivate-a-bot',
 | 
						|
						'request-an-integration',
 | 
						|
						'restrict-bot-creation',
 | 
						|
						'view-your-bots',
 | 
						|
						'view-all-bots-in-your-organization',
 | 
						|
					]
 | 
						|
				},
 | 
						|
				{
 | 
						|
					label: 'Support',
 | 
						|
					items: [
 | 
						|
						'view-zulip-version',
 | 
						|
						'zulip-cloud-billing',
 | 
						|
						'self-hosted-billing',
 | 
						|
						'support-zulip-project',
 | 
						|
						'linking-to-zulip-website',
 | 
						|
						'contact-support',
 | 
						|
					]
 | 
						|
				},
 | 
						|
				{
 | 
						|
					label: '◀ Back to Zulip',
 | 
						|
					link: '../',
 | 
						|
				}
 | 
						|
			]
 | 
						|
		}),
 | 
						|
	],
 | 
						|
});
 |