docusaurus.config.js

// @ts-check
// Note: type annotations allow type checking and IDEs autocompletion
const path = require("path")

const lightCodeTheme = require("prism-react-renderer/themes/github")
const darkCodeTheme = require("prism-react-renderer/themes/dracula")
const cfg = require("config")

const captionsPlugin = require("./src/plugins/captions")

const algoliaConfig = cfg.has("algolia") ? cfg.get("algolia") : undefined

const posthogConfig = cfg.has("posthog") ? cfg.get("posthog") : undefined
const enablePosthog = posthogConfig && posthogConfig.apiKey

const googleAnalyticsConfig = cfg.has("googleAnalytics")
  ? cfg.get("googleAnalytics")
  : undefined
const enableGoogleAnalytics =
  googleAnalyticsConfig && googleAnalyticsConfig.trackingID

const siteUrl = cfg.has("siteUrl")
  ? cfg.get("siteUrl")
  : process.env["NETLIFY"]
  ? process.env["DEPLOY_URL"]
  : "http://localhost:3000"

const buildVersion = cfg.has("app.buildVersion")
  ? cfg.get("app.buildVersion")
  : "N/A"

const plugins = ["plugin-image-zoom"]

if (enablePosthog) {
  plugins.push("posthog-docusaurus")
}

