website: updates

Author: ilg-ul

website/docs/getting-started/index.mdx

@@ -111,6 +111,10 @@ eliminating the need to add multiple folders to the `PATH`.
 In summary, xpm packages can enhance and automate the installation
 process for source libraries and tools.
 
+In summary, xpm packages can streamline and automate the installation
+process for source libraries and tools. Further details are available on the
+[xpm Concepts](https://xpack.github.io/xpm/docs/guide/concepts/) page.
+
 </details>
 
 ## Features

website/docusaurus.config.ts

@@ -232,6 +232,10 @@ const config: Config = {
       }
     }
   ],
+
+  // No longer needed.
+  // themes: [ '@docusaurus/theme-search-algolia' ],
+
   // https://docusaurus.io/docs/seo
   themeConfig: {
     // The project's social card, og:image, twitter:image, 1200x630
@@ -383,6 +387,25 @@ const config: Config = {
       theme: prismThemes.github,
       darkTheme: prismThemes.dracula,
     },
+    algolia: {
+      // https://docsearch.algolia.com/docs/docsearch-v3/
+      appId: "KIDD7R4CL1",
+      apiKey: "ca2ffc431941284609f2d50202fc5506",
+      indexName: "xpackio",
+
+      // It ensures that search results are relevant to the current
+      // language and version. Enabled by default.
+      contextualSearch: false, // true,
+      // Optional: Replace parts of the item URLs from Algolia.
+      // Useful when using the same search index for multiple deployments
+      // using a different baseUrl. You can use regexp or string in the
+      // `from` param. For example: localhost:3000 vs myCompany.com/docs
+      // replaceSearchResultPathname: undefined,
+      // Optional: Algolia search parameters
+      searchParameters: {},
+      // Optional: path for search page that enabled by default (`false` to disable it)
+      searchPagePath: false, // 'search',
+    },
   } satisfies Preset.ThemeConfig,
 
   customFields: customFields,

website/package-lock.json

@@ -25,7 +25,9 @@
     "@docusaurus/plugin-client-redirects": "3.6.3",
     "@docusaurus/plugin-ideal-image": "3.6.3",
     "@docusaurus/preset-classic": "3.6.3",
+    "@docusaurus/theme-search-algolia": "3.6.3",
     "@mdx-js/react": "^3.1.0",
+    "clean-css": "~5.3.3",
     "clsx": "^2.1.1",
     "del-cli": "^6.0.0",
     "prism-react-renderer": "^2.4.0",

website/package.json

@@ -0,0 +1,16 @@
+
+export const userSidebarCategory = {
+    type: 'category',
+    label: 'User\'s Guide',
+    link: {
+        type: 'doc',
+        id: 'user/index',
+    },
+    items: [
+        {
+            type: 'doc',
+            id: 'user/index',
+            label: 'TODO'
+        }
+    ]
+}

website/sidebar-user.js

@@ -7,6 +7,8 @@ import type {SidebarsConfig} from '@docusaurus/plugin-content-docs';
 import toolsSidebar from './sidebars-tools.js';
 
 
+
+
 /**
  * Creating a sidebar enables you to:
  - create an ordered group of docs