@docusaurus/plugin-content-blog 3.9.1-canary-6425 → 3.9.2-alpha.0

package/lib/blogUtils.d.ts

@@ -4,6 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+import type { TagsFile } from '@docusaurus/utils';
 import type { LoadContext } from '@docusaurus/types';
 import type { AuthorsMap, PluginOptions, BlogPost, BlogTags, BlogPaginated } from '@docusaurus/plugin-content-blog';
 import type { BlogContentPaths } from './types';
@@ -34,7 +35,7 @@ type ParsedBlogFileName = {
     slug: string;
 };
 export declare function parseBlogFileName(blogSourceRelative: string): ParsedBlogFileName;
-export declare function generateBlogPosts(contentPaths: BlogContentPaths, context: LoadContext, options: PluginOptions, authorsMap?: AuthorsMap): Promise<BlogPost[]>;
+export declare function generateBlogPosts(contentPaths: BlogContentPaths, context: LoadContext, options: PluginOptions, tagsFile: TagsFile | null, authorsMap?: AuthorsMap): Promise<BlogPost[]>;
 export declare function applyProcessBlogPosts({ blogPosts, processBlogPosts, }: {
     blogPosts: BlogPost[];
     processBlogPosts: PluginOptions['processBlogPosts'];

package/lib/blogUtils.js

@@ -20,7 +20,6 @@ const path_1 = tslib_1.__importDefault(require("path"));
 const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const utils_1 = require("@docusaurus/utils");
-const utils_validation_1 = require("@docusaurus/utils-validation");
 const frontMatter_1 = require("./frontMatter");
 const authors_1 = require("./authors");
 const authorsProblems_1 = require("./authorsProblems");
@@ -132,7 +131,7 @@ async function parseBlogPostMarkdownFile({ filePath, parseFrontMatter, }) {
 }
 const defaultReadingTime = ({ content, locale, options }) => (0, readingTime_1.calculateReadingTime)(content, locale, options);
 async function processBlogSourceFile(blogSourceRelative, contentPaths, context, options, tagsFile, authorsMap) {
-    const { siteConfig: { baseUrl, markdown: { parseFrontMatter }, }, siteDir, i18n, } = context;
+    const { siteConfig: { baseUrl, markdown: { parseFrontMatter }, future: { experimental_vcs: vcs }, }, siteDir, i18n, } = context;
     const { routeBasePath, tagsBasePath: tagsRouteBasePath, truncateMarker, showReadingTime, editUrl, } = options;
     // Lookup in localized folder in priority
     const blogDirPath = await (0, utils_1.getFolderContainingFile)((0, utils_1.getContentPathList)(contentPaths), blogSourceRelative);
@@ -142,7 +141,7 @@ async function processBlogSourceFile(blogSourceRelative, contentPaths, context,
         parseFrontMatter,
     });
     const aliasedSource = (0, utils_1.aliasedSitePath)(blogSourceAbsolute, siteDir);
-    const lastUpdate = await (0, utils_1.readLastUpdateData)(blogSourceAbsolute, options, frontMatter.last_update);
+    const lastUpdate = await (0, utils_1.readLastUpdateData)(blogSourceAbsolute, options, frontMatter.last_update, vcs);
     const draft = (0, utils_1.isDraft)({ frontMatter });
     const unlisted = (0, utils_1.isUnlisted)({ frontMatter });
     if (draft) {
@@ -165,17 +164,11 @@ async function processBlogSourceFile(blogSourceRelative, contentPaths, context,
         else if (parsedBlogFileName.date) {
             return parsedBlogFileName.date;
         }
-        try {
-            const result = await (0, utils_1.getFileCommitDate)(blogSourceAbsolute, {
-                age: 'oldest',
-                includeAuthor: false,
-            });
-            return result.date;
-        }
-        catch (err) {
-            logger_1.default.warn(err);
+        const result = await vcs.getFileCreationInfo(blogSourceAbsolute);
+        if (result == null) {
             return (await fs_extra_1.default.stat(blogSourceAbsolute)).birthtime;
         }
+        return new Date(result.timestamp);
     }
     const date = await getDate();
     const title = frontMatter.title ?? contentTitle ?? parsedBlogFileName.text;
@@ -253,7 +246,7 @@ async function processBlogSourceFile(blogSourceRelative, contentPaths, context,
         content,
     };
 }
-async function generateBlogPosts(contentPaths, context, options, authorsMap) {
+async function generateBlogPosts(contentPaths, context, options, tagsFile, authorsMap) {
     const { include, exclude } = options;
     if (!(await fs_extra_1.default.pathExists(contentPaths.contentPath))) {
         return [];
@@ -262,7 +255,6 @@ async function generateBlogPosts(contentPaths, context, options, authorsMap) {
         cwd: contentPaths.contentPath,
         ignore: exclude,
     });
-    const tagsFile = await (0, utils_validation_1.getTagsFile)({ contentPaths, tags: options.tags });
     async function doProcessBlogSourceFile(blogSourceFile) {
         try {
             return await processBlogSourceFile(blogSourceFile, contentPaths, context, options, tagsFile, authorsMap);

package/lib/feed.js

@@ -116,7 +116,7 @@ async function resolveXsltFilePaths({ xsltFilePath, contentPaths, }) {
     }
     const parsedPath = path_1.default.parse(xsltAbsolutePath);
     const cssAbsolutePath = path_1.default.resolve(parsedPath.dir, `${parsedPath.name}.css`);
-    if (!(await fs_extra_1.default.pathExists(xsltAbsolutePath))) {
+    if (!(await fs_extra_1.default.pathExists(cssAbsolutePath))) {
         throw new Error(logger_1.default.interpolate `Blog feed XSLT file was found at path=${path_1.default.relative(process.cwd(), xsltAbsolutePath)}
 But its expected co-located CSS file could not be found at path=${path_1.default.relative(process.cwd(), cssAbsolutePath)}
 If you want to provide a custom XSLT file, you must provide a CSS file with the exact same name.`);

package/lib/index.js

@@ -11,6 +11,7 @@ exports.default = pluginContentBlog;
 const tslib_1 = require("tslib");
 const path_1 = tslib_1.__importDefault(require("path"));
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
+const combine_promises_1 = tslib_1.__importDefault(require("combine-promises"));
 const utils_1 = require("@docusaurus/utils");
 const utils_validation_1 = require("@docusaurus/utils-validation");
 const mdx_loader_1 = require("@docusaurus/mdx-loader");
@@ -41,7 +42,7 @@ async function pluginContentBlog(context, options) {
             })
             : undefined,
     };
-    const pluginId = options.id ?? utils_1.DEFAULT_PLUGIN_ID;
+    const pluginId = options.id;
     const pluginDataDirRoot = path_1.default.join(generatedFilesDir, PluginName);
     const dataDir = path_1.default.join(pluginDataDirRoot, pluginId);
     // TODO Docusaurus v4 breaking change
@@ -57,7 +58,7 @@ async function pluginContentBlog(context, options) {
         const { admonitions, rehypePlugins, remarkPlugins, recmaPlugins, truncateMarker, beforeDefaultRemarkPlugins, beforeDefaultRehypePlugins, } = options;
         const contentDirs = (0, utils_1.getContentPathList)(contentPaths);
         const mdxLoaderItem = await (0, mdx_loader_1.createMDXLoaderItem)({
-            useCrossCompilerCache: siteConfig.future.experimental_faster.mdxCrossCompilerCache,
+            useCrossCompilerCache: siteConfig.future.faster.mdxCrossCompilerCache,
             admonitions,
             remarkPlugins,
             rehypePlugins,
@@ -141,18 +142,26 @@ async function pluginContentBlog(context, options) {
             const { postsPerPage: postsPerPageOption, routeBasePath, tagsBasePath, blogDescription, blogTitle, blogSidebarTitle, pageBasePath, authorsBasePath, authorsMapPath, } = options;
             const baseBlogUrl = (0, utils_1.normalizeUrl)([baseUrl, routeBasePath]);
             const blogTagsListPath = (0, utils_1.normalizeUrl)([baseBlogUrl, tagsBasePath]);
-            const authorsMap = await (0, authorsMap_1.getAuthorsMap)({
-                contentPaths,
-                authorsMapPath,
-                authorsBaseRoutePath: (0, utils_1.normalizeUrl)([
+            async function getAuthorsMapChecked() {
+                const result = await (0, authorsMap_1.getAuthorsMap)({
+                    contentPaths,
+                    authorsMapPath,
+                    authorsBaseRoutePath: (0, utils_1.normalizeUrl)([
+                        baseUrl,
+                        routeBasePath,
+                        authorsBasePath,
+                    ]),
                     baseUrl,
-                    routeBasePath,
-                    authorsBasePath,
-                ]),
-                baseUrl,
+                });
+                (0, authorsMap_1.checkAuthorsMapPermalinkCollisions)(result);
+                return result;
+            }
+            // Read all the input files in parallel
+            const { authorsMap, tagsFile } = await (0, combine_promises_1.default)({
+                authorsMap: getAuthorsMapChecked(),
+                tagsFile: (0, utils_validation_1.getTagsFile)({ contentPaths, tags: options.tags }),
             });
-            (0, authorsMap_1.checkAuthorsMapPermalinkCollisions)(authorsMap);
-            let blogPosts = await (0, blogUtils_1.generateBlogPosts)(contentPaths, context, options, authorsMap);
+            let blogPosts = await (0, blogUtils_1.generateBlogPosts)(contentPaths, context, options, tagsFile, authorsMap);
             blogPosts = await (0, blogUtils_1.applyProcessBlogPosts)({
                 blogPosts,
                 processBlogPosts: options.processBlogPosts,
@@ -164,9 +173,10 @@ async function pluginContentBlog(context, options) {
             const listedBlogPosts = blogPosts.filter(blogUtils_1.shouldBeListed);
             if (!blogPosts.length) {
                 return {
+                    blogTitle,
+                    blogDescription,
                     blogSidebarTitle,
                     blogPosts: [],
-                    blogListPaginated: [],
                     blogTags: {},
                     blogTagsListPath,
                     authorsMap,
@@ -191,14 +201,9 @@ async function pluginContentBlog(context, options) {
                     };
                 }
             });
-            const blogListPaginated = (0, blogUtils_1.paginateBlogPosts)({
-                blogPosts: listedBlogPosts,
-                blogTitle,
-                blogDescription,
-                postsPerPageOption,
-                basePageUrl: baseBlogUrl,
-                pageBasePath,
-            });
+            // TODO this is not the correct place to aggregate and paginate tags
+            //  for reasons similar to https://github.com/facebook/docusaurus/pull/11562
+            //  What we should do here is only read the tags file (similar to authors)
             const blogTags = (0, blogUtils_1.getBlogTags)({
                 blogPosts,
                 postsPerPageOption,
@@ -207,9 +212,10 @@ async function pluginContentBlog(context, options) {
                 pageBasePath,
             });
             return {
+                blogTitle,
+                blogDescription,
                 blogSidebarTitle,
                 blogPosts,
-                blogListPaginated,
                 blogTags,
                 blogTagsListPath,
                 authorsMap,

package/lib/options.js

@@ -13,6 +13,7 @@ const path_1 = tslib_1.__importDefault(require("path"));
 const utils_validation_1 = require("@docusaurus/utils-validation");
 const utils_1 = require("@docusaurus/utils");
 exports.DEFAULT_OPTIONS = {
+    id: utils_1.DEFAULT_PLUGIN_ID,
     feedOptions: {
         type: ['rss', 'atom'],
         copyright: '',

package/lib/routes.js

@@ -19,15 +19,12 @@ async function createAllRoutes(param) {
     routes.forEach(param.actions.addRoute);
 }
 async function buildAllRoutes({ baseUrl, content, actions, options, aliasedSource, }) {
-    const { blogListComponent, blogPostComponent, blogTagsListComponent, blogAuthorsListComponent, blogAuthorsPostsComponent, blogTagsPostsComponent, blogArchiveComponent, routeBasePath, archiveBasePath, blogTitle, authorsBasePath, postsPerPage, blogDescription, } = options;
+    const { blogListComponent, blogPostComponent, blogTagsListComponent, blogAuthorsListComponent, blogAuthorsPostsComponent, blogTagsPostsComponent, blogArchiveComponent, routeBasePath, archiveBasePath, authorsBasePath, postsPerPage, pageBasePath, } = options;
     const pluginId = options.id;
     const { createData } = actions;
-    const { blogSidebarTitle, blogPosts, blogListPaginated, blogTags, blogTagsListPath, authorsMap, } = content;
-    const authorsListPath = (0, utils_1.normalizeUrl)([
-        baseUrl,
-        routeBasePath,
-        authorsBasePath,
-    ]);
+    const { blogTitle, blogDescription, blogSidebarTitle, blogPosts, blogTags, blogTagsListPath, authorsMap, } = content;
+    const blogBasePath = (0, utils_1.normalizeUrl)([baseUrl, routeBasePath]);
+    const authorsListPath = (0, utils_1.normalizeUrl)([blogBasePath, authorsBasePath]);
     const listedBlogPosts = blogPosts.filter(blogUtils_1.shouldBeListed);
     const blogPostsById = lodash_1.default.keyBy(blogPosts, (post) => post.id);
     function getBlogPostById(id) {
@@ -50,7 +47,7 @@ async function buildAllRoutes({ baseUrl, content, actions, options, aliasedSourc
     }
     async function createBlogMetadataModule() {
         const blogMetadata = {
-            blogBasePath: (0, utils_1.normalizeUrl)([baseUrl, routeBasePath]),
+            blogBasePath,
             blogTitle,
             authorsListPath,
         };
@@ -81,7 +78,7 @@ async function buildAllRoutes({ baseUrl, content, actions, options, aliasedSourc
         if (archiveBasePath && listedBlogPosts.length) {
             return [
                 {
-                    path: (0, utils_1.normalizeUrl)([baseUrl, routeBasePath, archiveBasePath]),
+                    path: (0, utils_1.normalizeUrl)([blogBasePath, archiveBasePath]),
                     component: blogArchiveComponent,
                     exact: true,
                     props: {
@@ -124,6 +121,14 @@ async function buildAllRoutes({ baseUrl, content, actions, options, aliasedSourc
         return blogPosts.map(createBlogPostRoute);
     }
     function createBlogPostsPaginatedRoutes() {
+        const blogListPaginated = (0, blogUtils_1.paginateBlogPosts)({
+            blogPosts: listedBlogPosts,
+            blogTitle,
+            blogDescription,
+            postsPerPageOption: postsPerPage,
+            basePageUrl: blogBasePath,
+            pageBasePath,
+        });
         return blogListPaginated.map((paginated) => {
             return {
                 path: paginated.metadata.permalink,
@@ -197,10 +202,14 @@ async function buildAllRoutes({ baseUrl, content, actions, options, aliasedSourc
                     sidebar: sidebarModulePath,
                 },
                 props: {
-                    authors: authors.map((author) => (0, props_1.toAuthorItemProp)({
-                        author,
-                        count: blogPostsByAuthorKey[author.key]?.length ?? 0,
-                    })),
+                    authors: authors.map((author) => {
+                        const authorPosts = blogPostsByAuthorKey[author.key] ?? [];
+                        const listedAuthorPosts = authorPosts.filter(blogUtils_1.shouldBeListed);
+                        return (0, props_1.toAuthorItemProp)({
+                            author,
+                            count: listedAuthorPosts.length,
+                        });
+                    }),
                 },
                 context: {
                     blogMetadata: blogMetadataModulePath,
@@ -209,15 +218,16 @@ async function buildAllRoutes({ baseUrl, content, actions, options, aliasedSourc
         }
         function createAuthorPaginatedRoute(author) {
             const authorBlogPosts = blogPostsByAuthorKey[author.key] ?? [];
+            const listedAuthorBlogPosts = authorBlogPosts.filter(blogUtils_1.shouldBeListed);
             if (!author.page) {
                 return [];
             }
             const pages = (0, blogUtils_1.paginateBlogPosts)({
-                blogPosts: authorBlogPosts,
+                blogPosts: listedAuthorBlogPosts,
                 basePageUrl: author.page.permalink,
                 blogDescription,
                 blogTitle,
-                pageBasePath: authorsBasePath,
+                pageBasePath,
                 postsPerPageOption: postsPerPage,
             });
             return pages.map(({ metadata, items }) => {
@@ -230,7 +240,10 @@ async function buildAllRoutes({ baseUrl, content, actions, options, aliasedSourc
                         sidebar: sidebarModulePath,
                     },
                     props: {
-                        author: (0, props_1.toAuthorItemProp)({ author, count: authorBlogPosts.length }),
+                        author: (0, props_1.toAuthorItemProp)({
+                            author,
+                            count: listedAuthorBlogPosts.length,
+                        }),
                         listMetadata: metadata,
                     },
                     context: {

package/lib/translations.js

@@ -8,19 +8,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getTranslationFiles = getTranslationFiles;
 exports.translateContent = translateContent;
-function translateListPage(blogListPaginated, translations) {
-    return blogListPaginated.map((page) => {
-        const { items, metadata } = page;
-        return {
-            items,
-            metadata: {
-                ...metadata,
-                blogTitle: translations.title?.message ?? page.metadata.blogTitle,
-                blogDescription: translations.description?.message ?? page.metadata.blogDescription,
-            },
-        };
-    });
-}
 function getTranslationFiles(options) {
     return [
         {
@@ -43,10 +30,11 @@ function getTranslationFiles(options) {
     ];
 }
 function translateContent(content, translationFiles) {
-    const { content: optionsTranslations } = translationFiles[0];
+    const { content: translations } = translationFiles[0];
     return {
         ...content,
-        blogSidebarTitle: optionsTranslations['sidebar.title']?.message ?? content.blogSidebarTitle,
-        blogListPaginated: translateListPage(content.blogListPaginated, optionsTranslations),
+        blogTitle: translations.title?.message ?? content.blogTitle,
+        blogDescription: translations.description?.message ?? content.blogDescription,
+        blogSidebarTitle: translations['sidebar.title']?.message ?? content.blogSidebarTitle,
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/plugin-content-blog",
-  "version": "3.9.1-canary-6425",
+  "version": "3.9.2-alpha.0",
   "description": "Blog plugin for Docusaurus.",
   "main": "lib/index.js",
   "types": "src/plugin-content-blog.d.ts",
@@ -31,15 +31,16 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/core": "3.9.1-canary-6425",
-    "@docusaurus/logger": "3.9.1-canary-6425",
-    "@docusaurus/mdx-loader": "3.9.1-canary-6425",
-    "@docusaurus/theme-common": "3.9.1-canary-6425",
-    "@docusaurus/types": "3.9.1-canary-6425",
-    "@docusaurus/utils": "3.9.1-canary-6425",
-    "@docusaurus/utils-common": "3.9.1-canary-6425",
-    "@docusaurus/utils-validation": "3.9.1-canary-6425",
+    "@docusaurus/core": "3.9.2-alpha.0",
+    "@docusaurus/logger": "3.9.2-alpha.0",
+    "@docusaurus/mdx-loader": "3.9.2-alpha.0",
+    "@docusaurus/theme-common": "3.9.2-alpha.0",
+    "@docusaurus/types": "3.9.2-alpha.0",
+    "@docusaurus/utils": "3.9.2-alpha.0",
+    "@docusaurus/utils-common": "3.9.2-alpha.0",
+    "@docusaurus/utils-validation": "3.9.2-alpha.0",
     "cheerio": "1.0.0-rc.12",
+    "combine-promises": "^1.1.0",
     "feed": "^4.2.2",
     "fs-extra": "^11.1.1",
     "lodash": "^4.17.21",
@@ -62,5 +63,5 @@
     "@total-typescript/shoehorn": "^0.1.2",
     "tree-node-cli": "^1.6.0"
   },
-  "gitHead": "bd0880bb0de0c29ecc18a303f7a70b640aaf8636"
+  "gitHead": "27626cdd7a102277935f10cc4d8d3f93e211eafe"
 }

package/src/blogUtils.ts

@@ -19,7 +19,6 @@ import {
   Globby,
   groupTaggedItems,
   getTagVisibility,
-  getFileCommitDate,
   getContentPathList,
   isUnlisted,
   isDraft,
@@ -27,7 +26,7 @@ import {
   normalizeTags,
   aliasedSitePathToRelativePath,
 } from '@docusaurus/utils';
-import {getTagsFile} from '@docusaurus/utils-validation';
+
 import {validateBlogPostFrontMatter} from './frontMatter';
 import {getBlogPostAuthors} from './authors';
 import {reportAuthorsProblems} from './authorsProblems';
@@ -225,6 +224,7 @@ async function processBlogSourceFile(
     siteConfig: {
       baseUrl,
       markdown: {parseFrontMatter},
+      future: {experimental_vcs: vcs},
     },
     siteDir,
     i18n,
@@ -257,6 +257,7 @@ async function processBlogSourceFile(
     blogSourceAbsolute,
     options,
     frontMatter.last_update,
+    vcs,
   );
 
   const draft = isDraft({frontMatter});
@@ -285,17 +286,11 @@ async function processBlogSourceFile(
       return parsedBlogFileName.date;
     }
 
-    try {
-      const result = await getFileCommitDate(blogSourceAbsolute, {
-        age: 'oldest',
-        includeAuthor: false,
-      });
-
-      return result.date;
-    } catch (err) {
-      logger.warn(err);
+    const result = await vcs.getFileCreationInfo(blogSourceAbsolute);
+    if (result == null) {
       return (await fs.stat(blogSourceAbsolute)).birthtime;
     }
+    return new Date(result.timestamp);
   }
 
   const date = await getDate();
@@ -393,6 +388,7 @@ export async function generateBlogPosts(
   contentPaths: BlogContentPaths,
   context: LoadContext,
   options: PluginOptions,
+  tagsFile: TagsFile | null,
   authorsMap?: AuthorsMap,
 ): Promise<BlogPost[]> {
   const {include, exclude} = options;
@@ -406,8 +402,6 @@ export async function generateBlogPosts(
     ignore: exclude,
   });
 
-  const tagsFile = await getTagsFile({contentPaths, tags: options.tags});
-
   async function doProcessBlogSourceFile(blogSourceFile: string) {
     try {
       return await processBlogSourceFile(

package/src/feed.ts

@@ -213,7 +213,7 @@ async function resolveXsltFilePaths({
     parsedPath.dir,
     `${parsedPath.name}.css`,
   );
-  if (!(await fs.pathExists(xsltAbsolutePath))) {
+  if (!(await fs.pathExists(cssAbsolutePath))) {
     throw new Error(
       logger.interpolate`Blog feed XSLT file was found at path=${path.relative(
         process.cwd(),

package/src/index.ts

@@ -7,6 +7,8 @@
 
 import path from 'path';
 import logger from '@docusaurus/logger';
+import combinePromises from 'combine-promises';
+
 import {
   normalizeUrl,
   docuHash,
@@ -17,15 +19,16 @@ import {
   createAbsoluteFilePathMatcher,
   getContentPathList,
   getDataFilePath,
-  DEFAULT_PLUGIN_ID,
   resolveMarkdownLinkPathname,
   getLocaleConfig,
 } from '@docusaurus/utils';
-import {getTagsFilePathsToWatch} from '@docusaurus/utils-validation';
+import {
+  getTagsFilePathsToWatch,
+  getTagsFile,
+} from '@docusaurus/utils-validation';
 import {createMDXLoaderItem} from '@docusaurus/mdx-loader';
 import {
   getBlogTags,
-  paginateBlogPosts,
   shouldBeListed,
   applyProcessBlogPosts,
   generateBlogPosts,
@@ -45,7 +48,6 @@ import type {
   Assets,
   BlogTags,
   BlogContent,
-  BlogPaginated,
 } from '@docusaurus/plugin-content-blog';
 import type {RuleSetRule, RuleSetUseItem} from 'webpack';
 
@@ -85,7 +87,7 @@ export default async function pluginContentBlog(
         })
       : undefined,
   };
-  const pluginId = options.id ?? DEFAULT_PLUGIN_ID;
+  const pluginId = options.id;
 
   const pluginDataDirRoot = path.join(generatedFilesDir, PluginName);
   const dataDir = path.join(pluginDataDirRoot, pluginId);
@@ -116,8 +118,7 @@ export default async function pluginContentBlog(
     const contentDirs = getContentPathList(contentPaths);
 
     const mdxLoaderItem = await createMDXLoaderItem({
-      useCrossCompilerCache:
-        siteConfig.future.experimental_faster.mdxCrossCompilerCache,
+      useCrossCompilerCache: siteConfig.future.faster.mdxCrossCompilerCache,
       admonitions,
       remarkPlugins,
       rehypePlugins,
@@ -230,22 +231,32 @@ export default async function pluginContentBlog(
       const baseBlogUrl = normalizeUrl([baseUrl, routeBasePath]);
       const blogTagsListPath = normalizeUrl([baseBlogUrl, tagsBasePath]);
 
-      const authorsMap = await getAuthorsMap({
-        contentPaths,
-        authorsMapPath,
-        authorsBaseRoutePath: normalizeUrl([
+      async function getAuthorsMapChecked() {
+        const result = await getAuthorsMap({
+          contentPaths,
+          authorsMapPath,
+          authorsBaseRoutePath: normalizeUrl([
+            baseUrl,
+            routeBasePath,
+            authorsBasePath,
+          ]),
           baseUrl,
-          routeBasePath,
-          authorsBasePath,
-        ]),
-        baseUrl,
+        });
+        checkAuthorsMapPermalinkCollisions(result);
+        return result;
+      }
+
+      // Read all the input files in parallel
+      const {authorsMap, tagsFile} = await combinePromises({
+        authorsMap: getAuthorsMapChecked(),
+        tagsFile: getTagsFile({contentPaths, tags: options.tags}),
       });
-      checkAuthorsMapPermalinkCollisions(authorsMap);
 
       let blogPosts = await generateBlogPosts(
         contentPaths,
         context,
         options,
+        tagsFile,
         authorsMap,
       );
       blogPosts = await applyProcessBlogPosts({
@@ -260,9 +271,10 @@ export default async function pluginContentBlog(
 
       if (!blogPosts.length) {
         return {
+          blogTitle,
+          blogDescription,
           blogSidebarTitle,
           blogPosts: [],
-          blogListPaginated: [],
           blogTags: {},
           blogTagsListPath,
           authorsMap,
@@ -291,15 +303,9 @@ export default async function pluginContentBlog(
         }
       });
 
-      const blogListPaginated: BlogPaginated[] = paginateBlogPosts({
-        blogPosts: listedBlogPosts,
-        blogTitle,
-        blogDescription,
-        postsPerPageOption,
-        basePageUrl: baseBlogUrl,
-        pageBasePath,
-      });
-
+      // TODO this is not the correct place to aggregate and paginate tags
+      //  for reasons similar to https://github.com/facebook/docusaurus/pull/11562
+      //  What we should do here is only read the tags file (similar to authors)
       const blogTags: BlogTags = getBlogTags({
         blogPosts,
         postsPerPageOption,
@@ -309,9 +315,10 @@ export default async function pluginContentBlog(
       });
 
       return {
+        blogTitle,
+        blogDescription,
         blogSidebarTitle,
         blogPosts,
-        blogListPaginated,
         blogTags,
         blogTagsListPath,
         authorsMap,

package/src/options.ts

@@ -15,7 +15,7 @@ import {
   RouteBasePathSchema,
   URISchema,
 } from '@docusaurus/utils-validation';
-import {GlobExcludeDefault} from '@docusaurus/utils';
+import {DEFAULT_PLUGIN_ID, GlobExcludeDefault} from '@docusaurus/utils';
 import type {
   PluginOptions,
   Options,
@@ -25,6 +25,7 @@ import type {
 import type {OptionValidationContext} from '@docusaurus/types';
 
 export const DEFAULT_OPTIONS: PluginOptions = {
+  id: DEFAULT_PLUGIN_ID,
   feedOptions: {
     type: ['rss', 'atom'],
     copyright: '',

package/src/plugin-content-blog.d.ts

@@ -431,7 +431,7 @@ declare module '@docusaurus/plugin-content-blog' {
   export type PluginOptions = MDXOptions &
     TagsPluginOptions & {
       /** Plugin ID. */
-      id?: string;
+      id: string;
       /**
        * Path to the blog content directory on the file system, relative to site
        * directory.
@@ -583,9 +583,10 @@ declare module '@docusaurus/plugin-content-blog' {
   export type AuthorsMap = {[authorKey: string]: AuthorWithKey};
 
   export type BlogContent = {
-    blogSidebarTitle: string;
+    blogTitle: string; // for translation purposes
+    blogDescription: string; // for translation purposes
+    blogSidebarTitle: string; // for translation purposes
     blogPosts: BlogPost[];
-    blogListPaginated: BlogPaginated[];
     blogTags: BlogTags;
     blogTagsListPath: string;
     authorsMap?: AuthorsMap;

package/src/routes.ts

@@ -67,27 +67,24 @@ export async function buildAllRoutes({
     blogArchiveComponent,
     routeBasePath,
     archiveBasePath,
-    blogTitle,
     authorsBasePath,
     postsPerPage,
-    blogDescription,
+    pageBasePath,
   } = options;
-  const pluginId = options.id!;
+  const pluginId = options.id;
   const {createData} = actions;
   const {
+    blogTitle,
+    blogDescription,
     blogSidebarTitle,
     blogPosts,
-    blogListPaginated,
     blogTags,
     blogTagsListPath,
     authorsMap,
   } = content;
 
-  const authorsListPath = normalizeUrl([
-    baseUrl,
-    routeBasePath,
-    authorsBasePath,
-  ]);
+  const blogBasePath = normalizeUrl([baseUrl, routeBasePath]);
+  const authorsListPath = normalizeUrl([blogBasePath, authorsBasePath]);
 
   const listedBlogPosts = blogPosts.filter(shouldBeListed);
 
@@ -119,7 +116,7 @@ export async function buildAllRoutes({
 
   async function createBlogMetadataModule() {
     const blogMetadata: BlogMetadata = {
-      blogBasePath: normalizeUrl([baseUrl, routeBasePath]),
+      blogBasePath,
       blogTitle,
       authorsListPath,
     };
@@ -156,7 +153,7 @@ export async function buildAllRoutes({
     if (archiveBasePath && listedBlogPosts.length) {
       return [
         {
-          path: normalizeUrl([baseUrl, routeBasePath, archiveBasePath]),
+          path: normalizeUrl([blogBasePath, archiveBasePath]),
           component: blogArchiveComponent,
           exact: true,
           props: {
@@ -210,6 +207,15 @@ export async function buildAllRoutes({
   }
 
   function createBlogPostsPaginatedRoutes(): RouteConfig[] {
+    const blogListPaginated = paginateBlogPosts({
+      blogPosts: listedBlogPosts,
+      blogTitle,
+      blogDescription,
+      postsPerPageOption: postsPerPage,
+      basePageUrl: blogBasePath,
+      pageBasePath,
+    });
+
     return blogListPaginated.map((paginated) => {
       return {
         path: paginated.metadata.permalink,
@@ -294,12 +300,14 @@ export async function buildAllRoutes({
           sidebar: sidebarModulePath,
         },
         props: {
-          authors: authors.map((author) =>
-            toAuthorItemProp({
+          authors: authors.map((author) => {
+            const authorPosts = blogPostsByAuthorKey[author.key] ?? [];
+            const listedAuthorPosts = authorPosts.filter(shouldBeListed);
+            return toAuthorItemProp({
               author,
-              count: blogPostsByAuthorKey[author.key]?.length ?? 0,
-            }),
-          ),
+              count: listedAuthorPosts.length,
+            });
+          }),
         },
         context: {
           blogMetadata: blogMetadataModulePath,
@@ -309,16 +317,17 @@ export async function buildAllRoutes({
 
     function createAuthorPaginatedRoute(author: AuthorWithKey): RouteConfig[] {
       const authorBlogPosts = blogPostsByAuthorKey[author.key] ?? [];
+      const listedAuthorBlogPosts = authorBlogPosts.filter(shouldBeListed);
       if (!author.page) {
         return [];
       }
 
       const pages = paginateBlogPosts({
-        blogPosts: authorBlogPosts,
+        blogPosts: listedAuthorBlogPosts,
         basePageUrl: author.page.permalink,
         blogDescription,
         blogTitle,
-        pageBasePath: authorsBasePath,
+        pageBasePath,
         postsPerPageOption: postsPerPage,
       });
 
@@ -332,7 +341,10 @@ export async function buildAllRoutes({
             sidebar: sidebarModulePath,
           },
           props: {
-            author: toAuthorItemProp({author, count: authorBlogPosts.length}),
+            author: toAuthorItemProp({
+              author,
+              count: listedAuthorBlogPosts.length,
+            }),
             listMetadata: metadata,
           },
           context: {

package/src/translations.ts

@@ -5,30 +5,8 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import type {TranslationFileContent, TranslationFile} from '@docusaurus/types';
-import type {
-  PluginOptions,
-  BlogContent,
-  BlogPaginated,
-} from '@docusaurus/plugin-content-blog';
-
-function translateListPage(
-  blogListPaginated: BlogPaginated[],
-  translations: TranslationFileContent,
-) {
-  return blogListPaginated.map((page) => {
-    const {items, metadata} = page;
-    return {
-      items,
-      metadata: {
-        ...metadata,
-        blogTitle: translations.title?.message ?? page.metadata.blogTitle,
-        blogDescription:
-          translations.description?.message ?? page.metadata.blogDescription,
-      },
-    };
-  });
-}
+import type {TranslationFile} from '@docusaurus/types';
+import type {PluginOptions, BlogContent} from '@docusaurus/plugin-content-blog';
 
 export function getTranslationFiles(options: PluginOptions): TranslationFile[] {
   return [
@@ -56,14 +34,13 @@ export function translateContent(
   content: BlogContent,
   translationFiles: TranslationFile[],
 ): BlogContent {
-  const {content: optionsTranslations} = translationFiles[0]!;
+  const {content: translations} = translationFiles[0]!;
   return {
     ...content,
+    blogTitle: translations.title?.message ?? content.blogTitle,
+    blogDescription:
+      translations.description?.message ?? content.blogDescription,
     blogSidebarTitle:
-      optionsTranslations['sidebar.title']?.message ?? content.blogSidebarTitle,
-    blogListPaginated: translateListPage(
-      content.blogListPaginated,
-      optionsTranslations,
-    ),
+      translations['sidebar.title']?.message ?? content.blogSidebarTitle,
   };
 }