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: 'Low-Tech Process-Based Restoration of Riverscapes', // Site title displayed in the browser tab
  tagline: 'Design Manual, Resources, Workshops.', // Short description shown in meta tags
  favicon: 'https://cdn.riverscapes.net/icons/products/pbr/pbr.svg', // Path to site favicon

  future: {
    v4: true, // Enables compatibility with upcoming Docusaurus v4 features
  },

  url: 'https://lowtechpbr.restoration.usu.edu', // The base URL of your site (no trailing slash)
  baseUrl: '/', // The sub-path where your site is served (used in GitHub Pages)

  onBrokenLinks: 'throw', // Throw an error on broken links
  onBrokenMarkdownLinks: 'warn', // Warn instead of throwing for broken markdown links

  i18n: {
    defaultLocale: 'en', // Default language
    locales: ['en'], // Supported languages
  },

  themes: ['@riverscapes/docusaurus-theme'], // Shared custom theme used across sites

  presets: [
    [
      'classic', // Docusaurus classic preset for docs/blog
      {
        docs: {
          sidebarPath: './sidebars.ts', // Path to sidebar config
          routeBasePath: '/', // Serve docs at site root
          editUrl: 'https://github.com/Riverscapes/PBR/tree/master',
        },
      } satisfies Preset.Options,
    ],
  ],

  themeConfig: {
    image: 'https://cdn.riverscapes.net/icons/products/pbr/pbr.svg', // Social sharing image

    algolia: {
      // The application ID provided by Algolia
      appId: '4TGS8ZPIMY',

      // Public API key: it is safe to commit it
      apiKey: 'd084a7919fe7b5940d7125f14221eaca',

      indexName: 'lowtechpbr.restoration.usu.edu',

      // Optional: see doc section below
      contextualSearch: true,
    },

    navbar: {
      title: 'Low-Tech Process-Based Restoration of Riverscapes', // Navbar title
      logo: {
        alt: 'Riverscapes Studio Logo', // Logo alt text
        src: 'https://cdn.riverscapes.net/icons/products/pbr/pbr.svg', // Logo image path
      },
      items: [
        // {
        //   type: 'docSidebar',
        //   sidebarId: 'tutorialSidebar', // ID of the sidebar defined in sidebars.ts
        //   position: 'left',
        //   label: 'MENU1', // Label in the navbar
        // },
        {
          href: 'https://github.com/Riverscapes/PBR', // External GitHub link
          label: 'GitHub',
          position: 'right',
        },
      ],
    },
    footer: {
      links: [
        {
          // Note that this NEEDS to match what's in the default template or we get another column
          title: 'User Resources',
          items: [
            {
              label: 'Join this User Community',
              href: 'https://www.riverscapes.net/topics/44339/feed',
            },
            {
              label: 'Search the Data Exchange',
              href: 'https://data.riverscapes.net/s?type=Project&projectTypeId=ltpbrprojects&view=map',
            },
            {
              label: 'Developers & Code Repository',
              href: 'https://github.com/Riverscapes/PBR',
            },
            {
              label: 'Knowledge Base',
              href: 'https://riverscapes.freshdesk.com/a/solutions/categories/153000027560/folders/153000161803?view=all',
            },
          ],
        },
      ],
    },

    prism: {
      theme: prismThemes.github, // Code block theme for light mode
      darkTheme: prismThemes.dracula, // Code block theme for dark mode
    },
  } satisfies Preset.ThemeConfig,
}

export default config