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

package/lib/authors.d.ts

@@ -4,20 +4,19 @@
  * 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 { Author, BlogPostFrontMatter } from '@docusaurus/plugin-content-blog';
-export type AuthorsMap = {
-    [authorKey: string]: Author;
-};
-export declare function validateAuthorsMap(content: unknown): AuthorsMap;
-export declare function getAuthorsMap(params: {
-    authorsMapPath: string;
-    contentPaths: BlogContentPaths;
-}): Promise<AuthorsMap | undefined>;
+import type { Author, AuthorsMap, BlogPost, BlogPostFrontMatter } from '@docusaurus/plugin-content-blog';
 type AuthorsParam = {
     frontMatter: BlogPostFrontMatter;
     authorsMap: AuthorsMap | undefined;
     baseUrl: string;
 };
 export declare function getBlogPostAuthors(params: AuthorsParam): Author[];
+/**
+ * Group blog posts by author key
+ * Blog posts with only inline authors are ignored
+ */
+export declare function groupBlogPostsByAuthorKey({ blogPosts, authorsMap, }: {
+    blogPosts: BlogPost[];
+    authorsMap: AuthorsMap | undefined;
+}): Record<string, BlogPost[]>;
 export {};

package/lib/authors.js

@@ -6,60 +6,11 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateAuthorsMap = validateAuthorsMap;
-exports.getAuthorsMap = getAuthorsMap;
 exports.getBlogPostAuthors = getBlogPostAuthors;
+exports.groupBlogPostsByAuthorKey = groupBlogPostsByAuthorKey;
 const tslib_1 = require("tslib");
-const _ = tslib_1.__importStar(require("lodash"));
+const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const utils_1 = require("@docusaurus/utils");
-const utils_validation_1 = require("@docusaurus/utils-validation");
-const authorsSocials_1 = require("./authorsSocials");
-const AuthorsMapSchema = utils_validation_1.Joi.object()
-    .pattern(utils_validation_1.Joi.string(), utils_validation_1.Joi.object({
-    name: utils_validation_1.Joi.string(),
-    url: utils_validation_1.URISchema,
-    imageURL: utils_validation_1.URISchema,
-    title: utils_validation_1.Joi.string(),
-    email: utils_validation_1.Joi.string(),
-    socials: authorsSocials_1.AuthorSocialsSchema,
-})
-    .rename('image_url', 'imageURL')
-    .or('name', 'imageURL')
-    .unknown()
-    .required()
-    .messages({
-    'object.base': '{#label} should be an author object containing properties like name, title, and imageURL.',
-    'any.required': '{#label} cannot be undefined. It should be an author object containing properties like name, title, and imageURL.',
-}))
-    .messages({
-    'object.base': "The authors map file should contain an object where each entry contains an author key and the corresponding author's data.",
-});
-function validateAuthorsMap(content) {
-    const { error, value } = AuthorsMapSchema.validate(content);
-    if (error) {
-        throw error;
-    }
-    return value;
-}
-function normalizeAuthor(author) {
-    return {
-        ...author,
-        socials: author.socials ? (0, authorsSocials_1.normalizeSocials)(author.socials) : undefined,
-    };
-}
-function normalizeAuthorsMap(authorsMap) {
-    return _.mapValues(authorsMap, normalizeAuthor);
-}
-async function getAuthorsMap(params) {
-    const authorsMap = await (0, utils_1.getDataFileData)({
-        filePath: params.authorsMapPath,
-        contentPaths: params.contentPaths,
-        fileType: 'authors map',
-    }, 
-    // TODO annoying to test: tightly coupled FS reads + validation...
-    validateAuthorsMap);
-    return authorsMap ? normalizeAuthorsMap(authorsMap) : undefined;
-}
 function normalizeImageUrl({ imageURL, baseUrl, }) {
     return imageURL?.startsWith('/')
         ? (0, utils_1.normalizeUrl)([baseUrl, imageURL])
@@ -67,6 +18,7 @@ function normalizeImageUrl({ imageURL, baseUrl, }) {
 }
 // Legacy v1/early-v2 front matter fields
 // We may want to deprecate those in favor of using only frontMatter.authors
+// TODO Docusaurus v4: remove this legacy front matter
 function getFrontMatterAuthorLegacy({ baseUrl, frontMatter, }) {
     const name = frontMatter.author;
     const title = frontMatter.author_title ?? frontMatter.authorTitle;
@@ -81,27 +33,33 @@ function getFrontMatterAuthorLegacy({ baseUrl, frontMatter, }) {
             title,
             url,
             imageURL,
+            // legacy front matter authors do not have an author key/page
+            key: null,
+            page: null,
         };
     }
     return undefined;
 }
