Add api page (#32)

# Changes

- Added [redocusaurus](https://github.com/rohit-gohri/redocusaurus) package to display swagger api with reference to [woodpecker](https://github.com/woodpecker-ci/woodpecker/tree/master/docs)
- Change `sed` for swagger.json for proper version and baseurl.
- Add a dropdown for different api versions. (screenshot below)
- On API pages, only API version dropdown will show(hide locale dropdown, version dropdown for doc, and doc search)
- Allow build CSR API pages for development so it saves building time.

# Screenshots

![Screen Shot 2023-06-27 at 11.56.59](/attachments/7f43976d-f9f1-42ff-85f5-0bc84e549441)

![Screen Shot 2023-06-27 at 10.58.11](/attachments/bde25da5-b0a6-4908-9c69-c6aed41f8f59)

![Screen Shot 2023-06-21 at 12.26.26](/attachments/84a9bf5a-229b-4031-9654-3bae6cb3301a)

![Screen Shot 2023-06-19 at 16.34.33](/attachments/653b2b59-bc8a-4e6c-82f2-eb9710f55d8d)

Search:

![Screen Shot 2023-06-21 at 14.49.15](/attachments/3a09bd89-36a8-4156-a2df-2d3176d3ddb1)

Reviewed-on: https://gitea.com/gitea/gitea-docusaurus/pulls/32
Co-authored-by: HesterG <hestergong@gmail.com>
Co-committed-by: HesterG <hestergong@gmail.com>

src/components/ClientOnly.js

@@ -0,0 +1,12 @@
+import React from 'react';
+import ApiDoc from '@theme/ApiDoc';
+// For csr api pages
+export default function ClientOnly(props) {
+  return (
+    <ApiDoc
+      specProps={{
+        url: props.swaggerPath,
+      }}
+    />
+  );
+}

src/components/Outdated.js

@@ -1,4 +1,4 @@
-import React from 'react'
+import React from 'react';
 import Translate from '@docusaurus/Translate';
 
 export default function Outdated(props) {

src/css/custom.css

@@ -58,3 +58,57 @@
   background-color: rgb(7, 19, 24);
   color: rgb(184, 231, 251);
 }
+
+.redocusaurus .menu-content {
+  top: 70px !important;
+  height: calc(100vh - 70px) !important;
+}
+/* The following css is for toggling API version dropdown/menu,
+selectors like :first-of-type are for browsers those do not support :has */
+/* Do not show doc search on api pages */
+body:has(.redocusaurus) [class*='searchBox'],
+.plugin-redoc [class*='searchBox'],
+.plugin-pages [class*='searchBox'] {
+  display: none;
+}
+
+@media (min-width: 996px) {
+  /* hide api-dropdown on other pages */
+  .navbar__item.dropdown:not(:has(.api-dropdown)),
+  .navbar__item.dropdown:first-of-type {
+    display: none;
+  }
+  /* show api-dropdown dropdown and hide other dropdowns on api pages */
+  body:has(.redocusaurus) .navbar__item.dropdown:not(:has(.api-dropdown)),
+  .plugin-redoc .navbar__item.dropdown:not(:first-of-type),
+  .plugin-pages .navbar__item.dropdown:not(:first-of-type) {
+    display: none;
+  }
+  body:has(.redocusaurus) .navbar__item.dropdown:has(.api-dropdown),
+  .plugin-redoc .navbar__item.dropdown:first-of-type,
+  .plugin-pages .navbar__item.dropdown:first-of-type {
+    display: block;
+  }
+}
+
+@media (max-width: 996px) {
+  /* need to find a way to customize the classname */
+  /* on mobile, dropdown becomes menu list */
+  /* Hide api version menu on other pages */
+  .menu__list-item.menu__list-item--collapsed:has(.api-dropdown),
+  .menu__list-item.menu__list-item--collapsed:nth-of-type(3) {
+    display: none;
+  }
+  /* Hide collapsible menus except for API menu on API pages */
+  body:has(.redocusaurus) .menu__list-item.menu__list-item--collapsed:not(:has(.api-dropdown)),
+  .plugin-redoc .menu__list-item.menu__list-item--collapsed:not(:first-of-type),
+  .plugin-pages .menu__list-item.menu__list-item--collapsed:not(:first-of-type) {
+    display: none;
+  }
+  /* Show collapsible API menu on API pages */
+  body:has(.redocusaurus) .menu__list-item:has(.api-dropdown),
+  .plugin-redoc .menu__list-item:nth-of-type(3),
+  .plugin-pages .menu__list-item:nth-of-type(3) {
+    display: list-item !important;
+  }
+}

src/pages/api/1.19/index.js

@@ -0,0 +1,8 @@
+import React from 'react';
+import ClientOnly from '@site/src/components/ClientOnly';
+
+export default function Api19() {
+  return (
+    <ClientOnly swaggerPath="/swagger-19.json"/>
+  );
+}

src/pages/api/1.20/index.js

@@ -0,0 +1,8 @@
+import React from 'react';
+import ClientOnly from '@site/src/components/ClientOnly';
+
+export default function Api20() {
+  return (
+    <ClientOnly swaggerPath="/swagger-20.json"/>
+  );
+}

src/pages/api/next/index.js

@@ -0,0 +1,8 @@
+import React from 'react';
+import ClientOnly from '@site/src/components/ClientOnly';
+
+export default function ApiLatest() {
+  return (
+    <ClientOnly swaggerPath="/swagger-latest.json"/>
+  );
+}