@docusaurus/plugin-content-blog 2.0.0-beta.0e652730d → 2.0.0-beta.10

package/lib/index.js

@@ -8,14 +8,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateOptions = 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"));
-const remark_admonitions_1 = tslib_1.__importDefault(require("remark-admonitions"));
+const path_1 = (0, tslib_1.__importDefault)(require("path"));
+const remark_admonitions_1 = (0, tslib_1.__importDefault)(require("remark-admonitions"));
 const utils_1 = require("@docusaurus/utils");
-const constants_1 = require("@docusaurus/core/lib/constants");
-const lodash_1 = require("lodash");
+const translations_1 = require("./translations");
 const pluginOptionSchema_1 = require("./pluginOptionSchema");
 const blogUtils_1 = require("./blogUtils");
+const feed_1 = require("./feed");
 function pluginContentBlog(context, options) {
     var _a;
     if (options.admonitions) {
@@ -23,42 +22,47 @@ function pluginContentBlog(context, options) {
             [remark_admonitions_1.default, options.admonitions],
         ]);
     }
-    const { siteDir, siteConfig: { onBrokenMarkdownLinks }, generatedFilesDir, i18n: { currentLocale }, } = context;
+    const { siteDir, siteConfig, generatedFilesDir, i18n: { currentLocale }, } = context;
+    const { onBrokenMarkdownLinks, baseUrl } = siteConfig;
     const contentPaths = {
         contentPath: path_1.default.resolve(siteDir, options.path),
-        contentPathLocalized: utils_1.getPluginI18nPath({
+        contentPathLocalized: (0, utils_1.getPluginI18nPath)({
             siteDir,
             locale: currentLocale,
             pluginName: 'docusaurus-plugin-content-blog',
             pluginId: options.id,
         }),
     };
-    const pluginId = (_a = options.id) !== null && _a !== void 0 ? _a : constants_1.DEFAULT_PLUGIN_ID;
+    const pluginId = (_a = options.id) !== null && _a !== void 0 ? _a : 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/${utils_1.posixPath(path_1.default.relative(pluginDataDirRoot, source))}`;
-    let blogPosts = [];
+    const aliasedSource = (source) => `~blog/${(0, utils_1.posixPath)(path_1.default.relative(pluginDataDirRoot, source))}`;
     return {
         name: 'docusaurus-plugin-content-blog',
         getPathsToWatch() {
-            const { include = [] } = options;
-            return lodash_1.flatten(blogUtils_1.getContentPathList(contentPaths).map((contentPath) => {
-                return include.map((pattern) => `${contentPath}/${pattern}`);
-            }));
+            const { include, authorsMapPath } = options;
+            const contentMarkdownGlobs = (0, blogUtils_1.getContentPathList)(contentPaths).flatMap((contentPath) => include.map((pattern) => `${contentPath}/${pattern}`));
+            // TODO: we should read this path in plugin! but plugins do not support async init for now :'(
+            // const authorsMapFilePath = await getAuthorsMapFilePath({authorsMapPath,contentPaths,});
+            // simplified impl, better than nothing for now:
+            const authorsMapFilePath = path_1.default.join(contentPaths.contentPath, authorsMapPath);
+            return [authorsMapFilePath, ...contentMarkdownGlobs];
         },
-        getClientModules() {
-            const modules = [];
-            if (options.admonitions) {
-                modules.push(require.resolve('remark-admonitions/styles/infima.css'));
-            }
-            return modules;
+        async getTranslationFiles() {
+            return (0, translations_1.getTranslationFiles)(options);
         },
         // Fetches blog contents and returns metadata for the necessary routes.
         async loadContent() {
-            const { postsPerPage, routeBasePath } = options;
-            blogPosts = await blogUtils_1.generateBlogPosts(contentPaths, context, options);
+            const { postsPerPage: postsPerPageOption, routeBasePath, tagsBasePath, blogDescription, blogTitle, blogSidebarTitle, } = options;
+            const blogPosts = await (0, blogUtils_1.generateBlogPosts)(contentPaths, context, options);
             if (!blogPosts.length) {
-                return null;
+                return {
+                    blogSidebarTitle,
+                    blogPosts: [],
+                    blogListPaginated: [],
+                    blogTags: {},
+                    blogTagsListPath: null,
+                };
             }
             // Colocate next and prev metadata.
             blogPosts.forEach((blogPost, index) => {
@@ -80,14 +84,14 @@ function pluginContentBlog(context, options) {
             // Blog pagination routes.
             // Example: `/blog`, `/blog/page/1`, `/blog/page/2`
             const totalCount = blogPosts.length;
+            const postsPerPage = postsPerPageOption === 'ALL' ? totalCount : postsPerPageOption;
             const numberOfPages = Math.ceil(totalCount / postsPerPage);
-            const { siteConfig: { baseUrl = '' }, } = context;
-            const basePageUrl = utils_1.normalizeUrl([baseUrl, routeBasePath]);
+            const baseBlogUrl = (0, utils_1.normalizeUrl)([baseUrl, routeBasePath]);
             const blogListPaginated = [];
             function blogPaginationPermalink(page) {
                 return page > 0
-                    ? utils_1.normalizeUrl([basePageUrl, `page/${page + 1}`])
-                    : basePageUrl;
+                    ? (0, utils_1.normalizeUrl)([baseBlogUrl, `page/${page + 1}`])
+                    : baseBlogUrl;
             }
             for (let page = 0; page < numberOfPages; page += 1) {
                 blogListPaginated.push({
@@ -101,48 +105,19 @@ function pluginContentBlog(context, options) {
                         nextPage: page < numberOfPages - 1
                             ? blogPaginationPermalink(page + 1)
                             : null,
-                        blogDescription: options.blogDescription,
-                        blogTitle: options.blogTitle,
+                        blogDescription,
+                        blogTitle,
                     },
                     items: blogPosts
                         .slice(page * postsPerPage, (page + 1) * postsPerPage)
                         .map((item) => item.id),
                 });
             }
-            const blogTags = {};
-            const tagsPath = utils_1.normalizeUrl([basePageUrl, 'tags']);
-            blogPosts.forEach((blogPost) => {
-                const { tags } = blogPost.metadata;
-                if (!tags || tags.length === 0) {
-                    // TODO: Extract tags out into a separate plugin.
-                    // eslint-disable-next-line no-param-reassign
-                    blogPost.metadata.tags = [];
-                    return;
-                }
-                // eslint-disable-next-line no-param-reassign
-                blogPost.metadata.tags = tags.map((tag) => {
-                    if (typeof tag === 'string') {
-                        const normalizedTag = lodash_1.kebabCase(tag);
-                        const permalink = utils_1.normalizeUrl([tagsPath, normalizedTag]);
-                        if (!blogTags[normalizedTag]) {
-                            blogTags[normalizedTag] = {
-                                // Will only use the name of the first occurrence of the tag.
-                                name: tag.toLowerCase(),
-                                items: [],
-                                permalink,
-                            };
-                        }
-                        blogTags[normalizedTag].items.push(blogPost.id);
-                        return {
-                            label: tag,
-                            permalink,
-                        };
-                    }
-                    return tag;
-                });
-            });
+            const blogTags = (0, blogUtils_1.getBlogTags)(blogPosts);
+            const tagsPath = (0, utils_1.normalizeUrl)([baseBlogUrl, tagsBasePath]);
             const blogTagsListPath = Object.keys(blogTags).length > 0 ? tagsPath : null;
             return {
+                blogSidebarTitle,
                 blogPosts,
                 blogListPaginated,
                 blogTags,
@@ -153,31 +128,46 @@ function pluginContentBlog(context, options) {
             if (!blogContents) {
                 return;
             }
-            const { blogListComponent, blogPostComponent, blogTagsListComponent, blogTagsPostsComponent, } = options;
+            const { blogListComponent, blogPostComponent, blogTagsListComponent, blogTagsPostsComponent, routeBasePath, archiveBasePath, } = options;
             const { addRoute, createData } = actions;
-            const { blogPosts: loadedBlogPosts, blogListPaginated, blogTags, blogTagsListPath, } = blogContents;
+            const { blogSidebarTitle, blogPosts, blogListPaginated, blogTags, blogTagsListPath, } = blogContents;
             const blogItemsToMetadata = {};
             const sidebarBlogPosts = options.blogSidebarCount === 'ALL'
                 ? blogPosts
-                : lodash_1.take(blogPosts, options.blogSidebarCount);
+                : blogPosts.slice(0, options.blogSidebarCount);
+            const archiveUrl = (0, utils_1.normalizeUrl)([
+                baseUrl,
+                routeBasePath,
+                archiveBasePath,
+            ]);
+            // creates a blog archive route
+            const archiveProp = await createData(`${(0, utils_1.docuHash)(archiveUrl)}.json`, JSON.stringify({ blogPosts }, null, 2));
+            addRoute({
+                path: archiveUrl,
+                component: '@theme/BlogArchivePage',
+                exact: true,
+                modules: {
+                    archive: aliasedSource(archiveProp),
+                },
+            });
             // This prop is useful to provide the blog list sidebar
             const sidebarProp = await createData(
             // Note that this created data path must be in sync with
             // metadataPath provided to mdx-loader.
             `blog-post-list-prop-${pluginId}.json`, JSON.stringify({
-                title: options.blogSidebarTitle,
+                title: blogSidebarTitle,
                 items: sidebarBlogPosts.map((blogPost) => ({
                     title: blogPost.metadata.title,
                     permalink: blogPost.metadata.permalink,
                 })),
             }, null, 2));
             // Create routes for blog entries.
-            await Promise.all(loadedBlogPosts.map(async (blogPost) => {
+            await Promise.all(blogPosts.map(async (blogPost) => {
                 const { id, metadata } = blogPost;
                 await createData(
                 // Note that this created data path must be in sync with
                 // metadataPath provided to mdx-loader.
-                `${utils_1.docuHash(metadata.source)}.json`, JSON.stringify(metadata, null, 2));
+                `${(0, utils_1.docuHash)(metadata.source)}.json`, JSON.stringify(metadata, null, 2));
                 addRoute({
                     path: metadata.permalink,
                     component: blogPostComponent,
@@ -193,25 +183,24 @@ function pluginContentBlog(context, options) {
             await Promise.all(blogListPaginated.map(async (listPage) => {
                 const { metadata, items } = listPage;
                 const { permalink } = metadata;
-                const pageMetadataPath = await createData(`${utils_1.docuHash(permalink)}.json`, JSON.stringify(metadata, null, 2));
+                const pageMetadataPath = await createData(`${(0, utils_1.docuHash)(permalink)}.json`, JSON.stringify(metadata, null, 2));
                 addRoute({
                     path: permalink,
                     component: blogListComponent,
                     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.
-                            return {
-                                content: {
-                                    __import: true,
-                                    path: blogItemsToMetadata[postID].source,
-                                    query: {
-                                        truncated: true,
-                                    },
+                        items: items.map((postID) => 
+                        // To tell routes.js this is an import and not a nested object to recurse.
+                        ({
+                            content: {
+                                __import: true,
+                                path: blogItemsToMetadata[postID].source,
+                                query: {
+                                    truncated: true,
                                 },
-                            };
-                        }),
+                            },
+                        })),
                         metadata: aliasedSource(pageMetadataPath),
                     },
                 });
@@ -223,6 +212,7 @@ function pluginContentBlog(context, options) {
             const tagsModule = {};
             await Promise.all(Object.keys(blogTags).map(async (tag) => {
                 const { name, items, permalink } = blogTags[tag];
+                // Refactor all this, see docs implementation
                 tagsModule[tag] = {
                     allTagsPath: blogTagsListPath,
                     slug: tag,
@@ -230,7 +220,7 @@ function pluginContentBlog(context, options) {
                     count: items.length,
                     permalink,
                 };
-                const tagsMetadataPath = await createData(`${utils_1.docuHash(permalink)}.json`, JSON.stringify(tagsModule[tag], null, 2));
+                const tagsMetadataPath = await createData(`${(0, utils_1.docuHash)(permalink)}.json`, JSON.stringify(tagsModule[tag], null, 2));
                 addRoute({
                     path: permalink,
                     component: blogTagsPostsComponent,
@@ -255,7 +245,7 @@ function pluginContentBlog(context, options) {
             }));
             // Only create /tags page if there are tags.
             if (Object.keys(blogTags).length > 0) {
-                const tagsListPath = await createData(`${utils_1.docuHash(`${blogTagsListPath}-tags`)}.json`, JSON.stringify(tagsModule, null, 2));
+                const tagsListPath = await createData(`${(0, utils_1.docuHash)(`${blogTagsListPath}-tags`)}.json`, JSON.stringify(tagsModule, null, 2));
                 addRoute({
                     path: blogTagsListPath,
                     component: blogTagsListComponent,
@@ -267,20 +257,24 @@ function pluginContentBlog(context, options) {
                 });
             }
         },
-        configureWebpack(_config, isServer, { getJSLoader }) {
+        translateContent({ content, translationFiles }) {
+            return (0, translations_1.translateContent)(content, translationFiles);
+        },
+        configureWebpack(_config, isServer, { getJSLoader }, content) {
             const { rehypePlugins, remarkPlugins, truncateMarker, beforeDefaultRemarkPlugins, beforeDefaultRehypePlugins, } = options;
             const markdownLoaderOptions = {
                 siteDir,
                 contentPaths,
                 truncateMarker,
-                sourceToPermalink: blogUtils_1.getSourceToPermalink(blogPosts),
+                sourceToPermalink: (0, blogUtils_1.getSourceToPermalink)(content.blogPosts),
                 onBrokenMarkdownLink: (brokenMarkdownLink) => {
                     if (onBrokenMarkdownLinks === 'ignore') {
                         return;
                     }
-                    utils_1.reportMessage(`Blog markdown link couldn't be resolved: (${brokenMarkdownLink.link}) in ${brokenMarkdownLink.filePath}`, onBrokenMarkdownLinks);
+                    (0, utils_1.reportMessage)(`Blog markdown link couldn't be resolved: (${brokenMarkdownLink.link}) in ${brokenMarkdownLink.filePath}`, onBrokenMarkdownLinks);
                 },
             };
