@docusaurus/plugin-content-docs 3.7.0-canary-6211 → 3.7.0-canary-6212

package/lib/cli.js

@@ -76,6 +76,23 @@ async function cliDocsVersionCommand(version, { id: pluginId, path: docsPath, si
                 versionName: version,
             });
         await fs_extra_1.default.copy(docsDir, newVersionDir);
+        // Copy version JSON translation file for this locale
+        // i18n/<l>/docusaurus-plugin-content-docs/current.json => version-v1.json
+        // See https://docusaurus.io/docs/next/api/plugins/@docusaurus/plugin-content-docs#translation-files-location
+        if (locale !== i18n.defaultLocale) {
+            const dir = (0, files_1.getPluginDirPathLocalized)({
+                localizationDir,
+                pluginId,
+            });
+            const sourceFile = path_1.default.join(dir, 'current.json');
+            const dest = path_1.default.join(dir, `version-${version}.json`);
+            if (await fs_extra_1.default.pathExists(sourceFile)) {
+                await fs_extra_1.default.copy(sourceFile, dest);
+            }
+            else {
+                logger_1.default.warn `${pluginIdLogPrefix}: i18n translation file does not exist in path=${sourceFile}. Skipping.`;
+            }
+        }
     }));
     await createVersionedSidebarFile({
         siteDir,

package/lib/versions/files.d.ts

@@ -15,6 +15,10 @@ export declare function getDocsDirPathLocalized({ localizationDir, pluginId, ver
     pluginId: string;
     versionName: string;
 }): string;
+export declare function getPluginDirPathLocalized({ localizationDir, pluginId, }: {
+    localizationDir: string;
+    pluginId: string;
+}): string;
 /** `community` => `[siteDir]/community_versions.json` */
 export declare function getVersionsFilePath(siteDir: string, pluginId: string): string;
 /**

package/lib/versions/files.js

@@ -9,6 +9,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getVersionDocsDirPath = getVersionDocsDirPath;
 exports.getVersionSidebarsPath = getVersionSidebarsPath;
 exports.getDocsDirPathLocalized = getDocsDirPathLocalized;
+exports.getPluginDirPathLocalized = getPluginDirPathLocalized;
 exports.getVersionsFilePath = getVersionsFilePath;
 exports.readVersionsFile = readVersionsFile;
 exports.readVersionNames = readVersionNames;
@@ -45,6 +46,14 @@ function getDocsDirPathLocalized({ localizationDir, pluginId, versionName, }) {
         ],
     });
 }
+function getPluginDirPathLocalized({ localizationDir, pluginId, }) {
+    return (0, utils_1.getPluginI18nPath)({
+        localizationDir,
+        pluginName: 'docusaurus-plugin-content-docs',
+        pluginId,
+        subPaths: [],
+    });
+}
 /** `community` => `[siteDir]/community_versions.json` */
 function getVersionsFilePath(siteDir, pluginId) {
     return path_1.default.join(siteDir, addPluginIdPrefix(constants_1.VERSIONS_JSON_FILE, pluginId));

package/package.json

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

package/src/cli.ts

@@ -14,6 +14,7 @@ import {
   getVersionDocsDirPath,
   getVersionSidebarsPath,
   getDocsDirPathLocalized,
+  getPluginDirPathLocalized,
   readVersionsFile,
 } from './versions/files';
 import {validateVersionName} from './versions/validation';
@@ -123,6 +124,23 @@ async function cliDocsVersionCommand(
               versionName: version,
             });
       await fs.copy(docsDir, newVersionDir);
+
+      // Copy version JSON translation file for this locale
+      // i18n/<l>/docusaurus-plugin-content-docs/current.json => version-v1.json
+      // See https://docusaurus.io/docs/next/api/plugins/@docusaurus/plugin-content-docs#translation-files-location
+      if (locale !== i18n.defaultLocale) {
+        const dir = getPluginDirPathLocalized({
+          localizationDir,
+          pluginId,
+        });
+        const sourceFile = path.join(dir, 'current.json');
+        const dest = path.join(dir, `version-${version}.json`);
+        if (await fs.pathExists(sourceFile)) {
+          await fs.copy(sourceFile, dest);
+        } else {
+          logger.warn`${pluginIdLogPrefix}: i18n translation file does not exist in path=${sourceFile}. Skipping.`;
+        }
+      }
     }),
   );
 

package/src/versions/files.ts

@@ -75,6 +75,21 @@ export function getDocsDirPathLocalized({
   });
 }
 
+export function getPluginDirPathLocalized({
+  localizationDir,
+  pluginId,
+}: {
+  localizationDir: string;
+  pluginId: string;
+}): string {
+  return getPluginI18nPath({
+    localizationDir,
+    pluginName: 'docusaurus-plugin-content-docs',
+    pluginId,
+    subPaths: [],
+  });
+}
+
 /** `community` => `[siteDir]/community_versions.json` */
 export function getVersionsFilePath(siteDir: string, pluginId: string): string {
   return path.join(siteDir, addPluginIdPrefix(VERSIONS_JSON_FILE, pluginId));