From e0e05d0a2ec3a993fd088cb06339fa0d4c992c58 Mon Sep 17 00:00:00 2001
From: Alireza <ar.sedghi@gmail.com>
Date: Tue, 22 Jun 2021 22:30:33 -0400
Subject: [PATCH] feat: Add nav links

---
 platform/docs/docusaurus.config.js            |   9 +-
 .../src/theme/DocVersionSuggestions/index.js  | 131 ++++++++++++++++++
 2 files changed, 137 insertions(+), 3 deletions(-)
 create mode 100644 platform/docs/src/theme/DocVersionSuggestions/index.js

diff --git a/platform/docs/docusaurus.config.js b/platform/docs/docusaurus.config.js
index 19a4ea989..7ccd7d2f9 100644
--- a/platform/docs/docusaurus.config.js
+++ b/platform/docs/docusaurus.config.js
@@ -265,12 +265,15 @@ const isI18nStaging = process.env.I18N_STAGING === 'true';
       },
       items: [
         {
-          type: 'doc',
           position: 'left',
+          to: '/',
+          activeBaseRegex: '^(/next/|/)$',
           docId: 'Introduction',
-          label: 'Docs',
+          label: 'Docs & API',
         },
-        // {to: 'blog', label: 'Blog', position: 'left'},
+        { to: 'next/userManuals/index', label: 'User Manuals', position: 'left' },
+        { to: 'next/help', activeBaseRegex: '(^/help$)|(/next/help)', label: 'Help', position: 'right' },
+        { to: 'https://react.ohif.org/', label: 'UI Component Library', position: 'left' },
         // {to: 'showcase', label: 'Showcase', position: 'left'},
         // right
         {
diff --git a/platform/docs/src/theme/DocVersionSuggestions/index.js b/platform/docs/src/theme/DocVersionSuggestions/index.js
new file mode 100644
index 000000000..82cde75dd
--- /dev/null
+++ b/platform/docs/src/theme/DocVersionSuggestions/index.js
@@ -0,0 +1,131 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import React from 'react';
+import useDocusaurusContext from '@docusaurus/useDocusaurusContext';
+import Link from '@docusaurus/Link';
+import Translate from '@docusaurus/Translate';
+import {
+  useActivePlugin,
+  useActiveVersion,
+  useDocVersionSuggestions,
+} from '@theme/hooks/useDocs';
+import { useDocsPreferredVersion } from '@docusaurus/theme-common';
+
+function UnreleasedVersionLabel({ siteTitle, versionLabel }) {
+  return (
+    <Translate
+      id="theme.docs.versions.unreleasedVersionLabel"
+      description="The label used to tell the user that he's browsing an unreleased doc version"
+      values={{
+        siteTitle,
+        versionLabel: <strong>{versionLabel}</strong>,
+        latestVersionLink: (
+          <strong>
+            <Link to={"/"}>
+              <Translate
+                id="theme.docs.versions.latestVersionLinkLabel"
+                description="The label used for the latest version suggestion link label">
+                docs
+              </Translate>
+            </Link>
+          </strong>
+        ),
+      }}>
+      {
+        'This is unreleased documentation for {siteTitle} {versionLabel} version. For up-to-date documentation, see OHIF v2.0  {latestVersionLink}.'
+      }
+    </Translate>
+  );
+}
+
+function UnmaintainedVersionLabel({ siteTitle, versionLabel }) {
+  return (
+    <Translate
+      id="theme.docs.versions.unmaintainedVersionLabel"
+      description="The label used to tell the user that he's browsing an unmaintained doc version"
+      values={{
+        siteTitle,
+        versionLabel: <strong>{versionLabel}</strong>,
+      }}>
+      {
+        'This is documentation for {siteTitle} {versionLabel}, which is no longer actively maintained.'
+      }
+    </Translate>
+  );
+}
+
+function LatestVersionSuggestionLabel({ versionLabel, to, onClick }) {
+  return (
+    <Translate
+      id="theme.docs.versions.latestVersionSuggestionLabel"
+      description="The label userd to tell the user that he's browsing an unmaintained doc version"
+      values={{
+        versionLabel,
+        latestVersionLink: (
+          <strong>
+            <Link to={to} onClick={onClick}>
+              <Translate
+                id="theme.docs.versions.latestVersionLinkLabel"
+                description="The label used for the latest version suggestion link label">
+                latest version
+              </Translate>
+            </Link>
+          </strong>
+        ),
+      }}>
+      {
+        'For up-to-date documentation, see the {latestVersionLink} ({versionLabel}).'
+      }
+    </Translate>
+  );
+}
+
+const getVersionMainDoc = (version) =>
+  version.docs.find((doc) => doc.id === version.mainDocId);
+
+function DocVersionSuggestions() {
+  const {
+    siteConfig: { title: siteTitle },
+  } = useDocusaurusContext();
+  const { pluginId } = useActivePlugin({
+    failfast: true,
+  });
+  const { savePreferredVersionName } = useDocsPreferredVersion(pluginId);
+  const activeVersion = useActiveVersion(pluginId);
+  const {
+    latestDocSuggestion,
+    latestVersionSuggestion,
+  } = useDocVersionSuggestions(pluginId); // No suggestion to be made
+
+  if (!latestVersionSuggestion) {
+    return <></>;
+  } // try to link to same doc in latest version (not always possible)
+  // fallback to main doc of latest version
+
+  const latestVersionSuggestedDoc =
+    latestDocSuggestion ?? getVersionMainDoc(latestVersionSuggestion);
+  return (
+    <div className="alert alert--warning margin-bottom--md" role="alert">
+      <div>
+        {activeVersion.name === 'current' ? (
+          <UnreleasedVersionLabel
+            siteTitle={siteTitle}
+            versionLabel={activeVersion.label}
+          />
+        ) : (
+          <UnmaintainedVersionLabel
+            siteTitle={siteTitle}
+            versionLabel={activeVersion.label}
+          />
+        )}
+      </div>
+
+    </div>
+  );
+}
+
+export default DocVersionSuggestions;