huge documentaton restructure for docusaurus

2025-11-20 10:44:29 +01:00
parent 0127114e59
commit 6afa44d947
87 changed files with 18867 additions and 4102 deletions
--- a/docs/site/docusaurus.config.js
+++ b/docs/site/docusaurus.config.js
@@ -0,0 +1,97 @@
+// @ts-check
+
+const path = require('path');
+const { themes } = require('prism-react-renderer');
+const lightCodeTheme = themes.github;
+const darkCodeTheme = themes.dracula;
+
+/** @type {import('@docusaurus/types').Config} */
+const config = {
+  title: 'Fotospiel Ops & Product Docs',
+  tagline: 'Single source of truth for the platform',
+  url: 'https://docs.fotospiel.local',
+  baseUrl: '/',
+  favicon: 'img/favicon.ico',
+  organizationName: 'fotospiel',
+  projectName: 'fotospiel-docs-site',
+  onBrokenLinks: 'warn',
+  trailingSlash: false,
+  i18n: {
+    defaultLocale: 'en',
+    locales: ['en'],
+  },
+  markdown: {
+    hooks: {
+      onBrokenMarkdownLinks: 'warn',
+    },
+  },
+  presets: [
+    [
+      'classic',
+      /** @type {import('@docusaurus/preset-classic').Options} */
+      ({
+        docs: {
+          path: path.resolve(__dirname, '..'),
+          routeBasePath: '/',
+          sidebarPath: require.resolve('./sidebars.js'),
+          include: ['**/*.md', '**/*.mdx'],
+          exclude: ['site/**', 'archive/**', '**/_drafts/**'],
+          editUrl: undefined,
+          showLastUpdateAuthor: true,
+          showLastUpdateTime: true,
+        },
+        blog: false,
+        pages: false,
+        theme: {
+          customCss: require.resolve('./src/css/custom.css'),
+        },
+      }),
+    ],
+  ],
+  themes: [],
+  themeConfig:
+    /** @type {import('@docusaurus/preset-classic').ThemeConfig} */
+    ({
+      navbar: {
+        title: 'Fotospiel Docs',
+        items: [
+          {
+            type: 'docSidebar',
+            sidebarId: 'docsSidebar',
+            position: 'left',
+            label: 'Documentation',
+          },
+          {
+            href: 'https://github.com/fotospiel',
+            label: 'Git',
+            position: 'right',
+          },
+        ],
+      },
+      footer: {
+        style: 'dark',
+        links: [
+          {
+            title: 'Docs',
+            items: [
+              {
+                label: 'Architecture PRP',
+                to: '/',
+              },
+              {
+                label: 'Ops Playbooks',
+                to: '/ops',
+              },
+            ],
+          },
+        ],
+        copyright: `Copyright © ${new Date().getFullYear()} Fotospiel. Internal use only.`,
+      },
+      prism: {
+        theme: lightCodeTheme,
+        darkTheme: darkCodeTheme,
+      },
+    }),
+};
+
+module.exports = config;