Set up redirects based on 404 data & filter sitemap

astro.config.ts

@@ -1,20 +1,17 @@
-import { defineConfig } from 'astro/config';
 import preact from '@astrojs/preact';
-import sitemap from '@astrojs/sitemap';
+import { defineConfig } from 'astro/config';
 
 import { toString } from 'hast-util-to-string';
 import { h } from 'hastscript';
 import { escape } from 'html-escaper';
 
-import { tokens, foregroundPrimary, backgroundPrimary } from './syntax-highlighting-theme';
 import { astroAsides } from './integrations/astro-asides';
-import { astroSpoilers } from './integrations/astro-spoilers';
 import { astroCodeSnippets } from './integrations/astro-code-snippets';
-import { remarkFallbackLang } from './plugins/remark-fallback-lang';
+import { astroSpoilers } from './integrations/astro-spoilers';
+import { sitemap } from './integrations/sitemap';
 import { rehypeTasklistEnhancer } from './plugins/rehype-tasklist-enhancer';
-
-import languages from './src/i18n/languages';
-import { normalizeLangTag } from './src/i18n/bcp-normalize';
+import { remarkFallbackLang } from './plugins/remark-fallback-lang';
+import { backgroundPrimary, foregroundPrimary, tokens } from './syntax-highlighting-theme';
 
 const AnchorLinkIcon = h(
 	'svg',
@@ -46,14 +43,7 @@ export default defineConfig({
 	},
 	integrations: [
 		preact({ compat: true }),
-		sitemap({
-			i18n: {
-				defaultLocale: 'en',
-				locales: Object.fromEntries(
-					Object.keys(languages).map((lang) => [lang, normalizeLangTag(lang)])
-				),
-			},
-		}),
+		sitemap(),
 		astroAsides(),
 		astroSpoilers(),
 		astroCodeSnippets(),

integrations/sitemap.ts

@@ -0,0 +1,30 @@
+import AstroSitemap from '@astrojs/sitemap';
+import type { AstroIntegration } from 'astro';
+import { normalizeLangTag } from '../src/i18n/bcp-normalize';
+import languages from '../src/i18n/languages';
+
+const langTags = Object.keys(languages);
+
+/** Set matching our `/[lang]/something.astro` redirect routes. */
+const blocklist = new Set([
+	...langTags.map((lang) => `/${lang}/`),
+	...langTags.map((lang) => `/${lang}/install/`),
+	...langTags.map((lang) => `/${lang}/tutorial/`),
+]);
+
+/** Match a pathname starting with “lighthouse” or one of our language tags. */
+const ValidRouteRE = new RegExp(`^/(lighthouse|${langTags.join('|')})/`);
+
+/** Test a pathname is not in our blocklist and starts with a valid prefix. */
+const isValidPath = (path: string) => !blocklist.has(path) && ValidRouteRE.test(path);
+
+/** Get a preconfigured instance of the `@astrojs/sitemap` integration. */
+export function sitemap(): AstroIntegration {
+	return AstroSitemap({
+		filter: (page) => isValidPath(new URL(page).pathname),
+		i18n: {
+			defaultLocale: 'en',
+			locales: Object.fromEntries(langTags.map((lang) => [lang, normalizeLangTag(lang)])),
+		},
+	});
+}

netlify.toml

@@ -2,6 +2,10 @@
   command = "pnpm build"
   ignore = "git diff --quiet $COMMIT_REF $CACHED_COMMIT_REF -- /"
 
+  [[redirects]]
+    from = "/reference/renderer-reference"
+    to = "/en/reference/integrations-reference"
+
   [[redirects]]
     from = "/en/reference/renderer-reference"
     to = "/en/reference/integrations-reference"

src/pages/[lang]/tutorial.astro

@@ -0,0 +1,9 @@
+---
+import languages from '../../i18n/languages';
+
+export const getStaticPaths = () => Object.keys(languages).map((lang) => ({ params: { lang } }));
+
+const { lang } = Astro.params;
+---
+
+<meta http-equiv="refresh" content={`0;url=/${lang}/tutorial/0-introduction/`} />