diff --git a/help-beta/astro.config.mjs b/help-beta/astro.config.mjs index 9e6e0406c3..bb433fee32 100644 --- a/help-beta/astro.config.mjs +++ b/help-beta/astro.config.mjs @@ -8,6 +8,345 @@ export default defineConfig({ 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', + 'getting-your-organization-started-with-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: [ + 'trying-out-zulip', + 'zulip-cloud-or-self-hosting', + '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: '../', + } + ] }), ], }); diff --git a/help-beta/src/styles/main.css b/help-beta/src/styles/main.css new file mode 100644 index 0000000000..4e5f94be81 --- /dev/null +++ b/help-beta/src/styles/main.css @@ -0,0 +1,5 @@ +.non-clickable-sidebar-heading { + font-size: 1.15rem; + pointer-events: none; + cursor: default; +}