fix(landing): preserve canonical event tutorial links

Author: 徐燕来

apps/landing-page/app/i18n.ts

@@ -7093,6 +7093,12 @@ export function pageNameFromPath(pathname = '/'): string {
   return segments.join('_').toLowerCase().replace(/[^a-z0-9_]+/g, '_');
 }
 
+// These pages intentionally ship only at their canonical English URL. Internal
+// links must not acquire a locale prefix that points at an ungenerated route.
+const LOCALE_CANONICAL_ONLY_PATHS = new Set([
+  '/tutorials/open-design-ai-ppt-tutorial/',
+]);
+
 export function localizedHref(
   href: string,
   locale: LandingLocaleCode,
@@ -7113,7 +7119,11 @@ export function localizedHref(
   if (pathAndQuery === '') return hashSuffix || href;
   const [path, query = ''] = pathAndQuery.split('?');
   const querySuffix = query ? `?${query}` : '';
-  const localized = localePath(locale, path || '/');
+  const pathname = path || '/';
+  if (LOCALE_CANONICAL_ONLY_PATHS.has(pathname)) {
+    return `${pathname}${querySuffix}${hashSuffix}`;
+  }
+  const localized = localePath(locale, pathname);
   return `${localized}${querySuffix}${hashSuffix}`;
 }
 

apps/landing-page/tests/event-recap-localized-links.test.ts

@@ -0,0 +1,47 @@
+import assert from 'node:assert/strict';
+import { readFile } from 'node:fs/promises';
+import { test } from 'node:test';
+
+import { LANDING_LOCALES, localizedHref } from '../app/i18n.ts';
+
+const PPT_TUTORIAL_PATH = '/tutorials/open-design-ai-ppt-tutorial/';
+const EVENT_PARTIALS = [
+  'open-design-osaka-meetup-main',
+  'open-design-shanghai-workshop-main',
+] as const;
+
+function localizeInternalLinks(html: string, locale: (typeof LANDING_LOCALES)[number]['code']) {
+  return html.replace(
+    /href="(\/[^\"]+)"/g,
+    (_match, pathname: string) => `href="${localizedHref(pathname, locale)}"`,
+  );
+}
+
+test('event recaps keep canonical-only tutorial links valid in every active locale', async () => {
+  for (const eventPartial of EVENT_PARTIALS) {
+    for (const { code } of LANDING_LOCALES) {
+      const localeSuffix = code === 'en' ? '' : `.${code}`;
+      const partial = await readFile(
+        new URL(`../app/_partials/${eventPartial}${localeSuffix}.html`, import.meta.url),
+        'utf8',
+      );
+      const rendered = localizeInternalLinks(partial, code);
+
+      assert.match(
+        partial,
+        new RegExp(`href="${PPT_TUTORIAL_PATH}"`),
+        `${eventPartial}.${code}: fixture no longer links to the canonical tutorial`,
+      );
+      assert.match(
+        rendered,
+        new RegExp(`href="${PPT_TUTORIAL_PATH}"`),
+        `${eventPartial}.${code}: canonical tutorial link was rewritten`,
+      );
+      assert.doesNotMatch(
+        rendered,
+        new RegExp(`href="/${code}${PPT_TUTORIAL_PATH}"`),
+        `${eventPartial}.${code}: generated link points at a missing localized tutorial route`,
+      );
+    }
+  }
+});