chore: i18n refactoring (#748)

Author: andrii-bodnar

src/content/config.ts

@@ -1,8 +1,7 @@
 import { defineCollection, z } from 'astro:content';
 import { docsLoader, i18nLoader } from '@astrojs/starlight/loaders';
 import { docsSchema, i18nSchema } from '@astrojs/starlight/schema';
-import { starlightLocales } from '../utils/i18n.ts';
-import { getBaseDocId, localizeDocId } from '../utils/docsSlug.ts';
+import { starlightLocales, getBaseDocId, localizeDocId } from '../utils/i18n.ts';
 
 export const collections = {
   docs: defineCollection({

src/utils/docsSlug.ts

@@ -1,6 +1,5 @@
 import { describe, it, expect } from 'vitest';
-import { slugFromPath, getBaseDocId, localizeDocId } from './docsSlug';
-import { starlightLocales } from './i18n';
+import { slugFromPath, getBaseDocId, localizeDocId, starlightLocales } from './i18n';
 
 const LOCALES = Object.keys(starlightLocales).filter(locale => locale !== 'root');
 

src/utils/docsSlug.test.ts src/utils/i18n.test.tssrc/utils/docsSlug.test.ts renamed to src/utils/i18n.test.ts

@@ -1,3 +1,5 @@
+import { slug as githubSlug } from 'github-slugger';
+
 import en from '../content/i18n/en.json';
 import de from '../content/i18n/de.json';
 import da from '../content/i18n/da.json';
@@ -34,3 +36,42 @@ export function sidebarLabel(key: SidebarTranslationKey) {
     },
   };
 }
+
+/*
+  In content-layer collections the entry `id` *is* Starlight's routing slug (there is no top-level `slug`).
+  The glob loader builds that id from the frontmatter `slug` when present, dropping the locale folder prefix for pages
+  shipped untranslated from the CMS - these helpers restore it. `entry` is the file path relative to src/content/docs (e.g. `tr/foo.md`).
+  Astro's default path-based id: github-slug each segment, join with `/`, strip a trailing `/index`. Mirrors `getContentEntryIdAndSlug`
+*/
+export function slugFromPath(filePath: string): string {
+  const withoutExt = filePath.replace(/\.[^/.]+$/, '');
+  return withoutExt
+    .split('/')
+    .map(segment => githubSlug(segment))
+    .join('/')
+    .replace(/\/index$/, '');
+}
+
+export function getBaseDocId(entry: string, frontmatterSlug?: unknown): string {
+  return frontmatterSlug
+    ? String(frontmatterSlug).replace(/^\/+/, '')
+    : slugFromPath(entry);
+}
+
+export function localizeDocId(
+  entry: string,
+  id: string,
+  localizedLocales: readonly string[],
+): string {
+  const localeSegment = entry.split('/')[0];
+
+  if (
+    localizedLocales.includes(localeSegment) &&
+    id !== localeSegment &&
+    !id.startsWith(`${localeSegment}/`)
+  ) {
+    return `${localeSegment}/${id}`;
+  }
+
+  return id;
+}

src/utils/i18n.ts

@@ -6,19 +6,16 @@
     { "source": "/it/:slug/", "destination": "/:slug/", "statusCode": 302 },
     { "source": "/ru/:slug/", "destination": "/:slug/", "statusCode": 302 },
     { "source": "/uk/:slug/", "destination": "/:slug/", "statusCode": 302 },
-    { "source": "/zh/:slug/", "destination": "/:slug/", "statusCode": 302 },
     { "source": "/br/enterprise/:slug/", "destination": "/enterprise/:slug/", "statusCode": 302 },
     { "source": "/hu/enterprise/:slug/", "destination": "/enterprise/:slug/", "statusCode": 302 },
     { "source": "/it/enterprise/:slug/", "destination": "/enterprise/:slug/", "statusCode": 302 },
     { "source": "/ru/enterprise/:slug/", "destination": "/enterprise/:slug/", "statusCode": 302 },
     { "source": "/uk/enterprise/:slug/", "destination": "/enterprise/:slug/", "statusCode": 302 },
-    { "source": "/zh/enterprise/:slug/", "destination": "/enterprise/:slug/", "statusCode": 302 },
     { "source": "/developer/br/:slug/", "destination": "/developer/:slug/", "statusCode": 302 },
     { "source": "/developer/hu/:slug/", "destination": "/developer/:slug/", "statusCode": 302 },
     { "source": "/developer/it/:slug/", "destination": "/developer/:slug/", "statusCode": 302 },
     { "source": "/developer/ru/:slug/", "destination": "/developer/:slug/", "statusCode": 302 },
     { "source": "/developer/uk/:slug/", "destination": "/developer/:slug/", "statusCode": 302 },
-    { "source": "/developer/zh/:slug/", "destination": "/developer/:slug/", "statusCode": 302 },
 
     { "source": "/enterprise/", "destination": "/enterprise/introduction/", "permanent": true },
     { "source": "/developer/", "destination": "/developer/crowdin-apps-about/", "permanent": true },