Fix versioned wiki directory page routing issues

Author: BlakeBr0

apps/web/composables/wiki.ts

@@ -9,7 +9,7 @@ export const useWikiMetadata = () => {
   watch(
     () => route.path,
     () => {
-      const params = parseWikiRouteParams(route.params);
+      const params = parseWikiRouteParams(route.path);
 
       version.value = params.version;
       mod.value = params.mod;

apps/web/modules/redirects.ts

@@ -1,42 +1,34 @@
-import { defineNuxtModule, extendRouteRules } from "nuxt/kit";
+import {
+  createResolver,
+  defineNuxtModule,
+  extendPages,
+  extendRouteRules
+} from "nuxt/kit";
+import { getWikiVersions } from "~/utils/wiki";
 
+// prettier-ignore
 const redirects = {
   "/mods": "/",
 
-  "/docs/mysticalagriculture/crafttweaker/infusion-recipes":
-    "/docs/mysticalagriculture/infusion-recipes",
-  "/docs/mysticalagriculture/crafttweaker/reprocessor-recipes":
-    "/docs/mysticalagriculture/reprocessor-recipes",
-  "/docs/extendedcrafting/crafttweaker/combination-recipes":
-    "/docs/extendedcrafting/combination-recipes",
-  "/docs/extendedcrafting/crafttweaker/table-recipes":
-    "/docs/extendedcrafting/table-recipes",
-  "/docs/extendedcrafting/crafttweaker/compression-recipes":
-    "/docs/extendedcrafting/compression-recipes",
-  "/docs/extendedcrafting/crafttweaker/ender-crafting-recipes":
-    "/docs/extendedcrafting/ender-crafting-recipes",
-  "/docs/extendedcrafting/adding-singularities":
-    "/docs/extendedcrafting/singularities",
-  "/docs/extendedcrafting/removing-singularities":
-    "/docs/extendedcrafting/singularities",
-  "/docs/extendedcrafting/singularities-in-recipes":
-    "/docs/extendedcrafting/singularities",
+  "/docs/mysticalagriculture/crafttweaker/infusion-recipes": "/docs/mysticalagriculture/infusion-recipes",
+  "/docs/mysticalagriculture/crafttweaker/reprocessor-recipes": "/docs/mysticalagriculture/reprocessor-recipes",
+  "/docs/extendedcrafting/crafttweaker/combination-recipes": "/docs/extendedcrafting/combination-recipes",
+  "/docs/extendedcrafting/crafttweaker/table-recipes": "/docs/extendedcrafting/table-recipes",
+  "/docs/extendedcrafting/crafttweaker/compression-recipes": "/docs/extendedcrafting/compression-recipes",
+  "/docs/extendedcrafting/crafttweaker/ender-crafting-recipes": "/docs/extendedcrafting/ender-crafting-recipes",
+  "/docs/extendedcrafting/adding-singularities": "/docs/extendedcrafting/singularities",
+  "/docs/extendedcrafting/removing-singularities": "/docs/extendedcrafting/singularities",
+  "/docs/extendedcrafting/singularities-in-recipes": "/docs/extendedcrafting/singularities",
 
   "/guides": "/wiki",
   "/guides/mysticalagriculture": "/wiki/mysticalagriculture",
-  "/guides/mysticalagriculture/gameplay/getting-started":
-    "/wiki/mysticalagriculture/guides/getting-started",
-  "/guides/mysticalagriculture/gameplay/creating-seeds":
-    "/wiki/mysticalagriculture/guides/creating-seeds",
-  "/guides/mysticalagriculture/gameplay/collecting-mob-souls":
-    "/wiki/mysticalagriculture/guides/collecting-mob-souls",
-  "/guides/mysticalagriculture/gameplay/speeding-up-crop-growth":
-    "/wiki/mysticalagriculture/guides/speeding-up-crop-growth",
-  "/guides/mysticalagriculture/gameplay/upgrading-essence-gear":
-    "/wiki/mysticalagriculture/guides/upgrading-essence-gear",
+  "/guides/mysticalagriculture/gameplay/getting-started": "/wiki/mysticalagriculture/guides/getting-started",
+  "/guides/mysticalagriculture/gameplay/creating-seeds": "/wiki/mysticalagriculture/guides/creating-seeds",
+  "/guides/mysticalagriculture/gameplay/collecting-mob-souls": "/wiki/mysticalagriculture/guides/collecting-mob-souls",
+  "/guides/mysticalagriculture/gameplay/speeding-up-crop-growth": "/wiki/mysticalagriculture/guides/speeding-up-crop-growth",
+  "/guides/mysticalagriculture/gameplay/upgrading-essence-gear": "/wiki/mysticalagriculture/guides/upgrading-essence-gear",
 
-  "/wiki/mysticalagriculture/items/watering-can":
-    "/wiki/mysticalagriculture/items/watering-cans"
+  "/wiki/mysticalagriculture/items/watering-can": "/wiki/mysticalagriculture/items/watering-cans"
 };
 
 export default defineNuxtModule({
@@ -52,5 +44,23 @@ export default defineNuxtModule({
         }
       });
     }
+
+    const resolver = createResolver(import.meta.url);
+
+    // the /wiki/[[version]] urls get resolved to /wiki/[[version]]/[mod] for some reason, so
+    // we'll add explicit routes for these pages as a workaround
+    extendPages(pages => {
+      const versions = getWikiVersions();
+      for (const version of versions) {
+        pages.push({
+          name: `wiki-directory-${version}`,
+          path: `/wiki/${version}`,
+          file: resolver.resolve("../pages/wiki/[[version]]/index.vue"),
+          meta: {
+            layout: "wiki"
+          }
+        });
+      }
+    });
   }
 });

