@docusaurus/plugin-content-blog 2.0.0-beta.16 → 2.0.0-beta.19

package/lib/authors.d.ts

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

package/lib/authors.js

@@ -9,16 +9,25 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getBlogPostAuthors = exports.getAuthorsMap = exports.validateAuthorsMap = void 0;
 const utils_1 = require("@docusaurus/utils");
 const utils_validation_1 = require("@docusaurus/utils-validation");
-const AuthorsMapSchema = utils_validation_1.Joi.object().pattern(utils_validation_1.Joi.string(), utils_validation_1.Joi.object({
+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(),
 })
     .rename('image_url', 'imageURL')
     .or('name', 'imageURL')
     .unknown()
-    .required());
+    .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) {
     return utils_validation_1.Joi.attempt(content, AuthorsMapSchema);
 }
@@ -34,11 +43,10 @@ exports.getAuthorsMap = getAuthorsMap;
 // Legacy v1/early-v2 front matter fields
 // We may want to deprecate those in favor of using only frontMatter.authors
 function getFrontMatterAuthorLegacy(frontMatter) {
-    var _a, _b, _c;
     const name = frontMatter.author;
-    const title = (_a = frontMatter.author_title) !== null && _a !== void 0 ? _a : frontMatter.authorTitle;
-    const url = (_b = frontMatter.author_url) !== null && _b !== void 0 ? _b : frontMatter.authorURL;
-    const imageURL = (_c = frontMatter.author_image_url) !== null && _c !== void 0 ? _c : frontMatter.authorImageURL;
+    const title = frontMatter.author_title ?? frontMatter.authorTitle;
+    const url = frontMatter.author_url ?? frontMatter.authorURL;
+    const imageURL = frontMatter.author_image_url ?? frontMatter.authorImageURL;
     if (name || title || url || imageURL) {
         return {
             name,

package/lib/blogUtils.d.ts

@@ -4,11 +4,13 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import type { BlogPost, BlogContentPaths, BlogMarkdownLoaderOptions, BlogTags, BlogPaginated } from './types';
+import type { BlogContentPaths, BlogMarkdownLoaderOptions } from './types';
 import type { LoadContext } from '@docusaurus/types';
-import type { PluginOptions } from '@docusaurus/plugin-content-blog';
+import type { PluginOptions, BlogPost, BlogTags, BlogPaginated } from '@docusaurus/plugin-content-blog';
 export declare function truncate(fileString: string, truncateMarker: RegExp): string;
-export declare function getSourceToPermalink(blogPosts: BlogPost[]): Record<string, string>;
+export declare function getSourceToPermalink(blogPosts: BlogPost[]): {
+    [aliasedPath: string]: string;
+};
 export declare function paginateBlogPosts({ blogPosts, basePageUrl, blogTitle, blogDescription, postsPerPageOption, }: {
     blogPosts: BlogPost[];
     basePageUrl: string;

package/lib/blogUtils.js

@@ -8,14 +8,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.linkify = exports.generateBlogPosts = exports.parseBlogFileName = exports.getBlogTags = exports.paginateBlogPosts = exports.getSourceToPermalink = exports.truncate = void 0;
 const tslib_1 = require("tslib");
-const fs_extra_1 = (0, tslib_1.__importDefault)(require("fs-extra"));
-const path_1 = (0, tslib_1.__importDefault)(require("path"));
-const reading_time_1 = (0, tslib_1.__importDefault)(require("reading-time"));
-const lodash_1 = (0, tslib_1.__importDefault)(require("lodash"));
+const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+const path_1 = tslib_1.__importDefault(require("path"));
+const reading_time_1 = tslib_1.__importDefault(require("reading-time"));
+const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const utils_1 = require("@docusaurus/utils");
-const blogFrontMatter_1 = require("./blogFrontMatter");
+const frontMatter_1 = require("./frontMatter");
 const authors_1 = require("./authors");
-const logger_1 = (0, tslib_1.__importDefault)(require("@docusaurus/logger"));
+const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 function truncate(fileString, truncateMarker) {
     return fileString.split(truncateMarker, 1).shift();
 }
@@ -30,7 +30,9 @@ function paginateBlogPosts({ blogPosts, basePageUrl, blogTitle, blogDescription,
     const numberOfPages = Math.ceil(totalCount / postsPerPage);
     const pages = [];
     function permalink(page) {
-        return page > 0 ? `${basePageUrl}/page/${page + 1}` : basePageUrl;
+        return page > 0
+            ? (0, utils_1.normalizeUrl)([basePageUrl, `page/${page + 1}`])
+            : basePageUrl;
     }
     for (let page = 0; page < numberOfPages; page += 1) {
         pages.push({
@@ -43,8 +45,8 @@ function paginateBlogPosts({ blogPosts, basePageUrl, blogTitle, blogDescription,
                 postsPerPage,
                 totalPages: numberOfPages,
                 totalCount,
-                previousPage: page !== 0 ? permalink(page - 1) : null,
-                nextPage: page < numberOfPages - 1 ? permalink(page + 1) : null,
+                previousPage: page !== 0 ? permalink(page - 1) : undefined,
+                nextPage: page < numberOfPages - 1 ? permalink(page + 1) : undefined,
                 blogDescription,
                 blogTitle,
             },
@@ -56,7 +58,7 @@ exports.paginateBlogPosts = paginateBlogPosts;
 function getBlogTags({ blogPosts, ...params }) {
     const groups = (0, utils_1.groupTaggedItems)(blogPosts, (blogPost) => blogPost.metadata.tags);
     return lodash_1.default.mapValues(groups, ({ tag, items: tagBlogPosts }) => ({
-        name: tag.label,
+        label: tag.label,
         items: tagBlogPosts.map((item) => item.id),
         permalink: tag.permalink,
         pages: paginateBlogPosts({
@@ -76,20 +78,21 @@ function parseBlogFileName(blogSourceRelative) {
         const date = new Date(`${dateString}Z`);
         const slugDate = dateString.replace(/-/g, '/');
         const slug = `/${slugDate}/${folder}${text}`;
-        return { date, text, slug };
+        return { date, text: text, slug };
     }
     const text = blogSourceRelative.replace(/(?:\/index)?\.mdx?$/, '');
     const slug = `/${text}`;
     return { date: undefined, text, slug };
 }
 exports.parseBlogFileName = parseBlogFileName;
-function formatBlogPostDate(locale, date) {
+function formatBlogPostDate(locale, date, calendar) {
     try {
         return new Intl.DateTimeFormat(locale, {
             day: 'numeric',
             month: 'long',
             year: 'numeric',
             timeZone: 'UTC',
+            calendar,
         }).format(date);
     }
     catch (err) {
@@ -105,7 +108,7 @@ async function parseBlogPostMarkdownFile(blogSourceAbsolute) {
         });
         return {
             ...result,
-            frontMatter: (0, blogFrontMatter_1.validateBlogPostFrontMatter)(result.frontMatter),
+            frontMatter: (0, frontMatter_1.validateBlogPostFrontMatter)(result.frontMatter),
         };
     }
     catch (err) {
@@ -115,7 +118,6 @@ async function parseBlogPostMarkdownFile(blogSourceAbsolute) {
 }
 const defaultReadingTime = ({ content, options }) => (0, reading_time_1.default)(content, options).minutes;
 async function processBlogSourceFile(blogSourceRelative, contentPaths, context, options, authorsMap) {
-    var _a, _b, _c, _d;
     const { siteConfig: { baseUrl }, siteDir, i18n, } = context;
     const { routeBasePath, tagsBasePath: tagsRouteBasePath, truncateMarker, showReadingTime, editUrl, } = options;
     // Lookup in localized folder in priority
@@ -151,14 +153,14 @@ async function processBlogSourceFile(blogSourceRelative, contentPaths, context,
             return result.date;
         }
         catch (err) {
-            logger_1.default.error(err);
+            logger_1.default.warn(err);
             return (await fs_extra_1.default.stat(blogSourceAbsolute)).birthtime;
         }
     }
     const date = await getDate();
-    const formattedDate = formatBlogPostDate(i18n.currentLocale, date);
-    const title = (_b = (_a = frontMatter.title) !== null && _a !== void 0 ? _a : contentTitle) !== null && _b !== void 0 ? _b : parsedBlogFileName.text;
-    const description = (_d = (_c = frontMatter.description) !== null && _c !== void 0 ? _c : excerpt) !== null && _d !== void 0 ? _d : '';
+    const formattedDate = formatBlogPostDate(i18n.currentLocale, date, i18n.localeConfigs[i18n.currentLocale].calendar);
+    const title = frontMatter.title ?? contentTitle ?? parsedBlogFileName.text;
+    const description = frontMatter.description ?? excerpt ?? '';
     const slug = frontMatter.slug || parsedBlogFileName.slug;
     const permalink = (0, utils_1.normalizeUrl)([baseUrl, routeBasePath, slug]);
     function getBlogEditUrl() {
@@ -208,7 +210,7 @@ async function processBlogSourceFile(blogSourceRelative, contentPaths, context,
                     defaultReadingTime,
                 })
                 : undefined,
-            truncated: (truncateMarker === null || truncateMarker === void 0 ? void 0 : truncateMarker.test(content)) || false,
+            truncated: truncateMarker?.test(content) || false,
             authors,
             frontMatter,
         },

package/lib/feed.d.ts

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

package/lib/feed.js

@@ -10,37 +10,35 @@ exports.createBlogFeedFiles = void 0;
 const tslib_1 = require("tslib");
 const feed_1 = require("feed");
 const utils_1 = require("@docusaurus/utils");
-const cheerio_1 = (0, tslib_1.__importDefault)(require("cheerio"));
-const path_1 = (0, tslib_1.__importDefault)(require("path"));
-const fs_extra_1 = (0, tslib_1.__importDefault)(require("fs-extra"));
+const cheerio_1 = require("cheerio");
+const path_1 = tslib_1.__importDefault(require("path"));
+const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const utils_common_1 = require("@docusaurus/utils-common");
-async function generateBlogFeed({ blogPosts, options, siteConfig, outDir, }) {
+async function generateBlogFeed({ blogPosts, options, siteConfig, outDir, locale, }) {
     if (!blogPosts.length) {
         return null;
     }
     const { feedOptions, routeBasePath } = options;
     const { url: siteUrl, baseUrl, title, favicon } = siteConfig;
     const blogBaseUrl = (0, utils_1.normalizeUrl)([siteUrl, baseUrl, routeBasePath]);
-    const updated = blogPosts[0] && blogPosts[0].metadata.date;
+    const updated = blogPosts[0]?.metadata.date;
     const feed = new feed_1.Feed({
         id: blogBaseUrl,
-        title: feedOptions.title || `${title} Blog`,
+        title: feedOptions.title ?? `${title} Blog`,
         updated,
-        language: feedOptions.language,
+        language: feedOptions.language ?? locale,
         link: blogBaseUrl,
-        description: feedOptions.description || `${siteConfig.title} Blog`,
+        description: feedOptions.description ?? `${siteConfig.title} Blog`,
         favicon: favicon ? (0, utils_1.normalizeUrl)([siteUrl, baseUrl, favicon]) : undefined,
         copyright: feedOptions.copyright,
     });
     function toFeedAuthor(author) {
-        // TODO ask author emails?
-        // RSS feed requires email to render authors
-        return { name: author.name, link: author.url };
+        return { name: author.name, link: author.url, email: author.email };
     }
-    await (0, utils_1.mapAsyncSequential)(blogPosts, async (post) => {
+    await Promise.all(blogPosts.map(async (post) => {
         const { id, metadata: { title: metadataTitle, permalink, date, description, authors, tags, }, } = post;
         const content = await (0, utils_1.readOutputHTMLFile)(permalink.replace(siteConfig.baseUrl, ''), outDir, siteConfig.trailingSlash);
-        const $ = cheerio_1.default.load(content);
+        const $ = (0, cheerio_1.load)(content);
         const feedItem = {
             title: metadataTitle,
             id,
@@ -57,8 +55,8 @@ async function generateBlogFeed({ blogPosts, options, siteConfig, outDir, }) {
         if (feedItemAuthors.length > 0) {
             feedItem.author = feedItemAuthors;
         }
-        feed.addItem(feedItem);
-    });
+        return feedItem;
+    })).then((items) => items.forEach(feed.addItem));
     return feed;
 }
 async function createBlogFeedFile({ feed, feedType, generatePath, }) {
@@ -75,18 +73,19 @@ async function createBlogFeedFile({ feed, feedType, generatePath, }) {
         }
     })();
     try {
-        await fs_extra_1.default.outputFile((0, utils_1.posixPath)(path_1.default.join(generatePath, feedPath)), feedContent);
+        await fs_extra_1.default.outputFile(path_1.default.join(generatePath, feedPath), feedContent);
     }
     catch (err) {
         throw new Error(`Generating ${feedType} feed failed: ${err}.`);
     }
 }
-async function createBlogFeedFiles({ blogPosts, options, siteConfig, outDir, }) {
+async function createBlogFeedFiles({ blogPosts, options, siteConfig, outDir, locale, }) {
     const feed = await generateBlogFeed({
         blogPosts,
         options,
         siteConfig,
         outDir,
+        locale,
     });
     const feedTypes = options.feedOptions.type;
     if (!feed || !feedTypes) {

package/lib/{blogFrontMatter.d.ts → frontMatter.d.ts}

@@ -5,4 +5,6 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { BlogPostFrontMatter } from '@docusaurus/plugin-content-blog';
-export declare function validateBlogPostFrontMatter(frontMatter: Record<string, unknown>): BlogPostFrontMatter;
+export declare function validateBlogPostFrontMatter(frontMatter: {
+    [key: string]: unknown;
+}): BlogPostFrontMatter;

package/lib/index.d.ts

@@ -4,8 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import type { BlogContent } from './types';
-import type { LoadContext, Plugin, OptionValidationContext, ValidationResult } from '@docusaurus/types';
-import type { PluginOptions } from '@docusaurus/plugin-content-blog';
+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>>;
-export declare function validateOptions({ validate, options, }: OptionValidationContext<PluginOptions>): ValidationResult<PluginOptions>;
+export { validateOptions } from './options';

package/lib/index.js

@@ -8,15 +8,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateOptions = void 0;
 const tslib_1 = require("tslib");
-const path_1 = (0, tslib_1.__importDefault)(require("path"));
-const remark_admonitions_1 = (0, tslib_1.__importDefault)(require("remark-admonitions"));
+const path_1 = tslib_1.__importDefault(require("path"));
+const remark_admonitions_1 = tslib_1.__importDefault(require("remark-admonitions"));
+const footnoteIDFixer_1 = tslib_1.__importDefault(require("./remark/footnoteIDFixer"));
 const utils_1 = require("@docusaurus/utils");
 const translations_1 = require("./translations");
-const pluginOptionSchema_1 = require("./pluginOptionSchema");
 const blogUtils_1 = require("./blogUtils");
 const feed_1 = require("./feed");
 async function pluginContentBlog(context, options) {
-    var _a;
     if (options.admonitions) {
         options.remarkPlugins = options.remarkPlugins.concat([
             [remark_admonitions_1.default, options.admonitions],
@@ -33,7 +32,7 @@ async function pluginContentBlog(context, options) {
             pluginId: options.id,
         }),
     };
-    const pluginId = (_a = options.id) !== null && _a !== void 0 ? _a : utils_1.DEFAULT_PLUGIN_ID;
+    const pluginId = options.id ?? utils_1.DEFAULT_PLUGIN_ID;
     const pluginDataDirRoot = path_1.default.join(generatedFilesDir, 'docusaurus-plugin-content-blog');
     const dataDir = path_1.default.join(pluginDataDirRoot, pluginId);
     const aliasedSource = (source) => `~blog/${(0, utils_1.posixPath)(path_1.default.relative(pluginDataDirRoot, source))}`;
@@ -48,12 +47,14 @@ async function pluginContentBlog(context, options) {
             const contentMarkdownGlobs = (0, utils_1.getContentPathList)(contentPaths).flatMap((contentPath) => include.map((pattern) => `${contentPath}/${pattern}`));
             return [authorsMapFilePath, ...contentMarkdownGlobs].filter(Boolean);
         },
-        async getTranslationFiles() {
+        getTranslationFiles() {
             return (0, translations_1.getTranslationFiles)(options);
         },
         // Fetches blog contents and returns metadata for the necessary routes.
         async loadContent() {
             const { postsPerPage: postsPerPageOption, routeBasePath, tagsBasePath, blogDescription, blogTitle, blogSidebarTitle, } = 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);
             if (!blogPosts.length) {
                 return {
@@ -61,7 +62,7 @@ async function pluginContentBlog(context, options) {
                     blogPosts: [],
                     blogListPaginated: [],
                     blogTags: {},
-                    blogTagsListPath: null,
+                    blogTagsListPath,
                     blogTagsPaginated: [],
                 };
             }
@@ -82,7 +83,6 @@ async function pluginContentBlog(context, options) {
                     };
                 }
             });
-            const baseBlogUrl = (0, utils_1.normalizeUrl)([baseUrl, routeBasePath]);
             const blogListPaginated = (0, blogUtils_1.paginateBlogPosts)({
                 blogPosts,
                 blogTitle,
@@ -96,8 +96,6 @@ async function pluginContentBlog(context, options) {
                 blogDescription,
                 blogTitle,
             });
-            const tagsPath = (0, utils_1.normalizeUrl)([baseBlogUrl, tagsBasePath]);
-            const blogTagsListPath = Object.keys(blogTags).length > 0 ? tagsPath : null;
             return {
                 blogSidebarTitle,
                 blogPosts,
@@ -117,13 +115,13 @@ async function pluginContentBlog(context, options) {
             const sidebarBlogPosts = options.blogSidebarCount === 'ALL'
                 ? blogPosts
                 : blogPosts.slice(0, options.blogSidebarCount);
-            if (archiveBasePath) {
+            if (archiveBasePath && blogPosts.length) {
                 const archiveUrl = (0, utils_1.normalizeUrl)([
                     baseUrl,
                     routeBasePath,
                     archiveBasePath,
                 ]);
-                // creates a blog archive route
+                // Create a blog archive route
                 const archiveProp = await createData(`${(0, utils_1.docuHash)(archiveUrl)}.json`, JSON.stringify({ blogPosts }, null, 2));
                 addRoute({
                     path: archiveUrl,
@@ -174,10 +172,7 @@ async function pluginContentBlog(context, options) {
                     exact: true,
                     modules: {
                         sidebar: aliasedSource(sidebarProp),
-                        items: items.map((postID) => 
-                        // To tell routes.js this is an import and not a nested object
-                        // to recurse.
-                        ({
+                        items: items.map((postID) => ({
                             content: {
                                 __import: true,
                                 path: blogItemsToMetadata[postID].source,
@@ -190,24 +185,37 @@ async function pluginContentBlog(context, options) {
                     },
                 });
             }));
-            // Tags.
-            if (blogTagsListPath === null) {
+            // Tags. This is the last part so we early-return if there are no tags.
+            if (Object.keys(blogTags).length === 0) {
                 return;
             }
-            const tagsModule = Object.fromEntries(Object.entries(blogTags).map(([tagKey, tag]) => {
-                const tagModule = {
-                    allTagsPath: blogTagsListPath,
-                    slug: tagKey,
-                    name: tag.name,
-                    count: tag.items.length,
+            async function createTagsListPage() {
+                const tagsProp = Object.values(blogTags).map((tag) => ({
+                    label: tag.label,
                     permalink: tag.permalink,
-                };
-                return [tag.name, tagModule];
-            }));
-            async function createTagRoutes(tag) {
+                    count: tag.items.length,
+                }));
+                const tagsPropPath = await createData(`${(0, utils_1.docuHash)(`${blogTagsListPath}-tags`)}.json`, JSON.stringify(tagsProp, null, 2));
+                addRoute({
+                    path: blogTagsListPath,
+                    component: blogTagsListComponent,
+                    exact: true,
+                    modules: {
+                        sidebar: aliasedSource(sidebarProp),
+                        tags: aliasedSource(tagsPropPath),
+                    },
+                });
+            }
+            async function createTagPostsListPage(tag) {
                 await Promise.all(tag.pages.map(async (blogPaginated) => {
                     const { metadata, items } = blogPaginated;
-                    const tagsMetadataPath = await createData(`${(0, utils_1.docuHash)(metadata.permalink)}.json`, JSON.stringify(tagsModule[tag.name], null, 2));
+                    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 listMetadataPath = await createData(`${(0, utils_1.docuHash)(metadata.permalink)}-list.json`, JSON.stringify(metadata, null, 2));
                     addRoute({
                         path: metadata.permalink,
@@ -227,26 +235,14 @@ async function pluginContentBlog(context, options) {
                                     },
                                 };
                             }),
-                            metadata: aliasedSource(tagsMetadataPath),
+                            tag: aliasedSource(tagPropPath),
                             listMetadata: aliasedSource(listMetadataPath),
                         },
                     });
                 }));
             }
-            await Promise.all(Object.values(blogTags).map(createTagRoutes));
-            // Only create /tags page if there are tags.
-            if (Object.keys(blogTags).length > 0) {
-                const tagsListPath = await createData(`${(0, utils_1.docuHash)(`${blogTagsListPath}-tags`)}.json`, JSON.stringify(tagsModule, null, 2));
-                addRoute({
-                    path: blogTagsListPath,
-                    component: blogTagsListComponent,
-                    exact: true,
-                    modules: {
-                        sidebar: aliasedSource(sidebarProp),
-                        tags: aliasedSource(tagsListPath),
-                    },
-                });
-            }
+            await createTagsListPage();
+            await Promise.all(Object.values(blogTags).map(createTagPostsListPage));
         },
         translateContent({ content, translationFiles }) {
             return (0, translations_1.translateContent)(content, translationFiles);
@@ -286,7 +282,10 @@ async function pluginContentBlog(context, options) {
                                     options: {
                                         remarkPlugins,
                                         rehypePlugins,
-                                        beforeDefaultRemarkPlugins,
+                                        beforeDefaultRemarkPlugins: [
+                                            footnoteIDFixer_1.default,
+                                            ...beforeDefaultRemarkPlugins,
+                                        ],
                                         beforeDefaultRehypePlugins,
                                         staticDirs: siteConfig.staticDirectories.map((dir) => path_1.default.resolve(siteDir, dir)),
                                         siteDir,
@@ -331,18 +330,18 @@ async function pluginContentBlog(context, options) {
                 options,
                 outDir,
                 siteConfig,
+                locale: currentLocale,
             });
         },
         injectHtmlTags({ content }) {
-            var _a, _b;
             if (!content.blogPosts.length) {
                 return {};
             }
-            if (!((_a = options.feedOptions) === null || _a === void 0 ? void 0 : _a.type)) {
+            if (!options.feedOptions?.type) {
                 return {};
             }
             const feedTypes = options.feedOptions.type;
-            const feedTitle = (_b = options.feedOptions.title) !== null && _b !== void 0 ? _b : context.siteConfig.title;
+            const feedTitle = options.feedOptions.title ?? context.siteConfig.title;
             const feedsConfig = {
                 rss: {
                     type: 'application/rss+xml',
@@ -362,11 +361,7 @@ async function pluginContentBlog(context, options) {
             };
             const headTags = [];
             feedTypes.forEach((feedType) => {
-                const feedConfig = feedsConfig[feedType] || {};
-                if (!feedsConfig) {
-                    return;
-                }
-                const { type, path: feedConfigPath, title: feedConfigTitle } = feedConfig;
+                const { type, path: feedConfigPath, title: feedConfigTitle, } = feedsConfig[feedType];
                 headTags.push({
                     tagName: 'link',
                     attributes: {
@@ -388,8 +383,5 @@ async function pluginContentBlog(context, options) {
     };
 }
 exports.default = pluginContentBlog;
-function validateOptions({ validate, options, }) {
-    const validatedOptions = validate(pluginOptionSchema_1.PluginOptionSchema, options);
-    return validatedOptions;
-}
-exports.validateOptions = validateOptions;
+var options_1 = require("./options");
+Object.defineProperty(exports, "validateOptions", { enumerable: true, get: function () { return options_1.validateOptions; } });

package/lib/markdownLoader.js

@@ -25,6 +25,6 @@ function markdownLoader(source) {
     if (truncated) {
         finalContent = (0, blogUtils_1.truncate)(finalContent, markdownLoaderOptions.truncateMarker);
     }
-    return callback && callback(null, finalContent);
+    return callback?.(null, finalContent);
 }
 exports.default = markdownLoader;

package/lib/options.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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 { PluginOptions, Options } from '@docusaurus/plugin-content-blog';
+import type { OptionValidationContext } from '@docusaurus/types';
+export declare const DEFAULT_OPTIONS: PluginOptions;
+export declare function validateOptions({ validate, options, }: OptionValidationContext<Options, PluginOptions>): PluginOptions;

package/lib/{pluginOptionSchema.js → options.js}

@@ -6,7 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PluginOptionSchema = exports.DEFAULT_OPTIONS = void 0;
+exports.validateOptions = exports.DEFAULT_OPTIONS = void 0;
 const utils_validation_1 = require("@docusaurus/utils-validation");
 const utils_1 = require("@docusaurus/utils");
 exports.DEFAULT_OPTIONS = {
@@ -39,7 +39,7 @@ exports.DEFAULT_OPTIONS = {
     readingTime: ({ content, defaultReadingTime }) => defaultReadingTime({ content }),
     sortPosts: 'descending',
 };
-exports.PluginOptionSchema = utils_validation_1.Joi.object({
+const PluginOptionSchema = utils_validation_1.Joi.object({
     path: utils_validation_1.Joi.string().default(exports.DEFAULT_OPTIONS.path),
     archiveBasePath: utils_validation_1.Joi.string()
         .default(exports.DEFAULT_OPTIONS.archiveBasePath)
@@ -85,7 +85,7 @@ exports.PluginOptionSchema = utils_validation_1.Joi.object({
             .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)
+        // 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(),
@@ -100,4 +100,9 @@ exports.PluginOptionSchema = utils_validation_1.Joi.object({
     sortPosts: utils_validation_1.Joi.string()
         .valid('descending', 'ascending')
         .default(exports.DEFAULT_OPTIONS.sortPosts),
-});
+}).default(exports.DEFAULT_OPTIONS);
+function validateOptions({ validate, options, }) {
+    const validatedOptions = validate(PluginOptionSchema, options);
+    return validatedOptions;
+}
+exports.validateOptions = validateOptions;

package/lib/remark/footnoteIDFixer.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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 { Transformer } from 'unified';
+/**
+ * In the blog list view, each post will be compiled separately. However, they
+ * may use the same footnote IDs. This leads to duplicated DOM IDs and inability
+ * to navigate to footnote references. This plugin fixes it by appending a
+ * unique hash to each reference/definition.
+ */
+export default function plugin(): Transformer;