@docusaurus/plugin-content-docs 3.9.2-canary-6526 → 3.9.2-canary-6541

package/lib/index.js

@@ -75,7 +75,7 @@ async function pluginContentDocs(context, options) {
                         versionsMetadata,
                     }),
                 ].filter((d) => typeof d === 'string'),
-                useCrossCompilerCache: siteConfig.future.experimental_faster.mdxCrossCompilerCache,
+                useCrossCompilerCache: siteConfig.future.faster.mdxCrossCompilerCache,
                 admonitions: options.admonitions,
                 remarkPlugins,
                 rehypePlugins,

package/lib/translations.js

@@ -179,12 +179,51 @@ function getVersionTranslationFiles(version) {
         },
     ];
 }
+// TODO Docusaurus v4 or later
+//  this temporarily works, but it is not an ideal solution
+//  The docs navigation can be computed and shouldn't be part of LoadedVersion
+//  We need to derive the navigation from already translated content
+//  See https://github.com/facebook/docusaurus/pull/11794
+function translateDocNavigation(docs, translatedSidebars) {
+    // Build a map of permalink -> translated label for generated-index categories
+    const translatedLabelByPermalink = new Map();
+    for (const sidebar of Object.values(translatedSidebars)) {
+        for (const category of (0, utils_2.collectSidebarCategories)(sidebar)) {
+            if (category.link?.type === 'generated-index') {
+                translatedLabelByPermalink.set(category.link.permalink, category.label);
+            }
+        }
+    }
+    if (translatedLabelByPermalink.size === 0) {
+        return docs;
+    }
+    return docs.map((doc) => {
+        const previous = doc.previous && translatedLabelByPermalink.has(doc.previous.permalink)
+            ? {
+                ...doc.previous,
+                title: translatedLabelByPermalink.get(doc.previous.permalink),
+            }
+            : doc.previous;
+        const next = doc.next && translatedLabelByPermalink.has(doc.next.permalink)
+            ? {
+                ...doc.next,
+                title: translatedLabelByPermalink.get(doc.next.permalink),
+            }
+            : doc.next;
+        if (previous === doc.previous && next === doc.next) {
+            return doc;
+        }
+        return { ...doc, previous, next };
+    });
+}
 function translateVersion(version, translationFiles) {
     const versionTranslations = translationFiles[getVersionFileName(version.versionName)].content;
+    const translatedSidebars = translateSidebars(version, versionTranslations);
     return {
         ...version,
         label: versionTranslations['version.label']?.message ?? version.label,
-        sidebars: translateSidebars(version, versionTranslations),
+        sidebars: translatedSidebars,
+        docs: translateDocNavigation(version.docs, translatedSidebars),
     };
 }
 function getVersionsTranslationFiles(versions) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/plugin-content-docs",
-  "version": "3.9.2-canary-6526",
+  "version": "3.9.2-canary-6541",
   "description": "Docs plugin for Docusaurus.",
   "main": "lib/index.js",
   "sideEffects": false,
@@ -35,15 +35,15 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/core": "3.9.2-canary-6526",
-    "@docusaurus/logger": "3.9.2-canary-6526",
-    "@docusaurus/mdx-loader": "3.9.2-canary-6526",
-    "@docusaurus/module-type-aliases": "3.9.2-canary-6526",
-    "@docusaurus/theme-common": "3.9.2-canary-6526",
-    "@docusaurus/types": "3.9.2-canary-6526",
-    "@docusaurus/utils": "3.9.2-canary-6526",
-    "@docusaurus/utils-common": "3.9.2-canary-6526",
-    "@docusaurus/utils-validation": "3.9.2-canary-6526",
+    "@docusaurus/core": "3.9.2-canary-6541",
+    "@docusaurus/logger": "3.9.2-canary-6541",
+    "@docusaurus/mdx-loader": "3.9.2-canary-6541",
+    "@docusaurus/module-type-aliases": "3.9.2-canary-6541",
+    "@docusaurus/theme-common": "3.9.2-canary-6541",
+    "@docusaurus/types": "3.9.2-canary-6541",
+    "@docusaurus/utils": "3.9.2-canary-6541",
+    "@docusaurus/utils-common": "3.9.2-canary-6541",
+    "@docusaurus/utils-validation": "3.9.2-canary-6541",
     "@types/react-router-config": "^5.0.7",
     "combine-promises": "^1.1.0",
     "fs-extra": "^11.1.1",
@@ -67,5 +67,5 @@
   "engines": {
     "node": ">=20.0"
   },
-  "gitHead": "a37ae138931cb80b31664f86a34f97671c00e409"
+  "gitHead": "60ac4995b8bfb7a1b649eb7c7ae6e812222438c5"
 }

package/src/index.ts

@@ -131,8 +131,7 @@ export default async function pluginContentDocs(
           }),
         ].filter((d): d is string => typeof d === 'string'),
 
-        useCrossCompilerCache:
-          siteConfig.future.experimental_faster.mdxCrossCompilerCache,
+        useCrossCompilerCache: siteConfig.future.faster.mdxCrossCompilerCache,
         admonitions: options.admonitions,
         remarkPlugins,
         rehypePlugins,

package/src/translations.ts

@@ -269,16 +269,64 @@ function getVersionTranslationFiles(version: LoadedVersion): TranslationFile[] {
     },
   ];
 }
+
+// TODO Docusaurus v4 or later
+//  this temporarily works, but it is not an ideal solution
+//  The docs navigation can be computed and shouldn't be part of LoadedVersion
+//  We need to derive the navigation from already translated content
+//  See https://github.com/facebook/docusaurus/pull/11794
+function translateDocNavigation(
+  docs: LoadedVersion['docs'],
+  translatedSidebars: Sidebars,
+): LoadedVersion['docs'] {
+  // Build a map of permalink -> translated label for generated-index categories
+  const translatedLabelByPermalink = new Map<string, string>();
+  for (const sidebar of Object.values(translatedSidebars)) {
+    for (const category of collectSidebarCategories(sidebar)) {
+      if (category.link?.type === 'generated-index') {
+        translatedLabelByPermalink.set(category.link.permalink, category.label);
+      }
+    }
+  }
+
+  if (translatedLabelByPermalink.size === 0) {
+    return docs;
+  }
+
+  return docs.map((doc) => {
+    const previous =
+      doc.previous && translatedLabelByPermalink.has(doc.previous.permalink)
+        ? {
+            ...doc.previous,
+            title: translatedLabelByPermalink.get(doc.previous.permalink)!,
+          }
+        : doc.previous;
+    const next =
+      doc.next && translatedLabelByPermalink.has(doc.next.permalink)
+        ? {
+            ...doc.next,
+            title: translatedLabelByPermalink.get(doc.next.permalink)!,
+          }
+        : doc.next;
+    if (previous === doc.previous && next === doc.next) {
+      return doc;
+    }
+    return {...doc, previous, next};
+  });
+}
+
 function translateVersion(
   version: LoadedVersion,
   translationFiles: {[fileName: string]: TranslationFile},
 ): LoadedVersion {
   const versionTranslations =
     translationFiles[getVersionFileName(version.versionName)]!.content;
+  const translatedSidebars = translateSidebars(version, versionTranslations);
   return {
     ...version,
     label: versionTranslations['version.label']?.message ?? version.label,
-    sidebars: translateSidebars(version, versionTranslations),
+    sidebars: translatedSidebars,
+    docs: translateDocNavigation(version.docs, translatedSidebars),
   };
 }