-function normalizeFrontMatterAuthors(frontMatterAuthors = []) {
-    function normalizeFrontMatterAuthor(authorInput) {
-        if (typeof authorInput === 'string') {
-            // Technically, we could allow users to provide an author's name here, but
-            // we only support keys, otherwise, a typo in a key would fallback to
-            // becoming a name and may end up unnoticed
-            return { key: authorInput };
+function getFrontMatterAuthors(params) {
+    const { authorsMap, frontMatter, baseUrl } = params;
+    return normalizeFrontMatterAuthors().map(toAuthor);
+    function normalizeFrontMatterAuthors() {
+        if (frontMatter.authors === undefined) {
+            return [];
+        }
+        function normalizeAuthor(authorInput) {
+            if (typeof authorInput === 'string') {
+                // We could allow users to provide an author's name here, but we only
+                // support keys, otherwise, a typo in a key would fall back to
+                // becoming a name and may end up unnoticed
+                return { key: authorInput };
+            }
+            return authorInput;
         }
-        return authorInput;
+        return Array.isArray(frontMatter.authors)
+            ? frontMatter.authors.map(normalizeAuthor)
+            : [normalizeAuthor(frontMatter.authors)];
     }
-    return Array.isArray(frontMatterAuthors)
-        ? frontMatterAuthors.map(normalizeFrontMatterAuthor)
-        : [normalizeFrontMatterAuthor(frontMatterAuthors)];
-}
-function getFrontMatterAuthors(params) {
-    const { authorsMap } = params;
-    const frontMatterAuthors = normalizeFrontMatterAuthors(params.frontMatter.authors);
     function getAuthorsMapAuthor(key) {
         if (key) {
             if (!authorsMap || Object.keys(authorsMap).length === 0) {
@@ -121,32 +79,37 @@ ${Object.keys(authorsMap)
         return undefined;
     }
     function toAuthor(frontMatterAuthor) {
-        return normalizeAuthor({
+        const author = {
             // Author def from authorsMap can be locally overridden by front matter
             ...getAuthorsMapAuthor(frontMatterAuthor.key),
             ...frontMatterAuthor,
-        });
+        };
+        return {
+            ...author,
+            key: author.key ?? null,
+            page: author.page ?? null,
+            imageURL: normalizeImageUrl({ imageURL: author.imageURL, baseUrl }),
+        };
     }
-    return frontMatterAuthors.map(toAuthor);
-}
-function fixAuthorImageBaseURL(authors, { baseUrl }) {
-    return authors.map((author) => ({
-        ...author,
-        imageURL: normalizeImageUrl({ imageURL: author.imageURL, baseUrl }),
-    }));
 }
 function getBlogPostAuthors(params) {
     const authorLegacy = getFrontMatterAuthorLegacy(params);
     const authors = getFrontMatterAuthors(params);
-    const updatedAuthors = fixAuthorImageBaseURL(authors, params);
     if (authorLegacy) {
         // Technically, we could allow mixing legacy/authors front matter, but do we
         // really want to?
-        if (updatedAuthors.length > 0) {
+        if (authors.length > 0) {
             throw new Error(`To declare blog post authors, use the 'authors' front matter in priority.
 Don't mix 'authors' with other existing 'author_*' front matter. Choose one or the other, not both at the same time.`);
         }
         return [authorLegacy];
     }
-    return updatedAuthors;
+    return authors;
+}
+/**
+ * Group blog posts by author key
+ * Blog posts with only inline authors are ignored
+ */
+function groupBlogPostsByAuthorKey({ blogPosts, authorsMap, }) {
+    return lodash_1.default.mapValues(authorsMap, (author, key) => blogPosts.filter((p) => p.metadata.authors.some((a) => a.key === key)));
 }

package/lib/authorsMap.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * 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 { AuthorAttributes, AuthorPage, AuthorsMap } from '@docusaurus/plugin-content-blog';
+type AuthorInput = AuthorAttributes & {
+    page?: boolean | AuthorPage;
+};
+export type AuthorsMapInput = {
+    [authorKey: string]: AuthorInput;
+};
+export declare function checkAuthorsMapPermalinkCollisions(authorsMap: AuthorsMap | undefined): void;
+export declare function validateAuthorsMapInput(content: unknown): AuthorsMapInput;
+export declare function getAuthorsMap(params: {
+    authorsMapPath: string;
+    authorsBaseRoutePath: string;
+    contentPaths: BlogContentPaths;
+}): Promise<AuthorsMap | undefined>;
+export declare function validateAuthorsMap(content: unknown): AuthorsMapInput;
+export {};

package/lib/authorsMap.js

@@ -0,0 +1,116 @@
+"use strict";
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkAuthorsMapPermalinkCollisions = checkAuthorsMapPermalinkCollisions;
+exports.validateAuthorsMapInput = validateAuthorsMapInput;
+exports.getAuthorsMap = getAuthorsMap;
+exports.validateAuthorsMap = validateAuthorsMap;
+const tslib_1 = require("tslib");
+const lodash_1 = tslib_1.__importDefault(require("lodash"));
+const utils_1 = require("@docusaurus/utils");
+const utils_validation_1 = require("@docusaurus/utils-validation");
+const authorsSocials_1 = require("./authorsSocials");
+const AuthorPageSchema = utils_validation_1.Joi.object({
+    permalink: utils_validation_1.Joi.string().required(),
+});
+const AuthorsMapInputSchema = utils_validation_1.Joi.object()
+    .pattern(utils_validation_1.Joi.string(), utils_validation_1.Joi.object({
+    name: utils_validation_1.Joi.string(),
+    url: utils_validation_1.URISchema,
+    imageURL: utils_validation_1.URISchema,
+    title: utils_validation_1.Joi.string(),
+    email: utils_validation_1.Joi.string(),
+    page: utils_validation_1.Joi.alternatives(utils_validation_1.Joi.bool(), AuthorPageSchema),
+    socials: authorsSocials_1.AuthorSocialsSchema,
+    description: utils_validation_1.Joi.string(),
+})
+    .rename('image_url', 'imageURL')
+    .or('name', 'imageURL')
+    .unknown()
+    .required()
+    .messages({
+    'object.base': '{#label} should be an author object containing properties like name, title, and imageURL.',
+    'any.required': '{#label} cannot be undefined. It should be an author object containing properties like name, title, and imageURL.',
+}))
+    .messages({
+    'object.base': "The authors map file should contain an object where each entry contains an author key and the corresponding author's data.",
+});
+function checkAuthorsMapPermalinkCollisions(authorsMap) {
+    if (!authorsMap) {
+        return;
+    }
+    const permalinkCounts = (0, lodash_1.default)(authorsMap)
+        // Filter to keep only authors with a page
+        .pickBy((author) => !!author.page)
+        // Group authors by their permalink
+        .groupBy((author) => author.page?.permalink)
+        // Filter to keep only permalinks with more than one author
+        .pickBy((authors) => authors.length > 1)
+        // Transform the object into an array of [permalink, authors] pairs
+        .toPairs()
+        .value();
+    if (permalinkCounts.length > 0) {
+        const errorMessage = permalinkCounts
+            .map(([permalink, authors]) => `Permalink: ${permalink}\nAuthors: ${authors
+            .map((author) => author.name || 'Unknown')
+            .join(', ')}`)
+            .join('\n');
+        throw new Error(`The following permalinks are duplicated:\n${errorMessage}`);
+    }
+}
+function normalizeAuthor({ authorsBaseRoutePath, authorKey, author, }) {
+    function getAuthorPage() {
+        if (!author.page) {
+            return null;
+        }
+        const slug = author.page === true ? lodash_1.default.kebabCase(authorKey) : author.page.permalink;
+        return {
+            permalink: (0, utils_1.normalizeUrl)([authorsBaseRoutePath, slug]),
+        };
+    }
+    return {
+        ...author,
+        key: authorKey,
+        page: getAuthorPage(),
+        socials: author.socials ? (0, authorsSocials_1.normalizeSocials)(author.socials) : undefined,
+    };
+}
+function normalizeAuthorsMap({ authorsBaseRoutePath, authorsMapInput, }) {
+    return lodash_1.default.mapValues(authorsMapInput, (author, authorKey) => {
+        return normalizeAuthor({ authorsBaseRoutePath, authorKey, author });
+    });
+}
+function validateAuthorsMapInput(content) {
+    const { error, value } = AuthorsMapInputSchema.validate(content);
+    if (error) {
+        throw error;
+    }
+    return value;
+}
+async function getAuthorsMapInput(params) {
+    const content = await (0, utils_1.readDataFile)({
+        filePath: params.authorsMapPath,
+        contentPaths: params.contentPaths,
+    });
+    return content ? validateAuthorsMapInput(content) : undefined;
+}
+async function getAuthorsMap(params) {
+    const authorsMapInput = await getAuthorsMapInput(params);
+    if (!authorsMapInput) {
+        return undefined;
+    }
+    const authorsMap = normalizeAuthorsMap({ authorsMapInput, ...params });
+    return authorsMap;
+}
+function validateAuthorsMap(content) {
+    const { error, value } = AuthorsMapInputSchema.validate(content);
+    if (error) {
+        throw error;
+    }
+    return value;
+}

package/lib/blogUtils.d.ts

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { LoadContext } from '@docusaurus/types';
-import type { PluginOptions, BlogPost, BlogTags, BlogPaginated } from '@docusaurus/plugin-content-blog';
+import type { AuthorsMap, PluginOptions, BlogPost, BlogTags, BlogPaginated } from '@docusaurus/plugin-content-blog';
 import type { BlogContentPaths } from './types';
 export declare function truncate(fileString: string, truncateMarker: RegExp): string;
 export declare function paginateBlogPosts({ blogPosts, basePageUrl, blogTitle, blogDescription, postsPerPageOption, pageBasePath, }: {
@@ -30,7 +30,7 @@ type ParsedBlogFileName = {
     slug: string;
 };
 export declare function parseBlogFileName(blogSourceRelative: string): ParsedBlogFileName;
-export declare function generateBlogPosts(contentPaths: BlogContentPaths, context: LoadContext, options: PluginOptions): Promise<BlogPost[]>;
+export declare function generateBlogPosts(contentPaths: BlogContentPaths, context: LoadContext, options: PluginOptions, authorsMap?: AuthorsMap): Promise<BlogPost[]>;
 export declare function applyProcessBlogPosts({ blogPosts, processBlogPosts, }: {
     blogPosts: BlogPost[];
     processBlogPosts: PluginOptions['processBlogPosts'];

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/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 }) {

package/lib/options.js

@@ -22,6 +22,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,6 +48,7 @@ exports.DEFAULT_OPTIONS = {
     processBlogPosts: async () => undefined,
     onInlineTags: 'warn',
     tags: undefined,
+    authorsBasePath: 'authors',
     onInlineAuthors: 'warn',
 };
 const PluginOptionSchema = utils_validation_1.Joi.object({
@@ -65,6 +68,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()
@@ -124,6 +129,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-6014",
   "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-6014",
+    "@docusaurus/logger": "0.0.0-6014",
+    "@docusaurus/mdx-loader": "0.0.0-6014",
+    "@docusaurus/theme-common": "0.0.0-6014",
+    "@docusaurus/types": "0.0.0-6014",
+    "@docusaurus/utils": "0.0.0-6014",
+    "@docusaurus/utils-common": "0.0.0-6014",
+    "@docusaurus/utils-validation": "0.0.0-6014",
     "cheerio": "^1.0.0-rc.12",
     "feed": "^4.2.2",
     "fs-extra": "^11.1.1",
@@ -61,5 +61,5 @@
   "devDependencies": {
     "@total-typescript/shoehorn": "^0.1.2"
   },
-  "gitHead": "052fdffd244b09f6cdfba0e03511170037da5681"
+  "gitHead": "77581424d709d71c35dface5df45925e2851c2c8"
 }