@docusaurus/plugin-content-blog 2.4.1 → 3.0.0-beta.0

package/.docusaurus/routesChunkNames.json

@@ -0,0 +1,194 @@
+{
+  "/blog-only/2018/12/14/Happy-First-Birthday-Slash-b2d": {
+    "__comp": "ccc49370",
+    "__context": {
+      "plugin": "1a450a71"
+    },
+    "sidebar": "814f3328",
+    "content": "d1e647af"
+  },
+  "/blog-only/archive-111": {
+    "__comp": "9e4087bc",
+    "__context": {
+      "plugin": "1a450a71"
+    },
+    "archive": "8941cadf"
+  },
+  "/blog-only/blog-with-links-b8a": {
+    "__comp": "ccc49370",
+    "__context": {
+      "plugin": "1a450a71"
+    },
+    "sidebar": "814f3328",
+    "content": "fe567c9f"
+  },
+  "/blog-only/date-matter-e95": {
+    "__comp": "ccc49370",
+    "__context": {
+      "plugin": "1a450a71"
+    },
+    "sidebar": "814f3328",
+    "content": "1910f98c"
+  },
+  "/blog-only/heading-as-title-01d": {
+    "__comp": "ccc49370",
+    "__context": {
+      "plugin": "1a450a71"
+    },
+    "sidebar": "814f3328",
+    "content": "10c8a0c7"
+  },
+  "/blog-only/hey/my super path/héllô-71d": {
+    "__comp": "ccc49370",
+    "__context": {
+      "plugin": "1a450a71"
+    },
+    "sidebar": "814f3328",
+    "content": "31456d57"
+  },
+  "/blog-only/mdx-blog-post-72e": {
+    "__comp": "ccc49370",
+    "__context": {
+      "plugin": "1a450a71"
+    },
+    "sidebar": "814f3328",
+    "content": "025bf2bf"
+  },
+  "/blog-only/mdx-require-blog-post-d01": {
+    "__comp": "ccc49370",
+    "__context": {
+      "plugin": "1a450a71"
+    },
+    "sidebar": "814f3328",
+    "content": "4baa0397"
+  },
+  "/blog-only/page/2-0a4": {
+    "__comp": "a6aa9e1f",
+    "__context": {
+      "plugin": "1a450a71"
+    },
+    "sidebar": "814f3328",
+    "items": [
+      {
+        "content": "8f113c1e"
+      },
+      {
+        "content": "2d0e482b"
+      },
+      {
+        "content": "fa937875"
+      }
+    ],
+    "metadata": "3401dd63"
+  },
+  "/blog-only/page/3-070": {
+    "__comp": "a6aa9e1f",
+    "__context": {
+      "plugin": "1a450a71"
+    },
+    "sidebar": "814f3328",
+    "items": [
+      {
+        "content": "7050df0f"
+      },
+      {
+        "content": "69ddce25"
+      }
+    ],
+    "metadata": "84412660"
+  },
+  "/blog-only/search-043": {
+    "__comp": "1a4e3797",
+    "__context": {
+      "plugin": "90fdef38"
+    }
+  },
+  "/blog-only/simple/slug-ff5": {
+    "__comp": "ccc49370",
+    "__context": {
+      "plugin": "1a450a71"
+    },
+    "sidebar": "814f3328",
+    "content": "324f81e8"
+  },
+  "/blog-only/tags-821": {
+    "__comp": "01a85c17",
+    "__context": {
+      "plugin": "1a450a71"
+    },
+    "sidebar": "814f3328",
+    "tags": "6fa419d5"
+  },
+  "/blog-only/tags/birthday-8e4": {
+    "__comp": "6875c492",
+    "__context": {
+      "plugin": "1a450a71"
+    },
+    "sidebar": "814f3328",
+    "items": [
+      {
+        "content": "69ddce25"
+      }
+    ],
+    "tag": "0cc99ed5",
+    "listMetadata": "44bf5914"
+  },
+  "/blog-only/tags/complex-f0f": {
+    "__comp": "6875c492",
+    "__context": {
+      "plugin": "1a450a71"
+    },
+    "sidebar": "814f3328",
+    "items": [
+      {
+        "content": "8f113c1e"
+      }
+    ],
+    "tag": "1b99ff01",
+    "listMetadata": "b5733902"
+  },
+  "/blog-only/tags/date-b36": {
+    "__comp": "6875c492",
+    "__context": {
+      "plugin": "1a450a71"
+    },
+    "sidebar": "814f3328",
+    "items": [
+      {
+        "content": "8f113c1e"
+      },
+      {
+        "content": "7050df0f"
+      }
+    ],
+    "tag": "59ce4a4b",
+    "listMetadata": "447a0fe3"
+  },
+  "/blog-only/unlisted-8d8": {
+    "__comp": "ccc49370",
+    "__context": {
+      "plugin": "1a450a71"
+    },
+    "sidebar": "814f3328",
+    "content": "5cb65b8e"
+  },
+  "/blog-only/-813": {
+    "__comp": "a6aa9e1f",
+    "__context": {
+      "plugin": "1a450a71"
+    },
+    "sidebar": "814f3328",
+    "items": [
+      {
+        "content": "6dea708c"
+      },
+      {
+        "content": "5bd9aa47"
+      },
+      {
+        "content": "3cdbedcf"
+      }
+    ],
+    "metadata": "163f190c"
+  }
+}

