Merge pull request #1092 from oracle/docusuarus-bootstrap

Bootstrap docusaurus website

Author: anders-swanson

docs-source/site/.gitignore

@@ -0,0 +1,22 @@
+# Dependencies
+/node_modules
+
+!package.json
+!package-lock.json
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

docs-source/site/README.md

@@ -0,0 +1,48 @@
+# Website
+
+This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
+
+The `content` directory contains the built, static site.
+
+Requirements:
+- latest version of NodeJS
+
+## Installation
+
+```bash
+npm i
+```
+
+## Local Development
+
+```bash
+npm start
+```
+
+This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+
+## Versioning 
+
+```bash
+npm run docusaurus docs:version 1.1.0
+```
+
+Then, add the version to the `docusaurus.config.ts` versions navbar.
+
+This command generates static content into the `build` directory and can be served using any static contents hosting service.
+
+## Deployment
+
+Using SSH:
+
+```bash
+USE_SSH=true yarn deploy
+```
+
+Not using SSH:
+
+```bash
+GIT_USER=<Your GitHub username> yarn deploy
+```
+
+If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.

docs-source/site/docs/intro.md

@@ -0,0 +1,9 @@
+---
+sidebar_position: 1
+---
+
+# Oracle Backend for Microservices and AI
+
+Oracle Backend for Microservices and AI allows developers to build microservices in Helidon and/or Spring Boot and provisions a “backend as a service” with Oracle Database and other infrastructure components that operate on multiple clouds. Oracle Backend for Microservices and AI vastly simplifies the task of building, testing, and operating microservices platforms for reliable, secure, and scalable enterprise applications.
+
+**Content TBD**

docs-source/site/docs/setup/_category_.json

@@ -0,0 +1,8 @@
+{
+  "label": "Setup",
+  "position": 1,
+  "link": {
+    "type": "generated-index",
+    "description": "OBaaS setup and installation."
+  }
+}

docs-source/site/docs/setup/go-runtime.md

@@ -0,0 +1,6 @@
+---
+title: Installing OBaaS
+sidebar_position: 1
+---
+
+**Content TBD**

docs-source/site/docusaurus.config.ts

@@ -0,0 +1,132 @@
+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: 'Oracle Backend for Microservices and AI',
+  tagline: 'Deploy AI microservices using a “backend as a service” with Oracle Database and other infrastructure components',
+  favicon: 'img/favicon-32x32.png',
+
+  // Future flags, see https://docusaurus.io/docs/api/docusaurus-config#future
+  future: {
+    v4: true, // Improve compatibility with the upcoming Docusaurus v4
+  },
+
+  // TODO: Set the production url of your site here
+  url: 'https://oracle.github.io',
+  // Set the /<baseUrl>/ pathname under which your site is served
+  // For GitHub pages deployment, it is often '/<projectName>/'
+  baseUrl: '/microservices-datadriven/',
+
+  // GitHub pages deployment config.
+  // If you aren't using GitHub pages, you don't need these.
+  organizationName: 'oracle', // Usually your GitHub org/user name.
+  projectName: 'microservices-datadriven', // Usually your repo name.
+
+  onBrokenLinks: 'throw',
+  onBrokenMarkdownLinks: 'warn',
+
+  // Even if you don't use internationalization, you can use this field to set
+  // useful metadata like html lang. For example, if your site is Chinese, you
+  // may want to replace "en" with "zh-Hans".
+  i18n: {
+    defaultLocale: 'en',
+    locales: ['en'],
+  },
+
+  presets: [
+    [
+      'classic',
+      {
+        docs: {
+          sidebarPath: './sidebars.ts',
+          // Please change this to your repo.
+          // Remove this to remove the "edit this page" links.
+          editUrl:
+            'https://github.com/oracle/microservices-datadriven/tree/main/docs-source/site/',
+        },
+        theme: {
+          customCss: './src/css/custom.css',
+        },
+      } satisfies Preset.Options,
+    ],
+  ],
+
+  themeConfig: {
+    // Replace with your project's social card
+    image: 'img/logo.png',
+    navbar: {
+      title: 'Oracle Backend for Microservices and AI',
+      logo: {
+        alt: 'Oracle Backend for Microservices and AI Logo',
+        src: 'img/logo_home.png',
+      },
+      items: [
+        {
+          type: 'docSidebar',
+          sidebarId: 'tutorialSidebar',
+          position: 'left',
+          label: 'Docs',
+        },
+        {
+          type: 'docsVersionDropdown',
+          versions: ['current' ]
+        },
+        {
+          href: 'https://github.com/oracle/microservices-datadriven',
+          label: 'GitHub',
+          position: 'right',
+        },
+      ],
+    },
+    footer: {
+      style: 'dark',
+      links: [
+        {
+          title: 'Docs',
+          items: [
+            {
+              label: 'Tutorial',
+              to: '/docs/intro',
+            },
+          ],
+        },
+        {
+          title: 'Community',
+          items: [
+            {
+              label: 'Stack Overflow',
+              href: 'https://stackoverflow.com/questions/tagged/oracle',
+            },
+          ],
+        },
+        {
+          title: 'More',
+          items: [
+            {
+              label: 'Oracle Blogs',
+              to: 'https://blogs.oracle.com/',
+            },
+            {
+              label: 'Oracle LiveLabs',
+              to: 'https://livelabs.oracle.com/pls/apex/r/dbpm/livelabs/home'
+            },
+            {
+              label: 'GitHub',
+              href: 'https://github.com/oracle/microservices-datadriven',
+            },
+          ],
+        },
+      ],
+      copyright: `Copyright © ${new Date().getFullYear()}, Oracle and/or its affiliates. Built with ❤️ using Docusaurus.`,
+    },
+    prism: {
+      theme: prismThemes.github,
+      darkTheme: prismThemes.dracula,
+    },
+  } satisfies Preset.ThemeConfig,
+};
+
+export default config;