zrok redirects

Author: nicoalba

unified-doc/docusaurus.config.ts

@@ -103,6 +103,56 @@ console.log("    hotjar app         : " + cfg.hotjar.id);
 console.log('REMARK_MAPPINGS:', JSON.stringify(REMARK_MAPPINGS, null, 2));
 
 
+function zrokRedirects(): PluginConfig {
+    // Paths are relative to baseUrl.
+    // Production (baseUrl='/docs/'): prefix = '/zrok'
+    // Vercel preview (baseUrl='/'): prefix = '/docs/zrok'
+    const p = (path: string) => isVercel ? `/docs/zrok${path}` : `/zrok${path}`;
+    const redirects = [
+        // getting-started → get-started
+        { to: '/get-started/', from: ['/getting-started'] },
+        // category/guides → category/how-to-guides
+        { to: '/category/how-to-guides', from: ['/category/guides'] },
+        // guides/* → how-tos/*
+        { to: '/how-tos/agent/', from: ['/guides/agent/'] },
+        { to: '/how-tos/agent/http-healthcheck', from: ['/guides/agent/http-healthcheck'] },
+        { to: '/how-tos/agent/linux-service', from: ['/guides/agent/linux-service'] },
+        { to: '/how-tos/agent/remoting', from: ['/guides/agent/remoting'] },
+        { to: '/how-tos/agent/windows-service/', from: ['/guides/agent/windows-service/'] },
+        { to: '/how-tos/docker-share/', from: ['/guides/docker-share/'] },
+        { to: '/how-tos/docker-share/private-share', from: ['/guides/docker-share/docker_private_share_guide'] },
+        { to: '/how-tos/docker-share/public-share', from: ['/guides/docker-share/docker_public_share_guide'] },
+        { to: '/how-tos/drives', from: ['/guides/drives'] },
+        { to: '/how-tos/frontdoor', from: ['/guides/frontdoor'] },
+        { to: '/how-tos/install/', from: ['/guides/install/'] },
+        { to: '/how-tos/install/linux', from: ['/guides/install/linux'] },
+        { to: '/how-tos/install/macos', from: ['/guides/install/macos'] },
+        { to: '/how-tos/install/windows', from: ['/guides/install/windows'] },
+        { to: '/how-tos/permission-modes', from: ['/guides/permission-modes'] },
+        { to: '/how-tos/v2-migration-guide', from: ['/guides/v2-migration-guide'] },
+        { to: '/how-tos/vpn', from: ['/guides/vpn'] },
+        // guides/self-hosting/* → self-hosting/*
+        { to: '/self-hosting/docker', from: ['/guides/self-hosting/docker'] },
+        { to: '/self-hosting/dynamic-proxy', from: ['/guides/self-hosting/dynamicProxy'] },
+        { to: '/self-hosting/error-pages', from: ['/guides/self-hosting/error-pages'] },
+        { to: '/self-hosting/instance-configuration', from: ['/guides/self-hosting/instance-configuration'] },
+        { to: '/self-hosting/interstitial-page', from: ['/guides/self-hosting/interstitial-page'] },
+        { to: '/self-hosting/kubernetes', from: ['/guides/self-hosting/kubernetes'] },
+        { to: '/self-hosting/linux/', from: ['/guides/self-hosting/self_hosting_guide', '/guides/self-hosting/linux'] },
+        { to: '/self-hosting/linux/nginx', from: ['/guides/self-hosting/nginx_tls_guide/', '/guides/self-hosting/linux/nginx'] },
+        { to: '/self-hosting/metrics-and-limits/configuring-limits', from: ['/guides/metrics-and-limits/configuring-limits', '/guides/self-hosting/metrics-and-limits/configuring-limits'] },
+        { to: '/self-hosting/metrics-and-limits/configuring-metrics', from: ['/guides/metrics-and-limits/configuring-metrics', '/guides/self-hosting/metrics-and-limits/configuring-metrics'] },
+        { to: '/self-hosting/oauth/configuring-oauth', from: ['/guides/self-hosting/oauth/configuring-oauth'] },
+        { to: '/self-hosting/oauth/integrations/github', from: ['/guides/self-hosting/oauth/integrations/github'] },
+        { to: '/self-hosting/oauth/integrations/google', from: ['/guides/self-hosting/oauth/integrations/google'] },
+        { to: '/self-hosting/oauth/integrations/oidc', from: ['/guides/self-hosting/oauth/integrations/oidc'] },
+        { to: '/self-hosting/organizations', from: ['/guides/self-hosting/organizations'] },
+        { to: '/self-hosting/personalized-frontend', from: ['/guides/self-hosting/personalized-frontend'] },
+        { to: '/self-hosting/self-service-invite', from: ['/guides/self-hosting/self-service-invite'] },
+    ].map(({ to, from }) => ({ to: p(to), from: from.map(f => p(f)) }));
+    return ['@docusaurus/plugin-client-redirects', { redirects }];
+}
+
 function extendDocsPlugins(plugin: PluginConfig): PluginConfig {
     if (!Array.isArray(plugin)) return plugin;
 
@@ -351,6 +401,7 @@ const config: Config = {
         [pluginHotjar, {}],
         ['@docusaurus/plugin-google-tag-manager', {id: `openziti-gtm`, containerId: cfg.google.tag}],
         build(BUILD_FLAGS.SELFHOSTED) && onpremRedirects(routeBase('selfhosted')),
+        build(BUILD_FLAGS.ZROK) && zrokRedirects(),
     ].filter(Boolean),
     themeConfig: {
         docs: {