package/.docusaurus/site-metadata.json

@@ -0,0 +1,24 @@
+{
+  "docusaurusVersion": "3.0.0-alpha.0",
+  "siteVersion": "3.0.0-alpha.0",
+  "pluginVersions": {
+    "docusaurus-plugin-content-blog": {
+      "type": "project"
+    },
+    "docusaurus-plugin-sitemap": {
+      "type": "package",
+      "name": "@docusaurus/plugin-sitemap",
+      "version": "3.0.0-alpha.0"
+    },
+    "docusaurus-theme-classic": {
+      "type": "package",
+      "name": "@docusaurus/theme-classic",
+      "version": "3.0.0-alpha.0"
+    },
+    "docusaurus-theme-search-algolia": {
+      "type": "package",
+      "name": "@docusaurus/theme-search-algolia",
+      "version": "3.0.0-alpha.0"
+    }
+  }
+}

package/lib/authors.d.ts

@@ -6,7 +6,7 @@
  */
 import type { BlogContentPaths } from './types';
 import type { Author, BlogPostFrontMatter } from '@docusaurus/plugin-content-blog';
-export declare type AuthorsMap = {
+export type AuthorsMap = {
     [authorKey: string]: Author;
 };
 export declare function validateAuthorsMap(content: unknown): AuthorsMap;
@@ -14,7 +14,7 @@ export declare function getAuthorsMap(params: {
     authorsMapPath: string;
     contentPaths: BlogContentPaths;
 }): Promise<AuthorsMap | undefined>;
-declare type AuthorsParam = {
+type AuthorsParam = {
     frontMatter: BlogPostFrontMatter;
     authorsMap: AuthorsMap | undefined;
 };

package/lib/blogUtils.d.ts

@@ -18,20 +18,21 @@ export declare function paginateBlogPosts({ blogPosts, basePageUrl, blogTitle, b
     blogDescription: string;
     postsPerPageOption: number | 'ALL';
 }): BlogPaginated[];
+export declare function shouldBeListed(blogPost: BlogPost): boolean;
 export declare function getBlogTags({ blogPosts, ...params }: {
     blogPosts: BlogPost[];
     blogTitle: string;
     blogDescription: string;
     postsPerPageOption: number | 'ALL';
 }): BlogTags;
-declare type ParsedBlogFileName = {
+type ParsedBlogFileName = {
     date: Date | undefined;
     text: string;
     slug: string;
 };
 export declare function parseBlogFileName(blogSourceRelative: string): ParsedBlogFileName;
 export declare function generateBlogPosts(contentPaths: BlogContentPaths, context: LoadContext, options: PluginOptions): Promise<BlogPost[]>;
-export declare type LinkifyParams = {
+export type LinkifyParams = {
     filePath: string;
     fileString: string;
 } & Pick<BlogMarkdownLoaderOptions, 'sourceToPermalink' | 'siteDir' | 'contentPaths' | 'onBrokenMarkdownLink'>;

package/lib/blogUtils.js

@@ -6,7 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.linkify = exports.generateBlogPosts = exports.parseBlogFileName = exports.getBlogTags = exports.paginateBlogPosts = exports.getSourceToPermalink = exports.truncate = void 0;
+exports.linkify = exports.generateBlogPosts = exports.parseBlogFileName = exports.getBlogTags = exports.shouldBeListed = exports.paginateBlogPosts = exports.getSourceToPermalink = exports.truncate = void 0;
 const tslib_1 = require("tslib");
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const path_1 = tslib_1.__importDefault(require("path"));
@@ -55,18 +55,29 @@ function paginateBlogPosts({ blogPosts, basePageUrl, blogTitle, blogDescription,
     return pages;
 }
 exports.paginateBlogPosts = paginateBlogPosts;
+function shouldBeListed(blogPost) {
+    return !blogPost.metadata.unlisted;
+}
+exports.shouldBeListed = shouldBeListed;
 function getBlogTags({ blogPosts, ...params }) {
     const groups = (0, utils_1.groupTaggedItems)(blogPosts, (blogPost) => blogPost.metadata.tags);
-    return lodash_1.default.mapValues(groups, ({ tag, items: tagBlogPosts }) => ({
-        label: tag.label,
-        items: tagBlogPosts.map((item) => item.id),
-        permalink: tag.permalink,
-        pages: paginateBlogPosts({
-            blogPosts: tagBlogPosts,
-            basePageUrl: tag.permalink,
-            ...params,
-        }),
-    }));
+    return lodash_1.default.mapValues(groups, ({ tag, items: tagBlogPosts }) => {
+        const tagVisibility = (0, utils_1.getTagVisibility)({
+            items: tagBlogPosts,
+            isUnlisted: (item) => item.metadata.unlisted,
+        });
+        return {
+            label: tag.label,
+            items: tagVisibility.listedItems.map((item) => item.id),
+            permalink: tag.permalink,
+            pages: paginateBlogPosts({
+                blogPosts: tagVisibility.listedItems,
+                basePageUrl: tag.permalink,
+                ...params,
+            }),
+            unlisted: tagVisibility.unlisted,
+        };
+    });
 }
 exports.getBlogTags = getBlogTags;
 const DATE_FILENAME_REGEX = /^(?<folder>.*)(?<date>\d{4}[-/]\d{1,2}[-/]\d{1,2})[-/]?(?<text>.*?)(?:\/index)?.mdx?$/;
@@ -125,7 +136,9 @@ async function processBlogSourceFile(blogSourceRelative, contentPaths, context,
     const blogSourceAbsolute = path_1.default.join(blogDirPath, blogSourceRelative);
     const { frontMatter, content, contentTitle, excerpt } = await parseBlogPostMarkdownFile(blogSourceAbsolute);
     const aliasedSource = (0, utils_1.aliasedSitePath)(blogSourceAbsolute, siteDir);
-    if (frontMatter.draft && process.env.NODE_ENV === 'production') {
+    const draft = (0, utils_1.isDraft)({ frontMatter });
+    const unlisted = (0, utils_1.isUnlisted)({ frontMatter });
+    if (draft) {
         return undefined;
     }
     if (frontMatter.id) {
@@ -213,6 +226,7 @@ async function processBlogSourceFile(blogSourceRelative, contentPaths, context,
             hasTruncateMarker: truncateMarker.test(content),
             authors,
             frontMatter,
+            unlisted,
         },
         content,
     };
@@ -230,15 +244,15 @@ async function generateBlogPosts(contentPaths, context, options) {
         contentPaths,
         authorsMapPath: options.authorsMapPath,
     });
-    const blogPosts = (await Promise.all(blogSourceFiles.map(async (blogSourceFile) => {
+    async function doProcessBlogSourceFile(blogSourceFile) {
         try {
             return await processBlogSourceFile(blogSourceFile, contentPaths, context, options, authorsMap);
         }
         catch (err) {
-            logger_1.default.error `Processing of blog source file path=${blogSourceFile} failed.`;
-            throw err;
+            throw new Error(`Processing of blog source file path=${blogSourceFile} failed.`, { cause: err });
         }
-    }))).filter(Boolean);
+    }
+    const blogPosts = (await Promise.all(blogSourceFiles.map(doProcessBlogSourceFile))).filter(Boolean);
     blogPosts.sort((a, b) => b.metadata.date.getTime() - a.metadata.date.getTime());
     if (options.sortPosts === 'ascending') {
         return blogPosts.reverse();

package/lib/feed.d.ts

@@ -6,7 +6,7 @@
  */
 import type { DocusaurusConfig } from '@docusaurus/types';
 import type { PluginOptions, BlogPost } from '@docusaurus/plugin-content-blog';
-export declare function createBlogFeedFiles({ blogPosts, options, siteConfig, outDir, locale, }: {
+export declare function createBlogFeedFiles({ blogPosts: allBlogPosts, options, siteConfig, outDir, locale, }: {
     blogPosts: BlogPost[];
     options: PluginOptions;
     siteConfig: DocusaurusConfig;

package/lib/feed.js

@@ -12,6 +12,7 @@ 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");
@@ -22,7 +23,10 @@ async function generateBlogFeed({ blogPosts, options, siteConfig, outDir, locale
     const { feedOptions, routeBasePath } = options;
     const { url: siteUrl, baseUrl, title, favicon } = siteConfig;
     const blogBaseUrl = (0, utils_1.normalizeUrl)([siteUrl, baseUrl, routeBasePath]);
-    const updated = blogPosts[0]?.metadata.date;
+    const blogPostsForFeed = feedOptions.limit === false || feedOptions.limit === null
+        ? blogPosts
+        : blogPosts.slice(0, feedOptions.limit);
+    const updated = blogPostsForFeed[0]?.metadata.date;
     const feed = new feed_1.Feed({
         id: blogBaseUrl,
         title: feedOptions.title ?? `${title} Blog`,
@@ -35,7 +39,7 @@ async function generateBlogFeed({ blogPosts, options, siteConfig, outDir, locale
     });
     const createFeedItems = options.feedOptions.createFeedItems ?? defaultCreateFeedItems;
     const feedItems = await createFeedItems({
-        blogPosts,
+        blogPosts: blogPostsForFeed,
         siteConfig,
         outDir,
         defaultCreateFeedItems,
@@ -52,11 +56,34 @@ async function defaultCreateFeedItems({ blogPosts, siteConfig, outDir, }) {
         const { metadata: { title: metadataTitle, permalink, date, description, authors, tags, }, } = post;
         const content = await (0, utils_1.readOutputHTMLFile)(permalink.replace(siteConfig.baseUrl, ''), outDir, siteConfig.trailingSlash);
         const $ = (0, cheerio_1.load)(content);
-        const link = (0, utils_1.normalizeUrl)([siteUrl, permalink]);
+        const blogPostAbsoluteUrl = (0, utils_1.normalizeUrl)([siteUrl, permalink]);
+        const toAbsoluteUrl = (src) => String(new URL(src, blogPostAbsoluteUrl));
+        // Make links and image urls absolute
+        // See https://github.com/facebook/docusaurus/issues/9136
+        $(`div#${utils_common_1.blogPostContainerID} a, div#${utils_common_1.blogPostContainerID} img`).each((_, elm) => {
+            if (elm.tagName === 'a') {
+                const { href } = elm.attribs;
+                if (href) {
+                    elm.attribs.href = toAbsoluteUrl(href);
+                }
+            }
+            else if (elm.tagName === 'img') {
+                const { src, srcset: srcsetAttr } = elm.attribs;
+                if (src) {
+                    elm.attribs.src = toAbsoluteUrl(src);
+                }
+                if (srcsetAttr) {
+                    elm.attribs.srcset = srcset.stringify(srcset.parse(srcsetAttr).map((props) => ({
+                        ...props,
+                        url: toAbsoluteUrl(props.url),
+                    })));
+                }
+            }
+        });
         const feedItem = {
             title: metadataTitle,
-            id: link,
-            link,
+            id: blogPostAbsoluteUrl,
+            link: blogPostAbsoluteUrl,
             date,
             description,
             // Atom feed demands the "term", while other feeds use "name"
@@ -93,7 +120,13 @@ async function createBlogFeedFile({ feed, feedType, generatePath, }) {
         throw err;
     }
 }
-async function createBlogFeedFiles({ blogPosts, options, siteConfig, outDir, locale, }) {
+function shouldBeInFeed(blogPost) {
+    const excluded = blogPost.metadata.frontMatter.draft ||
+        blogPost.metadata.frontMatter.unlisted;
+    return !excluded;
+}
+async function createBlogFeedFiles({ blogPosts: allBlogPosts, options, siteConfig, outDir, locale, }) {
+    const blogPosts = allBlogPosts.filter(shouldBeInFeed);
     const feed = await generateBlogFeed({
         blogPosts,
         options,

package/lib/frontMatter.js

@@ -23,7 +23,6 @@ const BlogFrontMatterSchema = utils_validation_1.JoiFrontMatter.object({
     title: utils_validation_1.JoiFrontMatter.string().allow(''),
     description: utils_validation_1.JoiFrontMatter.string().allow(''),
     tags: utils_validation_1.FrontMatterTagsSchema,
-    draft: utils_validation_1.JoiFrontMatter.boolean(),
     date: utils_validation_1.JoiFrontMatter.date().raw(),
     // New multi-authors front matter:
     authors: utils_validation_1.JoiFrontMatter.alternatives()
@@ -53,9 +52,11 @@ const BlogFrontMatterSchema = utils_validation_1.JoiFrontMatter.object({
     keywords: utils_validation_1.JoiFrontMatter.array().items(utils_validation_1.JoiFrontMatter.string().required()),
     hide_table_of_contents: utils_validation_1.JoiFrontMatter.boolean(),
     ...utils_validation_1.FrontMatterTOCHeadingLevels,
-}).messages({
+})
+    .messages({
     'deprecate.error': '{#label} blog frontMatter field is deprecated. Please use {#alternative} instead.',
-});
+})
+    .concat(utils_validation_1.ContentVisibilitySchema);
 function validateBlogPostFrontMatter(frontMatter) {
     return (0, utils_validation_1.validateFrontMatter)(frontMatter, BlogFrontMatterSchema);
 }

package/lib/index.js

@@ -15,6 +15,7 @@ const blogUtils_1 = require("./blogUtils");
 const footnoteIDFixer_1 = tslib_1.__importDefault(require("./remark/footnoteIDFixer"));
 const translations_1 = require("./translations");
 const feed_1 = require("./feed");
+const props_1 = require("./props");
 async function pluginContentBlog(context, options) {
     const { siteDir, siteConfig, generatedFilesDir, localizationDir, i18n: { currentLocale }, } = context;
     const { onBrokenMarkdownLinks, baseUrl } = siteConfig;
@@ -50,6 +51,7 @@ async function pluginContentBlog(context, options) {
             const baseBlogUrl = (0, utils_1.normalizeUrl)([baseUrl, routeBasePath]);
             const blogTagsListPath = (0, utils_1.normalizeUrl)([baseBlogUrl, tagsBasePath]);
             const blogPosts = await (0, blogUtils_1.generateBlogPosts)(contentPaths, context, options);
+            const listedBlogPosts = blogPosts.filter(blogUtils_1.shouldBeListed);
             if (!blogPosts.length) {
                 return {
                     blogSidebarTitle,
@@ -61,15 +63,17 @@ async function pluginContentBlog(context, options) {
                 };
             }
             // Colocate next and prev metadata.
-            blogPosts.forEach((blogPost, index) => {
-                const prevItem = index > 0 ? blogPosts[index - 1] : null;
+            listedBlogPosts.forEach((blogPost, index) => {
+                const prevItem = index > 0 ? listedBlogPosts[index - 1] : null;
                 if (prevItem) {
                     blogPost.metadata.prevItem = {
                         title: prevItem.metadata.title,
                         permalink: prevItem.metadata.permalink,
                     };
                 }
-                const nextItem = index < blogPosts.length - 1 ? blogPosts[index + 1] : null;
+                const nextItem = index < listedBlogPosts.length - 1
+                    ? listedBlogPosts[index + 1]
+                    : null;
                 if (nextItem) {
                     blogPost.metadata.nextItem = {
                         title: nextItem.metadata.title,
@@ -78,7 +82,7 @@ async function pluginContentBlog(context, options) {
                 }
             });
             const blogListPaginated = (0, blogUtils_1.paginateBlogPosts)({
-                blogPosts,
+                blogPosts: listedBlogPosts,
                 blogTitle,
                 blogDescription,
                 postsPerPageOption,
@@ -146,6 +150,7 @@ async function pluginContentBlog(context, options) {
                 items: sidebarBlogPosts.map((blogPost) => ({
                     title: blogPost.metadata.title,
                     permalink: blogPost.metadata.permalink,
+                    unlisted: blogPost.metadata.unlisted,
                 })),
             }, null, 2));
             // Create routes for blog entries.
@@ -187,12 +192,7 @@ async function pluginContentBlog(context, options) {
                 return;
             }
             async function createTagsListPage() {
-                const tagsProp = Object.values(blogTags).map((tag) => ({
-                    label: tag.label,
-                    permalink: tag.permalink,
-                    count: tag.items.length,
-                }));
-                const tagsPropPath = await createData(`${(0, utils_1.docuHash)(`${blogTagsListPath}-tags`)}.json`, JSON.stringify(tagsProp, null, 2));
+                const tagsPropPath = await createData(`${(0, utils_1.docuHash)(`${blogTagsListPath}-tags`)}.json`, JSON.stringify((0, props_1.toTagsProp)({ blogTags }), null, 2));
                 addRoute({
                     path: blogTagsListPath,
                     component: blogTagsListComponent,
@@ -206,13 +206,7 @@ async function pluginContentBlog(context, options) {
             async function createTagPostsListPage(tag) {
                 await Promise.all(tag.pages.map(async (blogPaginated) => {
                     const { metadata, items } = blogPaginated;
-                    const tagProp = {
-                        label: tag.label,
-                        permalink: tag.permalink,
-                        allTagsPath: blogTagsListPath,
-                        count: tag.items.length,
-                    };
-                    const tagPropPath = await createData(`${(0, utils_1.docuHash)(metadata.permalink)}.json`, JSON.stringify(tagProp, null, 2));
+                    const tagPropPath = await createData(`${(0, utils_1.docuHash)(metadata.permalink)}.json`, JSON.stringify((0, props_1.toTagProp)({ tag, blogTagsListPath }), null, 2));
                     const listMetadataPath = await createData(`${(0, utils_1.docuHash)(metadata.permalink)}-list.json`, JSON.stringify(metadata, null, 2));
                     addRoute({
                         path: metadata.permalink,
@@ -233,7 +227,7 @@ async function pluginContentBlog(context, options) {
         translateContent({ content, translationFiles }) {
             return (0, translations_1.translateContent)(content, translationFiles);
         },
-        configureWebpack(_config, isServer, { getJSLoader }, content) {
+        configureWebpack(_config, isServer, utils, content) {
             const { admonitions, rehypePlugins, remarkPlugins, truncateMarker, beforeDefaultRemarkPlugins, beforeDefaultRehypePlugins, } = options;
             const markdownLoaderOptions = {
                 siteDir,
@@ -262,7 +256,6 @@ async function pluginContentBlog(context, options) {
                                 // Trailing slash is important, see https://github.com/facebook/docusaurus/pull/3970
                                 .map(utils_1.addTrailingPathSeparator),
                             use: [
-                                getJSLoader({ isServer }),
                                 {
                                     loader: require.resolve('@docusaurus/mdx-loader'),
                                     options: {

package/lib/options.js

@@ -10,11 +10,11 @@ exports.validateOptions = exports.DEFAULT_OPTIONS = void 0;
 const utils_validation_1 = require("@docusaurus/utils-validation");
 const utils_1 = require("@docusaurus/utils");
 exports.DEFAULT_OPTIONS = {
-    feedOptions: { type: ['rss', 'atom'], copyright: '' },
+    feedOptions: { type: ['rss', 'atom'], copyright: '', limit: 20 },
     beforeDefaultRehypePlugins: [],
     beforeDefaultRemarkPlugins: [],
     admonitions: true,
-    truncateMarker: /<!--\s*truncate\s*-->/,
+    truncateMarker: /<!--\s*truncate\s*-->|\{\/\*\s*truncate\s*\*\/\}/,
     rehypePlugins: [],
     remarkPlugins: [],
     showReadingTime: true,
@@ -44,10 +44,7 @@ const PluginOptionSchema = utils_validation_1.Joi.object({
     archiveBasePath: utils_validation_1.Joi.string()
         .default(exports.DEFAULT_OPTIONS.archiveBasePath)
         .allow(null),
-    routeBasePath: utils_validation_1.Joi.string()
-        // '' not allowed, see https://github.com/facebook/docusaurus/issues/3374
-        // .allow('')
-        .default(exports.DEFAULT_OPTIONS.routeBasePath),
+    routeBasePath: utils_validation_1.RouteBasePathSchema.default(exports.DEFAULT_OPTIONS.routeBasePath),
     tagsBasePath: utils_validation_1.Joi.string().default(exports.DEFAULT_OPTIONS.tagsBasePath),
     include: utils_validation_1.Joi.array().items(utils_validation_1.Joi.string()).default(exports.DEFAULT_OPTIONS.include),
     exclude: utils_validation_1.Joi.array().items(utils_validation_1.Joi.string()).default(exports.DEFAULT_OPTIONS.exclude),
@@ -95,6 +92,9 @@ const PluginOptionSchema = utils_validation_1.Joi.object({
         }),
         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),
     authorsMapPath: utils_validation_1.Joi.string().default(exports.DEFAULT_OPTIONS.authorsMapPath),
     readingTime: utils_validation_1.Joi.function().default(() => exports.DEFAULT_OPTIONS.readingTime),

package/lib/props.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 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 { TagsListItem, TagModule } from '@docusaurus/utils';
+import type { BlogTag, BlogTags } from '@docusaurus/plugin-content-blog';
+export declare function toTagsProp({ blogTags }: {
+    blogTags: BlogTags;
+}): TagsListItem[];
+export declare function toTagProp({ blogTagsListPath, tag, }: {
+    blogTagsListPath: string;
+    tag: BlogTag;
+}): TagModule;

package/lib/props.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toTagProp = exports.toTagsProp = void 0;
+function toTagsProp({ blogTags }) {
+    return Object.values(blogTags)
+        .filter((tag) => !tag.unlisted)
+        .map((tag) => ({
+        label: tag.label,
+        permalink: tag.permalink,
+        count: tag.items.length,
+    }));
+}
+exports.toTagsProp = toTagsProp;
+function toTagProp({ blogTagsListPath, tag, }) {
+    return {
+        label: tag.label,
+        permalink: tag.permalink,
+        allTagsPath: blogTagsListPath,
+        count: tag.items.length,
+        unlisted: tag.unlisted,
+    };
+}
+exports.toTagProp = toTagProp;

package/lib/types.d.ts

@@ -5,9 +5,9 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { BrokenMarkdownLink, ContentPaths } from '@docusaurus/utils';
-export declare type BlogContentPaths = ContentPaths;
-export declare type BlogBrokenMarkdownLink = BrokenMarkdownLink<BlogContentPaths>;
-export declare type BlogMarkdownLoaderOptions = {
+export type BlogContentPaths = ContentPaths;
+export type BlogBrokenMarkdownLink = BrokenMarkdownLink<BlogContentPaths>;
+export type BlogMarkdownLoaderOptions = {
     siteDir: string;
     contentPaths: BlogContentPaths;
     truncateMarker: RegExp;