docusaurus.config.ts

import { themes as prismThemes } from 'prism-react-renderer';
import type { Config } from '@docusaurus/types';
import type * as Preset from '@docusaurus/preset-classic';

// This runs in Node.js - Don't use client-side code here (browser APIs, JSX...)

const config: Config = {
  title: 'Mixcore AIO Platform',
  tagline: 'The Enterprise-Grade .NET Core CMS & API Platform',
  favicon: 'img/favicon.ico',

  // Set the production url of your site here
  url: 'https://docs.mixcore.org',
  // Set the /<baseUrl>/ pathname under which your site is served
  // For GitHub pages deployment, it is often '/<projectName>/'
  baseUrl: '/',

  // GitHub pages deployment config.
  // If you aren't using GitHub pages, you don't need these.
  organizationName: 'mixcore', // Usually your GitHub org/user name.
  projectName: 'docs', // Usually your repo name.
  trailingSlash: false,

  deploymentBranch: 'gh-pages',

  onBrokenLinks: 'warn',
  onBrokenMarkdownLinks: 'warn',

  // Even if you don't use internationalization, you can use this field to set
  // useful metadata like html lang. For example, if your site is Chinese, you
  // may want to replace "en" with "zh-Hans".
  i18n: {
    defaultLocale: 'en',
    locales: ['en'],
  },

  presets: [
    [
      'classic',
      {
        docs: {
          sidebarPath: './sidebars.ts',
          path: 'docs',
          routeBasePath: '/',
          showLastUpdateAuthor: true,
          showLastUpdateTime: true,
          // Please change this to your repo.
          editUrl: 'https://github.com/mixcore/mix.core/tree/master/docs',
        },
        theme: {
          customCss: './src/css/custom.css',
        },
        sitemap: {},
        gtag: {
          trackingID: 'UA-134154017-3',
          anonymizeIP: true,
        },
      } satisfies Preset.Options,
    ],
  ],

  // Custom scripts to include in the <head> tag
  scripts: [
    {
      src: '/js/logo-color.js',
      async: true,
    },
  ],

  themeConfig: {
    // Replace with your project's social card
    image: 'img/mixcore-social-card.jpg',

    navbar: {
      title: 'Mixcore AIO Platform',
      logo: {
        alt: 'Mixcore AIO Platform Logo',
        src: 'img/mixcore-logo.png',
        srcDark: 'img/mixcore-logo.png',
      },
      items: [
        {
          type: 'docSidebar',
          sidebarId: 'tutorialSidebar',
          position: 'left',
          label: 'Documentation',
        },
        {
          href: 'https://mixcore.org',
          label: 'Website',
          position: 'left',
        },
        {
          href: 'https://api.mixcore.org',
          label: 'API Docs',
          position: 'left',
        },
        {
          href: 'https://github.com/orgs/mixcore/discussions',
          label: 'Discussions',
          position: 'left',
        },
        {
          href: 'https://github.com/mixcore/mix.core/releases',
          label: 'Download',
          position: 'left',
        },
        {
          href: 'https://github.com/mixcore/mix.core',
          position: 'right',
          className: 'navbar__item navbar__link header-github-link',
          'aria-label': 'GitHub repository',
        },
      ],
    },
    footer: {
      style: 'dark',
      links: [
        {
          title: 'Documentation',
          items: [
            {
              label: 'Getting Started',
              to: '/intro',
            },
            {
              label: 'Installation',
              to: '/installation-install-mixcore',
            },
            {
              label: 'Developer Guide',
              to: '/dev-getting-started',
            },
          ],
        },
        {
          title: 'Community',
          items: [
            {
              label: 'GitHub Discussions',
              href: 'https://github.com/orgs/mixcore/discussions',
            },
            {
              label: 'Stack Overflow',
              href: 'https://stackoverflow.com/questions/tagged/mixcore',
            },
            {
              label: 'Twitter',
              href: 'https://twitter.com/mixcore_cms',
            },
          ],
        },
        {
          title: 'More',
          items: [
            {
              label: 'GitHub',
              href: 'https://github.com/mixcore/mix.core',
            },
            {
              label: 'Demo',
              href: 'https://demo.mixcore.org',
            },
            {
              label: 'Contributing',
              href: 'https://github.com/mixcore/mix.core/blob/master/CONTRIBUTING.md',
            },
          ],
        },
      ],
      copyright: `Copyright © ${new Date().getFullYear()} Mixcore. Built with Docusaurus.`,
    },

    announcementBar: {
      id: `supportus`,
      content: `⭐️ If you like Mixcore, give it a star on <a target="_blank" rel="noopener noreferrer" href="https://github.com/mixcore/mix.core">GitHub</a> and follow us on <a target="_blank" rel="noopener noreferrer" href="https://twitter.com/mixcore_cms">Twitter</a>`,
      backgroundColor: '#3b82f6',
      textColor: '#ffffff',
      isCloseable: true,
    },
    prism: {
      theme: prismThemes.github,
      darkTheme: prismThemes.dracula,
      additionalLanguages: ['csharp', 'powershell', 'bash', 'docker', 'yaml'],
    },
    colorMode: {
      defaultMode: 'light',
      disableSwitch: false,
      respectPrefersColorScheme: true,
    },
    docs: {
      sidebar: {
        hideable: true,
        autoCollapseCategories: true,
      },
    },
    algolia: {
      appId: 'YOUR_APP_ID',
      apiKey: 'YOUR_SEARCH_API_KEY',
      indexName: 'mixcore-docs',
      contextualSearch: true,
    },
  } satisfies Preset.ThemeConfig,
};

export default config;