/** @type {import('@docusaurus/types').Config} */
const config = {
  title: "Gruntwork Docs",
  tagline: "Learn how to deploy and manage your entire infrastructure as code.",
  url: siteUrl,
  baseUrl: "/",
  favicon: "/favicon.ico",
  organizationName: "gruntwork-io", // Usually your GitHub org/user name.
  projectName: "docs", // Usually your repo name.,

  stylesheets: [
    "https://fonts.googleapis.com/css2?family=Source+Sans+Pro:ital,wght@0,300;0,400;0,600;0,700;1,300;1,400;1,600;1,700&display=swap",
  ],
  customFields: {
    libraryIndexName: algoliaConfig
      ? algoliaConfig.libraryIndexName
      : undefined,
  },
  presets: [
    [
      "@docusaurus/preset-classic",
      /** @type {import('@docusaurus/preset-classic').Options} */
      {
        docs: {
          routeBasePath: "/",
          sidebarPath: require.resolve("./sidebars.js"),
          editUrl: "https://github.com/gruntwork-io/docs/edit/master/",
          exclude: [
            "guides/build-it-yourself/landing-zone/**",
            "guides/build-it-yourself/kubernetes-cluster/**",
            "guides/build-it-yourself/vpc/**",
          ],
          beforeDefaultRemarkPlugins: [captionsPlugin],
        },
        blog: false,
        theme: {
          customCss: require.resolve("./src/css/custom.css"),
        },
        googleTagManager: enableGoogleAnalytics
          ? {
              containerId: googleAnalyticsConfig.trackingID,
            }
          : undefined,
      },
    ],
  ],

  plugins: plugins,

  themeConfig:
    /** @type {import('@docusaurus/preset-classic').ThemeConfig} */
    ({
      navbar: {
        title: "",
        logo: {
          alt: "Gruntwork Logo",
          src: "img/logo-dark.png",
          srcDark: "img/logo-light.png",
        },
        hideOnScroll: true,
        items: [
          {
            type: "doc",
            position: "left",
            label: "Intro",
            docId: "intro/overview/intro-to-gruntwork",
          },
          {
            type: "dropdown",
            position: "left",
            label: "Docs",
            id: "docs",
            items: [
              {
                type: "doc",
                label: "DevOps Foundations",
                docId: "foundations/overview/index",
              },
              {
                type: "doc",
                label: "Library",
                docId: "library/overview/index",
              },
              {
                type: "doc",
                label: "Pipelines",
                docId: "pipelines/overview/index",
              },
              {
                type: "doc",
                label: "Patcher",
                docId: "patcher/index",
              },
              {
                type: "doc",
                label: "Reference Architecture",
                docId: "refarch/whats-this/what-is-a-reference-architecture",
              },
              {
                type: "doc",
                label: "Developer Portal",
                docId: "developer-portal/create-account",
              },
            ],
          },
          {
            type: "doc",
            label: "Library Reference",
            docId: "library/reference/index",
          },
          { to: "/tools", label: "Tools", position: "left" },
          { to: "/courses", label: "Courses", position: "left" },
          {
            href: "https://github.com/gruntwork-io/knowledge-base/discussions",
            label: "Knowledge Base",
            position: "right",
          },
          {
            href: "/support",
            label: "Support",
            position: "right",
          },
          {
            href: "https://app.gruntwork.io",
            label: "Sign In",
            position: "right",
          },
          {
            type: "dropdown",
            label: "More…",
            position: "right",
            id: "more_dropdown",
            items: [
              {
                href: "https://github.com/gruntwork-io/knowledge-base/discussions",
                label: "Knowledge Base",
              },
              {
                href: "/support",
                label: "Support",
              },
              {
                href: "https://app.gruntwork.io",
                label: "Sign In",
              },
            ],
          },
        ],
      },
      footer: {
        style: "dark",
        links: [
          {
            title: "Company",
            items: [
              {
                label: "Gruntwork.io",
                href: "https://gruntwork.io",
              },
              {
                label: "Blog",
                href: "https://blog.gruntwork.io/",
              },
              {
                label: "Newsletter",
                href: "https://gruntwork.io/newsletter/",
              },
              {
                label: "Store",
                href: "https://store.gruntwork.io/",
              },
            ],
          },
          {
            title: "Community",
            items: [
              {
                label: "Knowledge Base",
                href: "https://github.com/gruntwork-io/knowledge-base/discussions",
              },
              {
                label: "Community Slack",
                href: "https://gruntwork-community.slack.com/archives/CHH9Y3Z62",
              },
              {
                label: "GitHub",
                href: "https://github.com/gruntwork-io",
              },
              {
                label: "Twitter",
                href: "https://twitter.com/gruntwork_io",
              },
            ],
          },
          {
            title: "Resources",
            items: [
              {
                label: "Production Framework",
                href: "/guides/production-framework",
              },
              {
                label: "Developer Portal",
                href: "https://app.gruntwork.io",
              },
              {
                label: "IaC Library on GitHub",
                href: "https://github.com/gruntwork-io",
              },
              {
                label: "DevOps Checklist",
                href: "https://gruntwork.io/devops-checklist/",
              },
              {
                label: "Terragrunt",
                href: "https://terragrunt.gruntwork.io",
              },
              {
                label: "Terratest",
                href: "https://terratest.gruntwork.io",
              },
              {
                label: "Gruntwork Releases",
                to: "/guides/stay-up-to-date",
              },
              {
                label: "Style Guides",
                to: "/guides/style",
              },
              {
                label: "Support",
                href: "/support",
              },
            ],
          },
          {
            title: "Legal",
            items: [
              {
                label: "Privacy Policy",
                href: "https://gruntwork.io/legal/privacy-policy/",
              },
              {
                label: "Cookie Policy",
                href: "https://gruntwork.io/legal/cookie-policy/",
              },
              {
                label: "Website Terms",
                href: "https://gruntwork.io/website-terms/",
              },
            ],
          },
        ],
        copyright: `© 2020 – ${new Date().getFullYear()} Gruntwork, Inc.`,
      },
      colorMode: {
        defaultMode: "light",
        disableSwitch: false,
        respectPrefersColorScheme: false,
      },
      prism: {
        theme: lightCodeTheme,
        darkTheme: darkCodeTheme,
        additionalLanguages: [
          "hcl",
          "python",
          "yaml",
          "json",
          "bash",
          "go",
          "docker",
        ],
      },
      algolia: algoliaConfig
        ? {
            appId: algoliaConfig.appId,
            // Public API key: safe to commit, but still sourced from config
            apiKey: algoliaConfig.apiKey,
            indexName: algoliaConfig.indexName,
            libraryIndexName: algoliaConfig.libraryIndexName,
            contextualSearch: true,
          }
        : undefined,
      zoomSelector: ".markdown :not(em) > img:not(.no-zoom)",
      posthog: enablePosthog
        ? {
            apiKey: posthogConfig.apiKey,
            appUrl: posthogConfig.appUrl,
          }
        : undefined,
      metadata: [
        { name: "buildVersion", content: buildVersion },
        { name: "buildTime", content: new Date().toString() },
      ],
    }),
}

module.exports = config