@docusaurus/plugin-content-blog 2.0.0-beta.6f366f4b4 → 2.0.0-beta.7

package/lib/index.js

@@ -8,11 +8,12 @@
 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 fs_extra_1 = (0, tslib_1.__importDefault)(require("fs-extra"));
+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 translations_1 = require("./translations");
 const lodash_1 = require("lodash");
 const pluginOptionSchema_1 = require("./pluginOptionSchema");
 const blogUtils_1 = require("./blogUtils");
@@ -23,10 +24,10 @@ function pluginContentBlog(context, options) {
             [remark_admonitions_1.default, options.admonitions],
         ]);
     }
-    const { siteDir, siteConfig: { onBrokenMarkdownLinks }, generatedFilesDir, i18n: { currentLocale }, } = context;
+    const { siteDir, siteConfig: { onBrokenMarkdownLinks, baseUrl }, generatedFilesDir, i18n: { currentLocale }, } = context;
     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',
@@ -36,21 +37,30 @@ function pluginContentBlog(context, options) {
     const pluginId = (_a = options.id) !== null && _a !== void 0 ? _a : constants_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))}`;
+    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) => {
+            const { include, authorsMapPath } = options;
+            const contentMarkdownGlobs = (0, lodash_1.flatten)((0, blogUtils_1.getContentPathList)(contentPaths).map((contentPath) => {
                 return 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];
+        },
+        async getTranslationFiles() {
+            return (0, translations_1.getTranslationFiles)(options);
         },
         // Fetches blog contents and returns metadata for the necessary routes.
         async loadContent() {
-            const { postsPerPage, routeBasePath } = options;
-            const 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 {
+                    blogSidebarTitle,
                     blogPosts: [],
                     blogListPaginated: [],
                     blogTags: {},
@@ -77,14 +87,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({
@@ -98,48 +108,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,
@@ -150,19 +131,34 @@ 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, 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);
+                : (0, lodash_1.take)(blogPosts, 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,
@@ -174,7 +170,7 @@ function pluginContentBlog(context, options) {
                 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,
@@ -190,7 +186,7 @@ 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,
@@ -220,6 +216,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,
@@ -227,7 +224,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,
@@ -252,7 +249,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,
@@ -264,21 +261,24 @@ function pluginContentBlog(context, options) {
                 });
             }
         },
+        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(content.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 = blogUtils_1.getContentPathList(contentPaths);
+            const contentDirs = (0, blogUtils_1.getContentPathList)(contentPaths);
             return {
                 resolve: {
                     alias: {
@@ -302,16 +302,23 @@ function pluginContentBlog(context, options) {
                                         beforeDefaultRemarkPlugins,
                                         beforeDefaultRehypePlugins,
                                         staticDir: path_1.default.join(siteDir, constants_1.STATIC_DIR_NAME),
-                                        isMDXPartial: utils_1.createAbsoluteFilePathMatcher(options.exclude, contentDirs),
+                                        isMDXPartial: (0, utils_1.createAbsoluteFilePathMatcher)(options.exclude, contentDirs),
                                         metadataPath: (mdxPath) => {
                                             // Note that metadataPath must be the same/in-sync as
                                             // the path from createData for each MDX.
-                                            const aliasedPath = utils_1.aliasedSitePath(mdxPath, siteDir);
-                                            return path_1.default.join(dataDir, `${utils_1.docuHash(aliasedPath)}.json`);
+                                            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, }) => {
+                                            return {
+                                                image: frontMatter.image,
+                                                authorsImageUrls: metadata.authors.map((author) => author.imageURL),
+                                            };
+                                        },
                                     },
                                 },
                                 {
@@ -325,11 +332,10 @@ 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);
+            const feed = await (0, blogUtils_1.generateBlogFeed)(contentPaths, context, options);
             if (!feed) {
                 return;
             }
@@ -346,7 +352,7 @@ function pluginContentBlog(context, options) {
             }));
         },
         injectHtmlTags({ content }) {
-            var _a;
+            var _a, _b;
             if (!content.blogPosts.length) {
                 return {};
             }
@@ -354,17 +360,17 @@ function pluginContentBlog(context, options) {
                 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 = [];
@@ -379,7 +385,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.js

@@ -14,17 +14,17 @@ const markdownLoader = function (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);
 };

package/lib/pluginOptionSchema.d.ts

@@ -5,30 +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[];
-    exclude: 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

@@ -10,7 +10,7 @@ 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: {},
@@ -27,23 +27,27 @@ 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',
 };
 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),
     exclude: utils_validation_1.Joi.array().items(utils_validation_1.Joi.string()).default(exports.DEFAULT_OPTIONS.exclude),
-    postsPerPage: utils_validation_1.Joi.number()
-        .integer()
-        .min(1)
+    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),
@@ -54,7 +58,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),
@@ -75,7 +79,15 @@ 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),
 });

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;

package/lib/types.d.ts

@@ -5,32 +5,43 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { RemarkAndRehypePluginOptions } from '@docusaurus/mdx-loader';
-import { BrokenMarkdownLink, ContentPaths } from '@docusaurus/utils/lib/markdownLinks';
+import type { Tag } from '@docusaurus/utils';
+import type { BrokenMarkdownLink, ContentPaths } from '@docusaurus/utils/lib/markdownLinks';
+import { Overwrite } from 'utility-types';
 export declare type BlogContentPaths = ContentPaths;
 export interface BlogContent {
+    blogSidebarTitle: string;
     blogPosts: BlogPost[];
     blogListPaginated: BlogPaginated[];
     blogTags: BlogTags;
     blogTagsListPath: string | null;
 }
-export interface DateLink {
-    date: Date;
-    link: string;
-}
 export declare type FeedType = 'rss' | 'atom';
+export declare type FeedOptions = {
+    type?: FeedType[] | null;
+    title?: string;
+    description?: string;
+    copyright: string;
+    language?: string;
+};
+export declare type UserFeedOptions = Overwrite<Partial<FeedOptions>, {
+    type?: FeedOptions['type'] | 'all';
+}>;
 export declare type EditUrlFunction = (editUrlParams: {
     blogDirPath: string;
     blogPath: string;
     permalink: string;
     locale: string;
 }) => string | undefined;
-export interface PluginOptions extends RemarkAndRehypePluginOptions {
+export declare type PluginOptions = RemarkAndRehypePluginOptions & {
     id?: string;
     path: string;
     routeBasePath: string;
+    tagsBasePath: string;
+    archiveBasePath: string;
     include: string[];
     exclude: string[];
-    postsPerPage: number;
+    postsPerPage: number | 'ALL';
     blogListComponent: string;
     blogPostComponent: string;
     blogTagsListComponent: string;
@@ -42,7 +53,7 @@ export interface PluginOptions extends RemarkAndRehypePluginOptions {
     truncateMarker: RegExp;
     showReadingTime: boolean;
     feedOptions: {
-        type?: [FeedType] | null;
+        type?: FeedType[] | null;
         title?: string;
         description?: string;
         copyright: string;
@@ -51,7 +62,11 @@ export interface PluginOptions extends RemarkAndRehypePluginOptions {
     editUrl?: string | EditUrlFunction;
     editLocalizedFiles?: boolean;
     admonitions: Record<string, unknown>;
-}
+    authorsMapPath: string;
+};
+export declare type UserPluginOptions = Overwrite<Partial<PluginOptions>, {
+    feedOptions?: UserFeedOptions;
+}>;
 export interface BlogTags {
     [key: string]: BlogTag;
 }
@@ -63,6 +78,7 @@ export interface BlogTag {
 export interface BlogPost {
     id: string;
     metadata: MetaData;
+    content: string;
 }
 export interface BlogPaginatedMetadata {
     permalink: string;
@@ -79,28 +95,35 @@ export interface BlogPaginated {
     metadata: BlogPaginatedMetadata;
     items: string[];
 }
+export interface Author extends Record<string, unknown> {
+    name?: string;
+    imageURL?: string;
+    url?: string;
+    title?: string;
+}
 export interface MetaData {
     permalink: string;
     source: string;
     description: string;
     date: Date;
     formattedDate: string;
-    tags: (Tag | string)[];
+    tags: Tag[];
     title: string;
     readingTime?: number;
     prevItem?: Paginator;
     nextItem?: Paginator;
     truncated: boolean;
     editUrl?: string;
+    authors: Author[];
+}
+export interface Assets {
+    image?: string;
+    authorsImageUrls: (string | undefined)[];
 }
 export interface Paginator {
     title: string;
     permalink: string;
 }
-export interface Tag {
-    label: string;
-    permalink: string;
-}
 export interface BlogItemsToMetadata {
     [key: string]: MetaData;
 }