feat: launch 3d architecture documentation portal

2026-08-31 10:24:07 +00:00
commit c84a10cc47
35 changed files with 12624 additions and 0 deletions
@@ -0,0 +1,62 @@
+import {themes as prismThemes} from 'prism-react-renderer';
+import type {Config} from '@docusaurus/types';
+import type * as Preset from '@docusaurus/preset-classic';
+
+const editUrl = 'https://gitea.lego-cloud.eu/corp-v1-3darch/corp-v1-3darch-documentation/src/branch/test/';
+const config: Config = {
+  title: '3D Architecture Wizzard',
+  tagline: 'Explore, design, and communicate software and system architecture in navigable 3D',
+  favicon: 'img/favicon.svg',
+  url: 'https://pages.apps.lego-cloud.eu',
+  baseUrl: '/corp-v1-3darch/corp-v1-3darch-documentation/',
+  organizationName: 'corp-v1-3darch',
+  projectName: 'corp-v1-3darch-documentation',
+  trailingSlash: true,
+  onBrokenLinks: 'throw',
+  onBrokenAnchors: 'throw',
+  markdown: {hooks: {onBrokenMarkdownLinks: 'throw'}},
+  i18n: {defaultLocale: 'en', locales: ['en']},
+  plugins: [
+    ['@docusaurus/plugin-content-docs', {id: 'scope', path: 'scope', routeBasePath: 'scope', sidebarPath: './sidebarsScope.ts', editUrl}],
+    ['@docusaurus/plugin-content-docs', {id: 'architecture', path: 'architecture', routeBasePath: 'architecture', sidebarPath: './sidebarsArchitecture.ts', editUrl}],
+    ['@docusaurus/plugin-content-docs', {id: 'kanban', path: 'kanban', routeBasePath: 'kanban', sidebarPath: './sidebarsKanban.ts', editUrl}],
+    ['@docusaurus/plugin-content-docs', {id: 'ways-of-working', path: 'ways-of-working', routeBasePath: 'ways-of-working', sidebarPath: './sidebarsWaysOfWorking.ts', editUrl}],
+    ['@docusaurus/plugin-content-docs', {id: 'engineering', path: 'engineering', routeBasePath: 'engineering', sidebarPath: './sidebarsEngineering.ts', editUrl}],
+    ['@docusaurus/plugin-content-docs', {id: 'glossary', path: 'glossary', routeBasePath: 'glossary', sidebarPath: './sidebarsGlossary.ts', editUrl}],
+  ],
+  themes: [[require.resolve('@easyops-cn/docusaurus-search-local'), {
+    hashed: 'filename', indexDocs: true, indexBlog: false, indexPages: true,
+    docsRouteBasePath: ['/tutorial', '/scope', '/architecture', '/kanban', '/ways-of-working', '/engineering', '/glossary'],
+    language: ['en'], highlightSearchTermsOnTargetPage: true, explicitSearchResultPath: true,
+    searchResultLimits: 12, searchResultContextMaxLength: 120,
+  }]],
+  presets: [['classic', {
+    docs: {path: 'docs/user-tutorial', routeBasePath: 'tutorial', sidebarPath: './sidebars.ts', editUrl},
+    blog: false,
+    theme: {customCss: './src/css/custom.css'},
+  } satisfies Preset.Options]],
+  themeConfig: {
+    colorMode: {defaultMode: 'light', disableSwitch: false, respectPrefersColorScheme: true},
+    navbar: {title: '3D Architecture Wizzard', logo: {alt: '3D Architecture Wizzard mark', src: 'img/logo.svg'}, items: [
+      {type: 'docSidebar', sidebarId: 'tutorialSidebar', label: 'User Tutorial', position: 'left'},
+      {type: 'docSidebar', docsPluginId: 'scope', sidebarId: 'scopeSidebar', label: 'Scope', position: 'left'},
+      {type: 'docSidebar', docsPluginId: 'architecture', sidebarId: 'architectureSidebar', label: 'Architecture', position: 'left'},
+      {type: 'docSidebar', docsPluginId: 'kanban', sidebarId: 'kanbanSidebar', label: 'Kanban', position: 'left'},
+      {type: 'docSidebar', docsPluginId: 'ways-of-working', sidebarId: 'waysOfWorkingSidebar', label: 'Ways Of Working', position: 'left'},
+      {type: 'docSidebar', docsPluginId: 'engineering', sidebarId: 'engineeringSidebar', label: 'Engineering', position: 'left'},
+      {type: 'docSidebar', docsPluginId: 'glossary', sidebarId: 'glossarySidebar', label: 'Glossary', position: 'left'},
+      {href: 'https://gitea.lego-cloud.eu/corp-v1-3darch/corp-v1-3darch', label: 'Application ↗', position: 'right'},
+    ]},
+    footer: {style: 'dark', links: [
+      {title: 'Explore', items: [{label: 'User Tutorial', to: '/tutorial/'}, {label: 'Architecture', to: '/architecture/'}, {label: 'Glossary', to: '/glossary/'}]},
+      {title: 'Project', items: [
+        {label: 'Application repository', href: 'https://gitea.lego-cloud.eu/corp-v1-3darch/corp-v1-3darch'},
+        {label: 'Board record', href: 'https://pages.apps.lego-cloud.eu/corp-v1/portal/projects/3darch/'},
+        {label: 'Project skill', href: 'https://gitea.lego-cloud.eu/corp-v1-3darch-skills-code-agent/documentation-docusaurus--3darch'},
+      ]},
+    ], copyright: `Copyright © ${new Date().getFullYear()} 3D Architecture Wizzard`},
+    prism: {theme: prismThemes.github, darkTheme: prismThemes.dracula},
+    docs: {sidebar: {hideable: true, autoCollapseCategories: true}},
+  } satisfies Preset.ThemeConfig,
+};
+export default config;