fix dm archive url resolution

Author: qiancai

gatsby/url-resolver/__tests__/url-resolver.test.ts

@@ -214,6 +214,24 @@ describe("calculateFileUrl", () => {
     expect(url).toBe("/en/tidb/dev/page/");
   });
 
+  it("should resolve tidb-data-migration _index with release branch alias", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "zh/tidb-data-migration/release-2.0/_index.md"
+    );
+    const url = calculateFileUrlWithConfig(absolutePath, testConfig);
+    expect(url).toBe("/zh/tidb-data-migration/v2.0");
+  });
+
+  it("should resolve tidb-data-migration pages with release branch alias", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "zh/tidb-data-migration/release-2.0/overview.md"
+    );
+    const url = calculateFileUrlWithConfig(absolutePath, testConfig);
+    expect(url).toBe("/zh/tidb-data-migration/v2.0/overview/");
+  });
+
   it("should resolve api folder", () => {
     const absolutePath = path.join(
       sourceBasePath,
@@ -469,6 +487,19 @@ describe("calculateFileUrl with defaultLanguage: 'en'", () => {
     // release-8.5 -> stable via branch-alias-tidb (exact match takes precedence)
     expect(url).toBe("/tidb/stable/alert-rules");
   });
+
+  it("should omit /en/ prefix for English tidb-data-migration files", () => {
+    const absolutePath = path.join(
+      sourceBasePath,
+      "en/tidb-data-migration/release-5.3/dm-overview.md"
+    );
+    const url = calculateFileUrlWithConfig(
+      absolutePath,
+      configWithDefaultLang,
+      true
+    );
+    expect(url).toBe("/tidb-data-migration/v5.3/dm-overview");
+  });
 });
 
 describe("calculateFileUrl with slug format (relative path)", () => {

gatsby/url-resolver/config.ts

@@ -123,6 +123,17 @@ export const defaultUrlResolverConfig: UrlResolverConfig = {
         ignoreIf: ["_index", "_docHome"],
       },
     },
+    // tidb-data-migration with branch and optional folders
+    // /en/tidb-data-migration/release-5.3/{...folders}/{filename} -> /en/tidb-data-migration/v5.3/{filename}
+    {
+      sourcePattern:
+        "/{lang}/tidb-data-migration/{branch}/{...folders}/{filename}",
+      targetPattern:
+        "/{lang}/tidb-data-migration/{branch:branch-alias-tidb-data-migration}/{filename}",
+      filenameTransform: {
+        ignoreIf: ["_index", "_docHome"],
+      },
+    },
     // Fallback: /{lang}/{repo}/{...any}/{filename} -> /{lang}/{repo}/{filename}
     {
       sourcePattern: "/{lang}/{repo}/{...any}/{filename}",
@@ -164,5 +175,15 @@ export const defaultUrlResolverConfig: UrlResolverConfig = {
         "release-*": "v*",
       },
     },
+    // Branch alias for tidb-data-migration: used in {branch:branch-alias-tidb-data-migration}
+    "branch-alias-tidb-data-migration": {
+      mappings: {
+        // Wildcard pattern: release-* -> v*
+        // Examples:
+        //   release-5.3 -> v5.3
+        //   release-2.0 -> v2.0
+        "release-*": "v*",
+      },
+    },
   },
 };