Versions path fix

Author: slowcheetah

website/build.mjs

@@ -89,12 +89,16 @@ async function buildDocsMenuForVersion(version) {
   return menu;
 }
 
+function getVersionPath(version) {
+  return version.path ?? version.branch ?? version.tag;
+}
+
 async function buildVersionsMenuList(versions, currentVersion, section) {
   let versionsMenuHtml = '<div class="dropdown-block">';
   for (const v of versions) {
     const activityClass = v.label === currentVersion && !v.default ? ' class="active"' : '';
     const defaultBadge = v.default ? ' (default)' : '';
-    const versionPath = v.default ? '' : `${ v.path ?? v.label }/`;
+    const versionPath = v.default ? '' : `${ getVersionPath(v) }/`;
     versionsMenuHtml += `<a href="./${ versionPath }${ section }"${ activityClass }>${ v.label }${ defaultBadge }</a>`;
   }
   versionsMenuHtml += '</div>';
@@ -227,7 +231,7 @@ async function buildPlaygrounds(template, versions) {
 }
 
 async function buildPlayground(template, version, versions) {
-  const versionPath = version.branch ?? version.tag;
+  const versionPath = getVersionPath(version);
   const bundleScript = `<script nomodule src="${ config.bundlesPath }/${ versionPath }/${ config.bundleName }"></script>`;
   const bundleESModulesScript = `<script type="module" src="${ config.bundlesPath }/${ versionPath }/${ config.bundleNameESModules }"></script>`;
   const babelScript = '<script src="./babel.min.js"></script>';
@@ -256,11 +260,11 @@ async function buildPlayground(template, version, versions) {
 }
 
 async function createDocsIndexes(versions) {
-  if (BRANCH) versions = [{ label: '' }];
+  if (BRANCH) versions = [{ path: '' }];
 
   for (const version of versions) {
     if (version.default) continue;
-    const versionPath = version.path ?? version.label;
+    const versionPath = getVersionPath(version);
     const menuItems = await getDocsMenuItems(versionPath);
     const firstDocPath = path.join(config.resultDir,
       `${ menuItems[0].url }.html`.replace(`{docs-version}${ BRANCH ? '/' : '' }`, versionPath));

website/config/versions.json

@@ -2,15 +2,17 @@
   {
     "label": "v3",
     "default": true,
-    "branch": "master"
+    "branch": "master",
+    "path": "v3"
   },
   {
     "label": "v3",
-    "branch": "master"
+    "branch": "master",
+    "path": "v3"
   },
   {
     "label": "v4 (alpha)",
-    "path": "v4",
-    "branch": "v4"
+    "branch": "v4",
+    "path": "v4"
   }
 ]