@docusaurus/plugin-content-blog 0.0.0-6012 → 0.0.0-6016

package/lib/blogUtils.js

@@ -30,7 +30,7 @@ function truncate(fileString, truncateMarker) {
 function paginateBlogPosts({ blogPosts, basePageUrl, blogTitle, blogDescription, postsPerPageOption, pageBasePath, }) {
     const totalCount = blogPosts.length;
     const postsPerPage = postsPerPageOption === 'ALL' ? totalCount : postsPerPageOption;
-    const numberOfPages = Math.ceil(totalCount / postsPerPage);
+    const numberOfPages = Math.max(1, Math.ceil(totalCount / postsPerPage));
     const pages = [];
     function permalink(page) {
         return page > 0
@@ -236,7 +236,7 @@ async function processBlogSourceFile(blogSourceRelative, contentPaths, context,
         content,
     };
 }
-async function generateBlogPosts(contentPaths, context, options) {
+async function generateBlogPosts(contentPaths, context, options, authorsMap) {
     const { include, exclude } = options;
     if (!(await fs_extra_1.default.pathExists(contentPaths.contentPath))) {
         return [];
@@ -245,10 +245,6 @@ async function generateBlogPosts(contentPaths, context, options) {
         cwd: contentPaths.contentPath,
         ignore: exclude,
     });
-    const authorsMap = await (0, authors_1.getAuthorsMap)({
-        contentPaths,
-        authorsMapPath: options.authorsMapPath,
-    });
     const tagsFile = await (0, utils_validation_1.getTagsFile)({ contentPaths, tags: options.tags });
     async function doProcessBlogSourceFile(blogSourceFile) {
         try {

package/lib/feed.d.ts

@@ -4,14 +4,16 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+import type { BlogContentPaths } from './types';
 import type { DocusaurusConfig, HtmlTags, LoadContext } from '@docusaurus/types';
 import type { PluginOptions, BlogPost } from '@docusaurus/plugin-content-blog';
-export declare function createBlogFeedFiles({ blogPosts: allBlogPosts, options, siteConfig, outDir, locale, }: {
+export declare function createBlogFeedFiles({ blogPosts: allBlogPosts, options, siteConfig, outDir, locale, contentPaths, }: {
     blogPosts: BlogPost[];
     options: PluginOptions;
     siteConfig: DocusaurusConfig;
     outDir: string;
     locale: string;
+    contentPaths: BlogContentPaths;
 }): Promise<void>;
 export declare function createFeedHtmlHeadTags({ context, options, }: {
     context: LoadContext;

package/lib/feed.js

@@ -11,12 +11,12 @@ exports.createFeedHtmlHeadTags = createFeedHtmlHeadTags;
 const tslib_1 = require("tslib");
 const path_1 = tslib_1.__importDefault(require("path"));
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
-const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const feed_1 = require("feed");
 const srcset = tslib_1.__importStar(require("srcset"));
 const utils_1 = require("@docusaurus/utils");
 const utils_common_1 = require("@docusaurus/utils-common");
 const cheerio_1 = require("cheerio");
+const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 async function generateBlogFeed({ blogPosts, options, siteConfig, outDir, locale, }) {
     if (!blogPosts.length) {
         return null;
@@ -106,25 +106,72 @@ async function defaultCreateFeedItems({ blogPosts, siteConfig, outDir, }) {
         return feedItem;
     }));
 }
-async function createBlogFeedFile({ feed, feedType, generatePath, }) {
-    const [feedContent, feedPath] = (() => {
-        switch (feedType) {
-            case 'rss':
-                return [feed.rss2(), 'rss.xml'];
-            case 'json':
-                return [feed.json1(), 'feed.json'];
-            case 'atom':
-                return [feed.atom1(), 'atom.xml'];
-            default:
-                throw new Error(`Feed type ${feedType} not supported.`);
-        }
-    })();
+async function resolveXsltFilePaths({ xsltFilePath, contentPaths, }) {
+    const xsltAbsolutePath = path_1.default.isAbsolute(xsltFilePath)
+        ? xsltFilePath
+        : (await (0, utils_1.getDataFilePath)({ filePath: xsltFilePath, contentPaths })) ??
+            path_1.default.resolve(contentPaths.contentPath, xsltFilePath);
+    if (!(await fs_extra_1.default.pathExists(xsltAbsolutePath))) {
+        throw new Error(logger_1.default.interpolate `Blog feed XSLT file not found at path=${path_1.default.relative(process.cwd(), xsltAbsolutePath)}`);
+    }
+    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))) {
+        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.`);
+    }
+    return { xsltAbsolutePath, cssAbsolutePath };
+}
+async function generateXsltFiles({ xsltFilePath, generatePath, contentPaths, }) {
+    const { xsltAbsolutePath, cssAbsolutePath } = await resolveXsltFilePaths({
+        xsltFilePath,
+        contentPaths,
+    });
+    const xsltOutputPath = path_1.default.join(generatePath, path_1.default.basename(xsltAbsolutePath));
+    const cssOutputPath = path_1.default.join(generatePath, path_1.default.basename(cssAbsolutePath));
+    await fs_extra_1.default.copy(xsltAbsolutePath, xsltOutputPath);
+    await fs_extra_1.default.copy(cssAbsolutePath, cssOutputPath);
+}
+// This modifies the XML feed content to add a relative href to the XSLT file
+// Good enough for now: we probably don't need a full XML parser just for that
+// See also https://darekkay.com/blog/rss-styling/
+function injectXslt({ feedContent, xsltFilePath, }) {
+    return feedContent.replace('<?xml version="1.0" encoding="utf-8"?>', `<?xml version="1.0" encoding="utf-8"?><?xml-stylesheet type="text/xsl" href="${path_1.default.basename(xsltFilePath)}"?>`);
+}
+const FeedConfigs = {
+    rss: {
+        outputFileName: 'rss.xml',
+        getContent: (feed) => feed.rss2(),
+        getXsltFilePath: (xslt) => xslt.rss,
+    },
+    atom: {
+        outputFileName: 'atom.xml',
+        getContent: (feed) => feed.atom1(),
+        getXsltFilePath: (xslt) => xslt.atom,
+    },
+    json: {
+        outputFileName: 'feed.json',
+        getContent: (feed) => feed.json1(),
+        getXsltFilePath: () => null,
+    },
+};
+async function createBlogFeedFile({ feed, feedType, generatePath, feedOptions, contentPaths, }) {
     try {
-        await fs_extra_1.default.outputFile(path_1.default.join(generatePath, feedPath), feedContent);
+        const feedConfig = FeedConfigs[feedType];
+        let feedContent = feedConfig.getContent(feed);
+        const xsltFilePath = feedConfig.getXsltFilePath(feedOptions.xslt);
+        if (xsltFilePath) {
+            await generateXsltFiles({ xsltFilePath, contentPaths, generatePath });
+            feedContent = injectXslt({ feedContent, xsltFilePath });
+        }
+        const outputPath = path_1.default.join(generatePath, feedConfig.outputFileName);
+        await fs_extra_1.default.outputFile(outputPath, feedContent);
     }
     catch (err) {
-        logger_1.default.error(`Generating ${feedType} feed failed.`);
-        throw err;
+        throw new Error(`Generating ${feedType} feed failed.`, {
+            cause: err,
+        });
     }
 }
 function shouldBeInFeed(blogPost) {
@@ -132,7 +179,7 @@ function shouldBeInFeed(blogPost) {
         blogPost.metadata.frontMatter.unlisted;
     return !excluded;
 }
-async function createBlogFeedFiles({ blogPosts: allBlogPosts, options, siteConfig, outDir, locale, }) {
+async function createBlogFeedFiles({ blogPosts: allBlogPosts, options, siteConfig, outDir, locale, contentPaths, }) {
     const blogPosts = allBlogPosts.filter(shouldBeInFeed);
     const feed = await generateBlogFeed({
         blogPosts,
@@ -149,6 +196,8 @@ async function createBlogFeedFiles({ blogPosts: allBlogPosts, options, siteConfi
         feed,
         feedType,
         generatePath: path_1.default.join(outDir, options.routeBasePath),
+        feedOptions: options.feedOptions,
+        contentPaths,
     })));
 }
 function createFeedHtmlHeadTags({ context, options, }) {

package/lib/index.js

@@ -18,6 +18,7 @@ const footnoteIDFixer_1 = tslib_1.__importDefault(require("./remark/footnoteIDFi
 const translations_1 = require("./translations");
 const feed_1 = require("./feed");
 const routes_1 = require("./routes");
+const authorsMap_1 = require("./authorsMap");
 const PluginName = 'docusaurus-plugin-content-blog';
 // TODO this is bad, we should have a better way to do this (new lifecycle?)
 //  The source to permalink is currently a mutable map passed to the mdx loader
@@ -88,10 +89,20 @@ async function pluginContentBlog(context, options) {
         },
         // Fetches blog contents and returns metadata for the necessary routes.
         async loadContent() {
-            const { postsPerPage: postsPerPageOption, routeBasePath, tagsBasePath, blogDescription, blogTitle, blogSidebarTitle, pageBasePath, } = 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]);
-            let blogPosts = await (0, blogUtils_1.generateBlogPosts)(contentPaths, context, options);
+            const authorsMap = await (0, authorsMap_1.getAuthorsMap)({
+                contentPaths,
+                authorsMapPath,
+                authorsBaseRoutePath: (0, utils_1.normalizeUrl)([
+                    baseUrl,
+                    routeBasePath,
+                    authorsBasePath,
+                ]),
+            });
+            (0, authorsMap_1.checkAuthorsMapPermalinkCollisions)(authorsMap);
+            let blogPosts = await (0, blogUtils_1.generateBlogPosts)(contentPaths, context, options, authorsMap);
             blogPosts = await (0, blogUtils_1.applyProcessBlogPosts)({
                 blogPosts,
                 processBlogPosts: options.processBlogPosts,
@@ -104,6 +115,7 @@ async function pluginContentBlog(context, options) {
                     blogListPaginated: [],
                     blogTags: {},
                     blogTagsListPath,
+                    authorsMap,
                 };
             }
             // Collocate next and prev metadata.
@@ -146,6 +158,7 @@ async function pluginContentBlog(context, options) {
                 blogListPaginated,
                 blogTags,
                 blogTagsListPath,
+                authorsMap,
             };
         },
         async contentLoaded({ content, actions }) {
@@ -253,6 +266,7 @@ async function pluginContentBlog(context, options) {
                 outDir,
                 siteConfig,
                 locale: currentLocale,
+                contentPaths,
             });
         },
         injectHtmlTags({ content }) {

package/lib/options.d.ts

@@ -7,4 +7,8 @@
 import type { PluginOptions, Options } from '@docusaurus/plugin-content-blog';
 import type { OptionValidationContext } from '@docusaurus/types';
 export declare const DEFAULT_OPTIONS: PluginOptions;
+export declare const XSLTBuiltInPaths: {
+    rss: string;
+    atom: string;
+};
 export declare function validateOptions({ validate, options, }: OptionValidationContext<Options | undefined, PluginOptions>): PluginOptions;

package/lib/options.js

@@ -6,12 +6,22 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_OPTIONS = void 0;
+exports.XSLTBuiltInPaths = exports.DEFAULT_OPTIONS = void 0;
 exports.validateOptions = validateOptions;
+const tslib_1 = require("tslib");
+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 = {
-    feedOptions: { type: ['rss', 'atom'], copyright: '', limit: 20 },
+    feedOptions: {
+        type: ['rss', 'atom'],
+        copyright: '',
+        limit: 20,
+        xslt: {
+            rss: null,
+            atom: null,
+        },
+    },
     beforeDefaultRehypePlugins: [],
     beforeDefaultRemarkPlugins: [],
     admonitions: true,
@@ -22,6 +32,8 @@ exports.DEFAULT_OPTIONS = {
     showReadingTime: true,
     blogTagsPostsComponent: '@theme/BlogTagsPostsPage',
     blogTagsListComponent: '@theme/BlogTagsListPage',
+    blogAuthorsPostsComponent: '@theme/Blog/Pages/BlogAuthorsPostsPage',
+    blogAuthorsListComponent: '@theme/Blog/Pages/BlogAuthorsListPage',
     blogPostComponent: '@theme/BlogPostPage',
     blogListComponent: '@theme/BlogListPage',
     blogArchiveComponent: '@theme/BlogArchivePage',
@@ -46,8 +58,75 @@ exports.DEFAULT_OPTIONS = {
     processBlogPosts: async () => undefined,
     onInlineTags: 'warn',
     tags: undefined,
+    authorsBasePath: 'authors',
     onInlineAuthors: 'warn',
 };
+exports.XSLTBuiltInPaths = {
+    rss: path_1.default.resolve(__dirname, '..', 'assets', 'rss.xsl'),
+    atom: path_1.default.resolve(__dirname, '..', 'assets', 'atom.xsl'),
+};
+function normalizeXsltOption(option, type) {
+    if (typeof option === 'string') {
+        return option;
+    }
+    if (option === true) {
+        return exports.XSLTBuiltInPaths[type];
+    }
+    return null;
+}
+function createXSLTFilePathSchema(type) {
+    return utils_validation_1.Joi.alternatives()
+        .try(utils_validation_1.Joi.string().required(), utils_validation_1.Joi.boolean()
+        .allow(null, () => undefined)
+        .custom((val) => normalizeXsltOption(val, type)))
+        .optional()
+        .default(null);
+}
+const FeedXSLTOptionsSchema = utils_validation_1.Joi.alternatives()
+    .try(utils_validation_1.Joi.object({
+    rss: createXSLTFilePathSchema('rss'),
+    atom: createXSLTFilePathSchema('atom'),
+}).required(), utils_validation_1.Joi.boolean()
+    .allow(null, () => undefined)
+    .custom((val) => ({
+    rss: normalizeXsltOption(val, 'rss'),
+    atom: normalizeXsltOption(val, 'atom'),
+})))
+    .optional()
+    .custom((val) => {
+    if (val === null) {
+        return {
+            rss: null,
+            atom: null,
+        };
+    }
+    return val;
+})
+    .default(exports.DEFAULT_OPTIONS.feedOptions.xslt);
+const FeedOptionsSchema = utils_validation_1.Joi.object({
+    type: utils_validation_1.Joi.alternatives()
+        .try(utils_validation_1.Joi.array().items(utils_validation_1.Joi.string().equal('rss', 'atom', 'json')), utils_validation_1.Joi.alternatives().conditional(utils_validation_1.Joi.string().equal('all', 'rss', 'atom', 'json'), {
+        then: utils_validation_1.Joi.custom((val) => val === 'all' ? ['rss', 'atom', 'json'] : [val]),
+    }))
+        .allow(null)
+        .default(exports.DEFAULT_OPTIONS.feedOptions.type),
+    xslt: FeedXSLTOptionsSchema,
+    title: utils_validation_1.Joi.string().allow(''),
+    description: utils_validation_1.Joi.string().allow(''),
+    // Only add default value when user actually wants a feed (type is not null)
+    copyright: utils_validation_1.Joi.when('type', {
+        is: utils_validation_1.Joi.any().valid(null),
+        then: utils_validation_1.Joi.string().optional(),
+        otherwise: utils_validation_1.Joi.string()
+            .allow('')
+            .default(exports.DEFAULT_OPTIONS.feedOptions.copyright),
+    }),
+    language: utils_validation_1.Joi.string(),
+    createFeedItems: utils_validation_1.Joi.function(),
+    limit: utils_validation_1.Joi.alternatives()
+        .try(utils_validation_1.Joi.number(), utils_validation_1.Joi.valid(null), utils_validation_1.Joi.valid(false))
+        .default(exports.DEFAULT_OPTIONS.feedOptions.limit),
+}).default(exports.DEFAULT_OPTIONS.feedOptions);
 const PluginOptionSchema = utils_validation_1.Joi.object({
     path: utils_validation_1.Joi.string().default(exports.DEFAULT_OPTIONS.path),
     archiveBasePath: utils_validation_1.Joi.string()
@@ -65,6 +144,8 @@ const PluginOptionSchema = utils_validation_1.Joi.object({
     blogPostComponent: utils_validation_1.Joi.string().default(exports.DEFAULT_OPTIONS.blogPostComponent),
     blogTagsListComponent: utils_validation_1.Joi.string().default(exports.DEFAULT_OPTIONS.blogTagsListComponent),
     blogTagsPostsComponent: utils_validation_1.Joi.string().default(exports.DEFAULT_OPTIONS.blogTagsPostsComponent),
+    blogAuthorsPostsComponent: utils_validation_1.Joi.string().default(exports.DEFAULT_OPTIONS.blogAuthorsPostsComponent),
+    blogAuthorsListComponent: utils_validation_1.Joi.string().default(exports.DEFAULT_OPTIONS.blogAuthorsListComponent),
     blogArchiveComponent: utils_validation_1.Joi.string().default(exports.DEFAULT_OPTIONS.blogArchiveComponent),
     blogTitle: utils_validation_1.Joi.string().allow('').default(exports.DEFAULT_OPTIONS.blogTitle),
     blogDescription: utils_validation_1.Joi.string()
@@ -84,29 +165,7 @@ const PluginOptionSchema = utils_validation_1.Joi.object({
     truncateMarker: utils_validation_1.Joi.object().default(exports.DEFAULT_OPTIONS.truncateMarker),
     beforeDefaultRemarkPlugins: utils_validation_1.RemarkPluginsSchema.default(exports.DEFAULT_OPTIONS.beforeDefaultRemarkPlugins),
     beforeDefaultRehypePlugins: utils_validation_1.RehypePluginsSchema.default(exports.DEFAULT_OPTIONS.beforeDefaultRehypePlugins),
-    feedOptions: utils_validation_1.Joi.object({
-        type: utils_validation_1.Joi.alternatives()
-            .try(utils_validation_1.Joi.array().items(utils_validation_1.Joi.string().equal('rss', 'atom', 'json')), utils_validation_1.Joi.alternatives().conditional(utils_validation_1.Joi.string().equal('all', 'rss', 'atom', 'json'), {
-            then: utils_validation_1.Joi.custom((val) => val === 'all' ? ['rss', 'atom', 'json'] : [val]),
-        }))
-            .allow(null)
-            .default(exports.DEFAULT_OPTIONS.feedOptions.type),
-        title: utils_validation_1.Joi.string().allow(''),
-        description: utils_validation_1.Joi.string().allow(''),
-        // Only add default value when user actually wants a feed (type is not null)
-        copyright: utils_validation_1.Joi.when('type', {
-            is: utils_validation_1.Joi.any().valid(null),
-            then: utils_validation_1.Joi.string().optional(),
-            otherwise: utils_validation_1.Joi.string()
-                .allow('')
-                .default(exports.DEFAULT_OPTIONS.feedOptions.copyright),
-        }),
-        language: utils_validation_1.Joi.string(),
-        createFeedItems: utils_validation_1.Joi.function(),
-        limit: utils_validation_1.Joi.alternatives()
-            .try(utils_validation_1.Joi.number(), utils_validation_1.Joi.valid(null), utils_validation_1.Joi.valid(false))
-            .default(exports.DEFAULT_OPTIONS.feedOptions.limit),
-    }).default(exports.DEFAULT_OPTIONS.feedOptions),
+    feedOptions: FeedOptionsSchema,
     authorsMapPath: utils_validation_1.Joi.string().default(exports.DEFAULT_OPTIONS.authorsMapPath),
     readingTime: utils_validation_1.Joi.function().default(() => exports.DEFAULT_OPTIONS.readingTime),
     sortPosts: utils_validation_1.Joi.string()
@@ -124,6 +183,9 @@ const PluginOptionSchema = utils_validation_1.Joi.object({
         .disallow('')
         .allow(null, false)
         .default(() => exports.DEFAULT_OPTIONS.tags),
+    authorsBasePath: utils_validation_1.Joi.string()
+        .default(exports.DEFAULT_OPTIONS.authorsBasePath)
+        .disallow(''),
     onInlineAuthors: utils_validation_1.Joi.string()
         .equal('ignore', 'log', 'warn', 'throw')
         .default(exports.DEFAULT_OPTIONS.onInlineAuthors),

package/lib/props.d.ts

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { TagsListItem, TagModule } from '@docusaurus/utils';
-import type { BlogPost, BlogSidebar, BlogTag, BlogTags } from '@docusaurus/plugin-content-blog';
+import type { AuthorItemProp, AuthorWithKey, BlogPost, BlogSidebar, BlogTag, BlogTags } from '@docusaurus/plugin-content-blog';
 export declare function toTagsProp({ blogTags }: {
     blogTags: BlogTags;
 }): TagsListItem[];
@@ -13,6 +13,10 @@ export declare function toTagProp({ blogTagsListPath, tag, }: {
     blogTagsListPath: string;
     tag: BlogTag;
 }): TagModule;
+export declare function toAuthorItemProp({ author, count, }: {
+    author: AuthorWithKey;
+    count: number;
+}): AuthorItemProp;
 export declare function toBlogSidebarProp({ blogSidebarTitle, blogPosts, }: {
     blogSidebarTitle: string;
     blogPosts: BlogPost[];

package/lib/props.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.toTagsProp = toTagsProp;
 exports.toTagProp = toTagProp;
+exports.toAuthorItemProp = toAuthorItemProp;
 exports.toBlogSidebarProp = toBlogSidebarProp;
 function toTagsProp({ blogTags }) {
     return Object.values(blogTags)
@@ -23,6 +24,12 @@ function toTagProp({ blogTagsListPath, tag, }) {
         unlisted: tag.unlisted,
     };
 }
+function toAuthorItemProp({ author, count, }) {
+    return {
+        ...author,
+        count,
+    };
+}
 function toBlogSidebarProp({ blogSidebarTitle, blogPosts, }) {
     return {
         title: blogSidebarTitle,

package/lib/routes.js

@@ -13,15 +13,21 @@ const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const utils_1 = require("@docusaurus/utils");
 const blogUtils_1 = require("./blogUtils");
 const props_1 = require("./props");
+const authors_1 = require("./authors");
 async function createAllRoutes(param) {
     const routes = await buildAllRoutes(param);
     routes.forEach(param.actions.addRoute);
 }
 async function buildAllRoutes({ baseUrl, content, actions, options, aliasedSource, }) {
-    const { blogListComponent, blogPostComponent, blogTagsListComponent, blogTagsPostsComponent, blogArchiveComponent, routeBasePath, archiveBasePath, blogTitle, } = options;
+    const { blogListComponent, blogPostComponent, blogTagsListComponent, blogAuthorsListComponent, blogAuthorsPostsComponent, blogTagsPostsComponent, blogArchiveComponent, routeBasePath, archiveBasePath, blogTitle, authorsBasePath, postsPerPage, blogDescription, } = options;
     const pluginId = options.id;
     const { createData } = actions;
-    const { blogSidebarTitle, blogPosts, blogListPaginated, blogTags, blogTagsListPath, } = content;
+    const { blogSidebarTitle, blogPosts, blogListPaginated, blogTags, blogTagsListPath, authorsMap, } = content;
+    const authorsListPath = (0, utils_1.normalizeUrl)([
+        baseUrl,
+        routeBasePath,
+        authorsBasePath,
+    ]);
     const listedBlogPosts = blogPosts.filter(blogUtils_1.shouldBeListed);
     const blogPostsById = lodash_1.default.keyBy(blogPosts, (post) => post.id);
     function getBlogPostById(id) {
@@ -46,6 +52,7 @@ async function buildAllRoutes({ baseUrl, content, actions, options, aliasedSourc
         const blogMetadata = {
             blogBasePath: (0, utils_1.normalizeUrl)([baseUrl, routeBasePath]),
             blogTitle,
+            authorsListPath,
         };
         const modulePath = await createData(`blogMetadata-${pluginId}.json`, blogMetadata);
         return aliasedSource(modulePath);
@@ -168,10 +175,76 @@ async function buildAllRoutes({ baseUrl, content, actions, options, aliasedSourc
         const tagsPaginatedRoutes = Object.values(blogTags).flatMap(createTagPaginatedRoutes);
         return [tagsListRoute, ...tagsPaginatedRoutes];
     }
+    function createAuthorsRoutes() {
+        if (authorsMap === undefined || Object.keys(authorsMap).length === 0) {
+            return [];
+        }
+        const blogPostsByAuthorKey = (0, authors_1.groupBlogPostsByAuthorKey)({
+            authorsMap,
+            blogPosts,
+        });
+        const authors = Object.values(authorsMap);
+        return [
+            createAuthorListRoute(),
+            ...authors.flatMap(createAuthorPaginatedRoute),
+        ];
+        function createAuthorListRoute() {
+            return {
+                path: authorsListPath,
+                component: blogAuthorsListComponent,
+                exact: true,
+                modules: {
+                    sidebar: sidebarModulePath,
+                },
+                props: {
+                    authors: authors.map((author) => (0, props_1.toAuthorItemProp)({
+                        author,
+                        count: blogPostsByAuthorKey[author.key]?.length ?? 0,
+                    })),
+                },
+                context: {
+                    blogMetadata: blogMetadataModulePath,
+                },
+            };
+        }
+        function createAuthorPaginatedRoute(author) {
+            const authorBlogPosts = blogPostsByAuthorKey[author.key] ?? [];
+            if (!author.page) {
+                return [];
+            }
+            const pages = (0, blogUtils_1.paginateBlogPosts)({
+                blogPosts: authorBlogPosts,
+                basePageUrl: author.page.permalink,
+                blogDescription,
+                blogTitle,
+                pageBasePath: authorsBasePath,
+                postsPerPageOption: postsPerPage,
+            });
+            return pages.map(({ metadata, items }) => {
+                return {
+                    path: metadata.permalink,
+                    component: blogAuthorsPostsComponent,
+                    exact: true,
+                    modules: {
+                        items: blogPostItemsModule(items),
+                        sidebar: sidebarModulePath,
+                    },
+                    props: {
+                        author: (0, props_1.toAuthorItemProp)({ author, count: authorBlogPosts.length }),
+                        listMetadata: metadata,
+                    },
+                    context: {
+                        blogMetadata: blogMetadataModulePath,
+                    },
+                };
+            });
+        }
+    }
     return [
         ...createBlogPostRoutes(),
         ...createBlogPostsPaginatedRoutes(),
         ...createTagsRoutes(),
         ...createArchiveRoute(),
+        ...createAuthorsRoutes(),
     ];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/plugin-content-blog",
-  "version": "0.0.0-6012",
+  "version": "0.0.0-6016",
   "description": "Blog plugin for Docusaurus.",
   "main": "lib/index.js",
   "types": "src/plugin-content-blog.d.ts",
@@ -31,14 +31,14 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/core": "0.0.0-6012",
-    "@docusaurus/logger": "0.0.0-6012",
-    "@docusaurus/mdx-loader": "0.0.0-6012",
-    "@docusaurus/theme-common": "0.0.0-6012",
-    "@docusaurus/types": "0.0.0-6012",
-    "@docusaurus/utils": "0.0.0-6012",
-    "@docusaurus/utils-common": "0.0.0-6012",
-    "@docusaurus/utils-validation": "0.0.0-6012",
+    "@docusaurus/core": "0.0.0-6016",
+    "@docusaurus/logger": "0.0.0-6016",
+    "@docusaurus/mdx-loader": "0.0.0-6016",
+    "@docusaurus/theme-common": "0.0.0-6016",
+    "@docusaurus/types": "0.0.0-6016",
+    "@docusaurus/utils": "0.0.0-6016",
+    "@docusaurus/utils-common": "0.0.0-6016",
+    "@docusaurus/utils-validation": "0.0.0-6016",
     "cheerio": "^1.0.0-rc.12",
     "feed": "^4.2.2",
     "fs-extra": "^11.1.1",
@@ -59,7 +59,8 @@
     "node": ">=18.0"
   },
   "devDependencies": {
-    "@total-typescript/shoehorn": "^0.1.2"
+    "@total-typescript/shoehorn": "^0.1.2",
+    "tree-node-cli": "^1.6.0"
   },
-  "gitHead": "052fdffd244b09f6cdfba0e03511170037da5681"
+  "gitHead": "c51435db0c58b94667da1c745f1635de65240c63"
 }