rework some version paths and sidebar

Author: heskew

package.json

@@ -8,7 +8,7 @@
 		"site:build": "bash site/scripts/build-local.sh",
 		"site:serve": "bash site/scripts/serve-local.sh",
 		"site:clear": "cd site && npm run clear",
-		"site:reset": "rm -rf site/docs/ site/static/img/v* site/version*",
+		"site:reset": "rm -rf site/docs/ site/static/img/v* site/version* docs-tmp/",
 		"sync:to-harperdb": "bash site/scripts/sync-and-convert.sh",
 		"sync:to-harperdb:sample": "bash site/scripts/sync-and-convert.sh -s",
 		"sync:to-harperdb:dry": "bash site/scripts/sync-and-convert.sh -d",

site/docusaurus.config.ts

@@ -27,11 +27,16 @@ if (process.env.NODE_ENV === 'production') {
 // Can also be set via command line: npm run build -- --base-url /documentation/
 const baseUrl = process.env.DOCUSAURUS_BASE_URL || '/';
 
+// Determine route base path for docs
+// Can be set to '/docs/' if we need docs under a subdirectory
+// Default is '/' to serve docs at the root
+const routeBasePath = process.env.DOCUSAURUS_ROUTE_BASE_PATH || '/';
+
 // URL can also be overridden if needed
 const url = process.env.DOCUSAURUS_URL || 'https://docs.harperdb.io';
 
 // Always log configuration at build time
-console.log('Docusaurus URL config:', { url, baseUrl });
+console.log('Docusaurus URL config:', { url, baseUrl, routeBasePath });
 
 const config: Config = {
 	title: 'Harper Docs',
@@ -45,7 +50,7 @@ const config: Config = {
 	},
 
 	// Set the production url of your site here
-	url: url,
+	url,
 	// Set the /<baseUrl>/ pathname under which your site is served
 	baseUrl,
 
@@ -66,10 +71,10 @@ const config: Config = {
 			{
 				docs: {
 					// Use converted docs from DOCS_PATH or default location
-					path: process.env.DOCS_PATH || 'docs',
+					path: process.env.DOCS_PATH || '../docs',
 					sidebarPath: './sidebars.ts',
-					// Docs are always at the root of the baseUrl
-					routeBasePath: '/',
+					// Docs are served at the configured route base path
+					routeBasePath,
 					editUrl: ({ docPath }) => {
 						// Find where docs/ starts in the path and use everything from there
 						const docsIndex = docPath.indexOf('docs/');
@@ -172,10 +177,10 @@ const config: Config = {
 							label: 'Getting Started',
 							to: '/getting-started',
 						},
-						{
-							label: 'Developers',
-							to: '/category/developers',
-						},
+						// {
+						// 	label: 'Developers',
+						// 	to: '/developers',
+						// },
 						{
 							label: 'Administration',
 							to: '/administration',

site/package.json

@@ -6,7 +6,7 @@
     "docusaurus": "docusaurus",
     "start": "docusaurus start",
     "sync-latest": "node scripts/sync-latest-version.js",
-    "build": "npm run sync-latest && docusaurus build",
+    "build": "docusaurus build",
     "version": "node scripts/cut-version.js",
     "swizzle": "docusaurus swizzle",
     "deploy": "docusaurus deploy",

site/scripts/convert-and-run.sh

@@ -32,15 +32,25 @@ if [ ! -d "$SITE_DIR/versioned_docs" ] || [ ! -f "$SITE_DIR/versions.json" ]; th
     fi
 fi
 
+# Set DOCS_PATH to use the converted docs
+export DOCS_PATH="$REPO_ROOT/docs-tmp"
+export IMAGES_PATH="$REPO_ROOT/images"
+
+# Optional: Set route base path for docs
+# Uncomment and set to '/docs/' if you want docs under a subdirectory
+# export DOCUSAURUS_ROUTE_BASE_PATH="/docs/"
+
 # Run the appropriate Docusaurus command
 cd "$SITE_DIR"
 case "$COMMAND" in
     start)
         echo "Starting Docusaurus development server..."
+        echo "Using docs from: $DOCS_PATH"
         npm run "$COMMAND"
         ;;
     build)
         echo "Building Docusaurus site..."
+        echo "Using docs from: $DOCS_PATH"
         npm run "$COMMAND"
         ;;
     *)