Initial commit: Docusaurus docker stack and docs

2026-07-15 18:57:47 +00:00
commit d5b8c97ec3
61 changed files with 1857 additions and 0 deletions
--- a/site/docusaurus.config.js
+++ b/site/docusaurus.config.js
@@ -0,0 +1,115 @@
+// @ts-check
+import {themes as prismThemes} from 'prism-react-renderer';
+
+// This runs in Node.js - Don't use client-side code here (browser APIs, JSX...)
+
+// SITE_URL is read from the container's environment (see ../.env) so the
+// production domain can be set in one place without editing this file.
+const siteUrl = process.env.SITE_URL || 'http://localhost:3000';
+
+/** @type {import('@docusaurus/types').Config} */
+const config = {
+  title: 'Dotjuice Docs',
+  tagline: 'Documentation for the Dotjuice WordPress plugins',
+  favicon: 'img/favicon.ico',
+
+  future: {
+    v4: true, // Improve compatibility with the upcoming Docusaurus v4
+  },
+
+  url: siteUrl,
+  baseUrl: '/',
+
+  organizationName: 'dotjuice',
+  projectName: 'dotjuice-docs',
+
+  // 'warn' rather than 'throw': a broken cross-link (e.g. while a doc is
+  // being edited) logs a build warning instead of taking the whole site down.
+  onBrokenLinks: 'warn',
+  onBrokenMarkdownLinks: 'warn',
+
+  i18n: {
+    defaultLocale: 'en',
+    locales: ['en'],
+  },
+
+  presets: [
+    [
+      'classic',
+      /** @type {import('@docusaurus/preset-classic').Options} */
+      ({
+        docs: {
+          sidebarPath: './sidebars.js',
+          routeBasePath: 'docs',
+          editUrl: undefined,
+        },
+        blog: false,
+        theme: {
+          customCss: './src/css/custom.css',
+        },
+      }),
+    ],
+  ],
+
+  themeConfig:
+    /** @type {import('@docusaurus/preset-classic').ThemeConfig} */
+    ({
+      image: 'img/dotjuice-logo.png',
+      colorMode: {
+        respectPrefersColorScheme: true,
+      },
+      navbar: {
+        title: 'Dotjuice Docs',
+        logo: {
+          alt: 'Dotjuice',
+          src: 'img/dotjuice-logo.png',
+        },
+        items: [
+          {
+            type: 'docSidebar',
+            sidebarId: 'docsSidebar',
+            position: 'left',
+            label: 'Documentation',
+          },
+          {
+            href: 'https://dotjuice.co.uk',
+            label: 'dotjuice.co.uk',
+            position: 'right',
+          },
+          {
+            href: 'https://shop.dotjuice.co.uk',
+            label: 'Shop',
+            position: 'right',
+          },
+        ],
+      },
+      footer: {
+        style: 'dark',
+        links: [
+          {
+            title: 'Plugins',
+            items: [
+              {label: 'Elementor Tools (Free)', to: '/docs/dotjuice-elementor-tools/getting-started'},
+              {label: 'Elementor Tools Pro', to: '/docs/dotjuice-elementor-tools-pro/getting-started'},
+              {label: 'Pagespeed', to: '/docs/dotjuice-pagespeed/getting-started'},
+            ],
+          },
+          {
+            title: 'Dotjuice',
+            items: [
+              {label: 'Website', href: 'https://dotjuice.co.uk'},
+              {label: 'Shop', href: 'https://shop.dotjuice.co.uk'},
+              {label: 'Support', href: 'https://dotjuice.co.uk/support/'},
+            ],
+          },
+        ],
+        copyright: `Copyright © ${new Date().getFullYear()} Dotjuice Design.`,
+      },
+      prism: {
+        theme: prismThemes.github,
+        darkTheme: prismThemes.dracula,
+      },
+    }),
+};
+
+export default config;