+            const contentDirs = (0, blogUtils_1.getContentPathList)(contentPaths);
             return {
                 resolve: {
                     alias: {
@@ -291,7 +285,7 @@ function pluginContentBlog(context, options) {
                     rules: [
                         {
                             test: /(\.mdx?)$/,
-                            include: blogUtils_1.getContentPathList(contentPaths)
+                            include: contentDirs
                                 // Trailing slash is important, see https://github.com/facebook/docusaurus/pull/3970
                                 .map(utils_1.addTrailingPathSeparator),
                             use: [
@@ -303,16 +297,23 @@ function pluginContentBlog(context, options) {
                                         rehypePlugins,
                                         beforeDefaultRemarkPlugins,
                                         beforeDefaultRehypePlugins,
-                                        staticDir: path_1.default.join(siteDir, constants_1.STATIC_DIR_NAME),
-                                        // Note that metadataPath must be the same/in-sync as
-                                        // the path from createData for each MDX.
+                                        staticDirs: siteConfig.staticDirectories.map((dir) => path_1.default.resolve(siteDir, dir)),
+                                        siteDir,
+                                        isMDXPartial: (0, utils_1.createAbsoluteFilePathMatcher)(options.exclude, contentDirs),
                                         metadataPath: (mdxPath) => {
-                                            const aliasedPath = utils_1.aliasedSitePath(mdxPath, siteDir);
-                                            return path_1.default.join(dataDir, `${utils_1.docuHash(aliasedPath)}.json`);
+                                            // Note that metadataPath must be the same/in-sync as
+                                            // the path from createData for each MDX.
+                                            const aliasedPath = (0, utils_1.aliasedSitePath)(mdxPath, siteDir);
+                                            return path_1.default.join(dataDir, `${(0, utils_1.docuHash)(aliasedPath)}.json`);
                                         },
                                         // For blog posts a title in markdown is always removed
                                         // Blog posts title are rendered separately
                                         removeContentTitle: true,
+                                        // Assets allow to convert some relative images paths to require() calls
+                                        createAssets: ({ frontMatter, metadata, }) => ({
+                                            image: frontMatter.image,
+                                            authorsImageUrls: metadata.authors.map((author) => author.imageURL),
+                                        }),
                                     },
                                 },
                                 {
@@ -326,46 +327,42 @@ function pluginContentBlog(context, options) {
             };
         },
         async postBuild({ outDir }) {
-            var _a;
-            if (!((_a = options.feedOptions) === null || _a === void 0 ? void 0 : _a.type)) {
+            if (!options.feedOptions.type) {
                 return;
             }
-            const feed = await blogUtils_1.generateBlogFeed(contentPaths, context, options);
-            if (!feed) {
+            // TODO: we shouldn't need to re-read the posts here!
+            // postBuild should receive loadedContent
+            const blogPosts = await (0, blogUtils_1.generateBlogPosts)(contentPaths, context, options);
+            if (!blogPosts.length) {
                 return;
             }
-            const feedTypes = options.feedOptions.type;
-            await Promise.all(feedTypes.map(async (feedType) => {
-                const feedPath = path_1.default.join(outDir, options.routeBasePath, `${feedType}.xml`);
-                const feedContent = feedType === 'rss' ? feed.rss2() : feed.atom1();
-                try {
-                    await fs_extra_1.default.outputFile(feedPath, feedContent);
-                }
-                catch (err) {
-                    throw new Error(`Generating ${feedType} feed failed: ${err}.`);
-                }
-            }));
+            await (0, feed_1.createBlogFeedFiles)({
+                blogPosts,
+                options,
+                outDir,
+                siteConfig,
+            });
         },
-        injectHtmlTags() {
-            var _a;
-            if (!blogPosts.length) {
+        injectHtmlTags({ content }) {
+            var _a, _b;
+            if (!content.blogPosts.length) {
                 return {};
             }
             if (!((_a = options.feedOptions) === null || _a === void 0 ? void 0 : _a.type)) {
                 return {};
             }
             const feedTypes = options.feedOptions.type;
-            const { siteConfig: { title }, baseUrl, } = context;
+            const feedTitle = (_b = options.feedOptions.title) !== null && _b !== void 0 ? _b : context.siteConfig.title;
             const feedsConfig = {
                 rss: {
                     type: 'application/rss+xml',
                     path: 'rss.xml',
-                    title: `${title} Blog RSS Feed`,
+                    title: `${feedTitle} RSS Feed`,
                 },
                 atom: {
                     type: 'application/atom+xml',
                     path: 'atom.xml',
-                    title: `${title} Blog Atom Feed`,
+                    title: `${feedTitle} Atom Feed`,
                 },
             };
             const headTags = [];
@@ -380,7 +377,7 @@ function pluginContentBlog(context, options) {
                     attributes: {
                         rel: 'alternate',
                         type,
-                        href: utils_1.normalizeUrl([
+                        href: (0, utils_1.normalizeUrl)([
                             baseUrl,
                             options.routeBasePath,
                             feedConfigPath,

package/lib/markdownLoader.d.ts

@@ -4,9 +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 types="node" />
-interface Loader extends Function {
-    (this: any, source: string): string | Buffer | void | undefined;
-}
-declare const markdownLoader: Loader;
-export default markdownLoader;
+import { BlogMarkdownLoaderOptions } from './types';
+import type { LoaderContext } from 'webpack';
+export default function markdownLoader(this: LoaderContext<BlogMarkdownLoaderOptions>, source: string): void;

package/lib/markdownLoader.js

@@ -8,24 +8,24 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const blogUtils_1 = require("./blogUtils");
 const loader_utils_1 = require("loader-utils");
-const markdownLoader = function (source) {
+function markdownLoader(source) {
     const filePath = this.resourcePath;
     const fileString = source;
     const callback = this.async();
     const markdownLoaderOptions = this.getOptions();
     // Linkify blog posts
-    let finalContent = blogUtils_1.linkify({
+    let finalContent = (0, blogUtils_1.linkify)({
         fileString,
         filePath,
         ...markdownLoaderOptions,
     });
     // Truncate content if requested (e.g: file.md?truncated=true).
     const truncated = this.resourceQuery
-        ? !!loader_utils_1.parseQuery(this.resourceQuery).truncated
+        ? !!(0, loader_utils_1.parseQuery)(this.resourceQuery).truncated
         : undefined;
     if (truncated) {
-        finalContent = blogUtils_1.truncate(finalContent, markdownLoaderOptions.truncateMarker);
+        finalContent = (0, blogUtils_1.truncate)(finalContent, markdownLoaderOptions.truncateMarker);
     }
     return callback && callback(null, finalContent);
-};
+}
 exports.default = markdownLoader;

package/lib/pluginOptionSchema.d.ts

@@ -5,29 +5,6 @@
  * LICENSE file in the root directory of this source tree.
  */
 import { Joi } from '@docusaurus/utils-validation';
-export declare const DEFAULT_OPTIONS: {
-    feedOptions: {
-        type: string[];
-    };
-    beforeDefaultRehypePlugins: never[];
-    beforeDefaultRemarkPlugins: never[];
-    admonitions: {};
-    truncateMarker: RegExp;
-    rehypePlugins: never[];
-    remarkPlugins: never[];
-    showReadingTime: boolean;
-    blogTagsPostsComponent: string;
-    blogTagsListComponent: string;
-    blogPostComponent: string;
-    blogListComponent: string;
-    blogDescription: string;
-    blogTitle: string;
-    blogSidebarCount: number;
-    blogSidebarTitle: string;
-    postsPerPage: number;
-    include: string[];
-    routeBasePath: string;
-    path: string;
-    editLocalizedFiles: boolean;
-};
-export declare const PluginOptionSchema: Joi.ObjectSchema<any>;
+import { PluginOptions } from './types';
+export declare const DEFAULT_OPTIONS: PluginOptions;
+export declare const PluginOptionSchema: Joi.ObjectSchema<PluginOptions>;

package/lib/pluginOptionSchema.js

@@ -8,8 +8,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PluginOptionSchema = 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'] },
+    feedOptions: { type: ['rss', 'atom'], copyright: '' },
     beforeDefaultRehypePlugins: [],
     beforeDefaultRemarkPlugins: [],
     admonitions: {},
@@ -26,21 +27,29 @@ exports.DEFAULT_OPTIONS = {
     blogSidebarCount: 5,
     blogSidebarTitle: 'Recent posts',
     postsPerPage: 10,
-    include: ['*.md', '*.mdx'],
+    include: ['**/*.{md,mdx}'],
+    exclude: utils_1.GlobExcludeDefault,
     routeBasePath: 'blog',
+    tagsBasePath: 'tags',
+    archiveBasePath: 'archive',
     path: 'blog',
     editLocalizedFiles: false,
+    authorsMapPath: 'authors.yml',
+    readingTime: ({ content, defaultReadingTime }) => defaultReadingTime({ content }),
+    sortPosts: 'descending',
 };
 exports.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),
     routeBasePath: utils_validation_1.Joi.string()
         // '' not allowed, see https://github.com/facebook/docusaurus/issues/3374
         // .allow('')
         .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),
-    postsPerPage: utils_validation_1.Joi.number()
-        .integer()
-        .min(1)
+    exclude: utils_validation_1.Joi.array().items(utils_validation_1.Joi.string()).default(exports.DEFAULT_OPTIONS.exclude),
+    postsPerPage: utils_validation_1.Joi.alternatives()
+        .try(utils_validation_1.Joi.equal('ALL').required(), utils_validation_1.Joi.number().integer().min(1).required())
         .default(exports.DEFAULT_OPTIONS.postsPerPage),
     blogListComponent: utils_validation_1.Joi.string().default(exports.DEFAULT_OPTIONS.blogListComponent),
     blogPostComponent: utils_validation_1.Joi.string().default(exports.DEFAULT_OPTIONS.blogPostComponent),
@@ -51,7 +60,7 @@ exports.PluginOptionSchema = utils_validation_1.Joi.object({
         .allow('')
         .default(exports.DEFAULT_OPTIONS.blogDescription),
     blogSidebarCount: utils_validation_1.Joi.alternatives()
-        .try(utils_validation_1.Joi.equal('ALL').required(), utils_validation_1.Joi.number().required())
+        .try(utils_validation_1.Joi.equal('ALL').required(), utils_validation_1.Joi.number().integer().min(0).required())
         .default(exports.DEFAULT_OPTIONS.blogSidebarCount),
     blogSidebarTitle: utils_validation_1.Joi.string().default(exports.DEFAULT_OPTIONS.blogSidebarTitle),
     showReadingTime: utils_validation_1.Joi.bool().default(exports.DEFAULT_OPTIONS.showReadingTime),
@@ -72,7 +81,19 @@ 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(''),
-        copyright: utils_validation_1.Joi.string(),
+        // 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(),
     }).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),
+    sortPosts: utils_validation_1.Joi.string()
+        .valid('descending', 'ascending')
+        .default(exports.DEFAULT_OPTIONS.sortPosts),
 });

package/lib/translations.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 { BlogContent, PluginOptions } from './types';
+import type { TranslationFiles } from '@docusaurus/types';
+export declare function getTranslationFiles(options: PluginOptions): TranslationFiles;
+export declare function translateContent(content: BlogContent, translationFiles: TranslationFiles): BlogContent;

package/lib/translations.js

@@ -0,0 +1,53 @@
+"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.translateContent = exports.getTranslationFiles = void 0;
+function translateListPage(blogListPaginated, translations) {
+    return blogListPaginated.map((page) => {
+        const { items, metadata } = page;
+        return {
+            items,
+            metadata: {
+                ...metadata,
+                blogTitle: translations.title.message,
+                blogDescription: translations.description.message,
+            },
+        };
+    });
+}
+function getTranslationFiles(options) {
+    return [
+        {
+            path: 'options',
+            content: {
+                title: {
+                    message: options.blogTitle,
+                    description: 'The title for the blog used in SEO',
+                },
+                description: {
+                    message: options.blogDescription,
+                    description: 'The description for the blog used in SEO',
+                },
+                'sidebar.title': {
+                    message: options.blogSidebarTitle,
+                    description: 'The label for the left sidebar',
+                },
+            },
+        },
+    ];
+}
+exports.getTranslationFiles = getTranslationFiles;
+function translateContent(content, translationFiles) {
+    const [{ content: optonsTranslations }] = translationFiles;
+    return {
+        ...content,
+        blogSidebarTitle: optonsTranslations['sidebar.title'].message,
+        blogListPaginated: translateListPage(content.blogListPaginated, optonsTranslations),
+    };
+}
+exports.translateContent = translateContent;