@docusaurus/plugin-content-blog 3.4.0 → 3.5.0

package/lib/feed.js

@@ -6,16 +6,17 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createFeedHtmlHeadTags = exports.createBlogFeedFiles = void 0;
+exports.createBlogFeedFiles = createBlogFeedFiles;
+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;
@@ -105,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) {
@@ -131,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,
@@ -148,9 +196,10 @@ async function createBlogFeedFiles({ blogPosts: allBlogPosts, options, siteConfi
         feed,
         feedType,
         generatePath: path_1.default.join(outDir, options.routeBasePath),
+        feedOptions: options.feedOptions,
+        contentPaths,
     })));
 }
-exports.createBlogFeedFiles = createBlogFeedFiles;
 function createFeedHtmlHeadTags({ context, options, }) {
     const feedTypes = options.feedOptions.type;
     if (!feedTypes) {
@@ -193,4 +242,3 @@ function createFeedHtmlHeadTags({ context, options, }) {
     });
     return headTags;
 }
-exports.createFeedHtmlHeadTags = createFeedHtmlHeadTags;

package/lib/frontMatter.d.ts

@@ -1,4 +1,3 @@
-/// <reference path="../src/plugin-content-blog.d.ts" />
 import type { BlogPostFrontMatter } from '@docusaurus/plugin-content-blog';
 export declare function validateBlogPostFrontMatter(frontMatter: {
     [key: string]: unknown;

package/lib/frontMatter.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateBlogPostFrontMatter = void 0;
+exports.validateBlogPostFrontMatter = validateBlogPostFrontMatter;
 /**
  * Copyright (c) Facebook, Inc. and its affiliates.
  *
@@ -8,12 +8,14 @@ exports.validateBlogPostFrontMatter = void 0;
  * LICENSE file in the root directory of this source tree.
  */
 const utils_validation_1 = require("@docusaurus/utils-validation");
+const authorsSocials_1 = require("./authorsSocials");
 const BlogPostFrontMatterAuthorSchema = utils_validation_1.JoiFrontMatter.object({
     key: utils_validation_1.JoiFrontMatter.string(),
     name: utils_validation_1.JoiFrontMatter.string(),
     title: utils_validation_1.JoiFrontMatter.string(),
     url: utils_validation_1.URISchema,
     imageURL: utils_validation_1.JoiFrontMatter.string(),
+    socials: authorsSocials_1.AuthorSocialsSchema,
 })
     .or('key', 'name', 'imageURL')
     .rename('image_url', 'imageURL', { alias: true });
@@ -61,4 +63,3 @@ const BlogFrontMatterSchema = utils_validation_1.JoiFrontMatter.object({
 function validateBlogPostFrontMatter(frontMatter) {
     return (0, utils_validation_1.validateFrontMatter)(frontMatter, BlogFrontMatterSchema);
 }
-exports.validateBlogPostFrontMatter = validateBlogPostFrontMatter;

package/lib/index.d.ts

@@ -4,7 +4,6 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../src/plugin-content-blog.d.ts" />
 import type { LoadContext, Plugin } from '@docusaurus/types';
 import type { PluginOptions, BlogContent } from '@docusaurus/plugin-content-blog';
 export default function pluginContentBlog(context: LoadContext, options: PluginOptions): Promise<Plugin<BlogContent>>;

package/lib/index.js

@@ -7,6 +7,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateOptions = void 0;
+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"));
@@ -17,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
@@ -87,14 +89,28 @@ 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,
             });
+            (0, blogUtils_1.reportUntruncatedBlogPosts)({
+                blogPosts,
+                onUntruncatedBlogPosts: options.onUntruncatedBlogPosts,
+            });
             const listedBlogPosts = blogPosts.filter(blogUtils_1.shouldBeListed);
             if (!blogPosts.length) {
                 return {
@@ -103,6 +119,7 @@ async function pluginContentBlog(context, options) {
                     blogListPaginated: [],
                     blogTags: {},
                     blogTagsListPath,
+                    authorsMap,
                 };
             }
             // Collocate next and prev metadata.
@@ -145,6 +162,7 @@ async function pluginContentBlog(context, options) {
                 blogListPaginated,
                 blogTags,
                 blogTagsListPath,
+                authorsMap,
             };
         },
         async contentLoaded({ content, actions }) {
@@ -161,13 +179,14 @@ async function pluginContentBlog(context, options) {
             return (0, translations_1.translateContent)(content, translationFiles);
         },
         configureWebpack() {
-            const { admonitions, rehypePlugins, remarkPlugins, truncateMarker, beforeDefaultRemarkPlugins, beforeDefaultRehypePlugins, } = options;
+            const { admonitions, rehypePlugins, remarkPlugins, recmaPlugins, truncateMarker, beforeDefaultRemarkPlugins, beforeDefaultRehypePlugins, } = options;
             const contentDirs = (0, utils_1.getContentPathList)(contentPaths);
             function createMDXLoader() {
                 const loaderOptions = {
                     admonitions,
                     remarkPlugins,
                     rehypePlugins,
+                    recmaPlugins,
                     beforeDefaultRemarkPlugins: [
                         footnoteIDFixer_1.default,
                         ...beforeDefaultRemarkPlugins,
@@ -251,6 +270,7 @@ async function pluginContentBlog(context, options) {
                 outDir,
                 siteConfig,
                 locale: currentLocale,
+                contentPaths,
             });
         },
         injectHtmlTags({ content }) {
@@ -263,6 +283,5 @@ async function pluginContentBlog(context, options) {
         },
     };
 }
-exports.default = pluginContentBlog;
 var options_1 = require("./options");
 Object.defineProperty(exports, "validateOptions", { enumerable: true, get: function () { return options_1.validateOptions; } });

package/lib/markdownLoader.js

@@ -6,6 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = markdownLoader;
 const blogUtils_1 = require("./blogUtils");
 function markdownLoader(source) {
     const fileString = source;
@@ -23,4 +24,3 @@ function markdownLoader(source) {
     }
     return callback(null, finalContent);
 }
-exports.default = markdownLoader;

package/lib/options.d.ts

@@ -4,8 +4,11 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../src/plugin-content-blog.d.ts" />
 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,20 +6,34 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateOptions = 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,
     truncateMarker: /<!--\s*truncate\s*-->|\{\/\*\s*truncate\s*\*\/\}/,
     rehypePlugins: [],
     remarkPlugins: [],
+    recmaPlugins: [],
     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',
@@ -44,7 +58,76 @@ exports.DEFAULT_OPTIONS = {
     processBlogPosts: async () => undefined,
     onInlineTags: 'warn',
     tags: undefined,
+    authorsBasePath: 'authors',
+    onInlineAuthors: 'warn',
+    onUntruncatedBlogPosts: '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()
@@ -62,6 +145,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()
@@ -74,35 +159,14 @@ const PluginOptionSchema = utils_validation_1.Joi.object({
     showReadingTime: utils_validation_1.Joi.bool().default(exports.DEFAULT_OPTIONS.showReadingTime),
     remarkPlugins: utils_validation_1.RemarkPluginsSchema.default(exports.DEFAULT_OPTIONS.remarkPlugins),
     rehypePlugins: utils_validation_1.RehypePluginsSchema.default(exports.DEFAULT_OPTIONS.rehypePlugins),
+    recmaPlugins: utils_validation_1.RecmaPluginsSchema.default(exports.DEFAULT_OPTIONS.recmaPlugins),
     admonitions: utils_validation_1.AdmonitionsSchema.default(exports.DEFAULT_OPTIONS.admonitions),
     editUrl: utils_validation_1.Joi.alternatives().try(utils_validation_1.URISchema, utils_validation_1.Joi.function()),
     editLocalizedFiles: utils_validation_1.Joi.boolean().default(exports.DEFAULT_OPTIONS.editLocalizedFiles),
     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()
@@ -120,9 +184,17 @@ 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),
+    onUntruncatedBlogPosts: utils_validation_1.Joi.string()
+        .equal('ignore', 'log', 'warn', 'throw')
+        .default(exports.DEFAULT_OPTIONS.onUntruncatedBlogPosts),
 }).default(exports.DEFAULT_OPTIONS);
 function validateOptions({ validate, options, }) {
     const validatedOptions = validate(PluginOptionSchema, options);
     return validatedOptions;
 }
-exports.validateOptions = validateOptions;

package/lib/props.d.ts

@@ -1,4 +1,3 @@
-/// <reference path="../src/plugin-content-blog.d.ts" />
 /**
  * Copyright (c) Facebook, Inc. and its affiliates.
  *
@@ -6,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { TagsListItem, TagModule } from '@docusaurus/utils';
-import type { 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[];
@@ -14,3 +13,11 @@ 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[];
+}): BlogSidebar;

package/lib/props.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toTagProp = exports.toTagsProp = void 0;
+exports.toTagsProp = toTagsProp;
+exports.toTagProp = toTagProp;
+exports.toAuthorItemProp = toAuthorItemProp;
+exports.toBlogSidebarProp = toBlogSidebarProp;
 function toTagsProp({ blogTags }) {
     return Object.values(blogTags)
         .filter((tag) => !tag.unlisted)
@@ -11,7 +14,6 @@ function toTagsProp({ blogTags }) {
         count: tag.items.length,
     }));
 }
-exports.toTagsProp = toTagsProp;
 function toTagProp({ blogTagsListPath, tag, }) {
     return {
         label: tag.label,
@@ -22,4 +24,20 @@ function toTagProp({ blogTagsListPath, tag, }) {
         unlisted: tag.unlisted,
     };
 }
-exports.toTagProp = toTagProp;
+function toAuthorItemProp({ author, count, }) {
+    return {
+        ...author,
+        count,
+    };
+}
+function toBlogSidebarProp({ blogSidebarTitle, blogPosts, }) {
+    return {
+        title: blogSidebarTitle,
+        items: blogPosts.map((blogPost) => ({
+            title: blogPost.metadata.title,
+            permalink: blogPost.metadata.permalink,
+            unlisted: blogPost.metadata.unlisted,
+            date: blogPost.metadata.date,
+        })),
+    };
+}

package/lib/remark/footnoteIDFixer.js

@@ -6,6 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = plugin;
 const utils_1 = require("@docusaurus/utils");
 /**
  * In the blog list view, each post will be compiled separately. However, they
@@ -25,4 +26,3 @@ function plugin() {
         });
     };
 }
-exports.default = plugin;

package/lib/routes.d.ts

@@ -4,7 +4,6 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../src/plugin-content-blog.d.ts" />
 import type { PluginContentLoadedActions, RouteConfig } from '@docusaurus/types';
 import type { BlogContent, PluginOptions } from '@docusaurus/plugin-content-blog';
 type CreateAllRoutesParam = {