apps/web/pages/wiki/[[version]]/[mod]/[category]/[slug].vue

@@ -95,7 +95,7 @@ definePageMeta({
 const route = useRoute();
 const toggleSidebar = useEventBus("wiki:toggleSidebar");
 
-const { version, mod: modID } = useWikiMetadata();
+const { version, mod: modID, isLatestVersion } = useWikiMetadata();
 const mod = getMod(modID.value);
 
 const page = await useWiki();
@@ -147,7 +147,7 @@ const breadcrumbs = computed(() =>
   [
     {
       label: "Wiki",
-      to: "/wiki"
+      to: isLatestVersion.value ? "/wiki" : `/wiki/${version.value}`
     },
     pathParts.length > 2 && {
       label: version.value

apps/web/pages/wiki/[[version]]/[mod]/index.vue

@@ -156,7 +156,7 @@ const recent = [...data.value]
 const breadcrumbs = computed(() => [
   {
     label: "Wiki",
-    to: "/wiki"
+    to: isLatestVersion.value ? "/wiki" : `/wiki/${version.value}`
   },
   {
     label: version.value

apps/web/utils/wiki.ts

@@ -9,25 +9,23 @@ export const getWikiCategories = () => categories;
 export const getWikiCategoryName = (category: keyof typeof categories) =>
   categories[category];
 
-export function parseWikiRouteParams(params: any) {
-  let version = params.version;
-  let mod = params.mod;
-  let category = params.category;
-  let slug = Array.isArray(params.slug) ? params.slug.join("/") : params.slug;
+export function parseWikiRouteParams(path: string) {
+  const parts = path.split("/").slice(1);
 
-  // index page doesn't have a slug or version so we don't want to move the mod
-  // id to the slug in this case
-  if (version === "") {
-    version = getWikiLatestVersion();
-  }
+  let version: string, mod: string, category: string, slug: string;
 
   // the latest version won't have the version in the url, which means it will
   // be the mod id
-  if (!semver.valid(semver.coerce(version), true)) {
-    slug = category;
-    category = mod;
-    mod = version;
+  if (!semver.valid(semver.coerce(parts[1]), true)) {
+    slug = parts[3];
+    category = parts[2];
+    mod = parts[1];
     version = getWikiLatestVersion();
+  } else {
+    slug = parts[4];
+    category = parts[3];
+    mod = parts[2];
+    version = parts[1];
   }
 
   return {