feat(v2): support custom description for blog-only mode

packages/docusaurus-plugin-content-blog/src/index.ts

@@ -133,6 +133,7 @@ export default function pluginContentBlog(
               page < numberOfPages - 1
                 ? blogPaginationPermalink(page + 1)
                 : null,
+            blogDescription: options.blogDescription,
           },
           items: blogPosts
             .slice(page * postsPerPage, (page + 1) * postsPerPage)

packages/docusaurus-plugin-content-blog/src/pluginOptionSchema.ts

@@ -20,6 +20,7 @@ export const DEFAULT_OPTIONS = {
   blogTagsListComponent: '@theme/BlogTagsListPage',
   blogPostComponent: '@theme/BlogPostPage',
   blogListComponent: '@theme/BlogListPage',
+  blogDescription: '',
   postsPerPage: 10,
   include: ['*.md', '*.mdx'],
   routeBasePath: 'blog',
@@ -42,6 +43,9 @@ export const PluginOptionSchema = Joi.object({
   blogTagsPostsComponent: Joi.string().default(
     DEFAULT_OPTIONS.blogTagsPostsComponent,
   ),
+  blogDescription: Joi.string()
+    .allow('')
+    .default(DEFAULT_OPTIONS.blogDescription),
   showReadingTime: Joi.bool().default(DEFAULT_OPTIONS.showReadingTime),
   remarkPlugins: Joi.array()
     .items(

packages/docusaurus-plugin-content-blog/src/types.ts

@@ -29,6 +29,7 @@ export interface PluginOptions {
   blogPostComponent: string;
   blogTagsListComponent: string;
   blogTagsPostsComponent: string;
+  blogDescription: string;
   remarkPlugins: ([Function, object] | Function)[];
   rehypePlugins: string[];
   truncateMarker: RegExp;
@@ -67,6 +68,7 @@ export interface BlogPaginatedMetadata {
   totalCount: number;
   previousPage: string | null;
   nextPage: string | null;
+  blogDescription: string;
 }
 
 export interface BlogPaginated {

packages/docusaurus-theme-classic/src/theme/BlogListPage/index.tsx

@@ -13,7 +13,7 @@ import BlogPostItem from '@theme/BlogPostItem';
 import BlogListPaginator from '@theme/BlogListPaginator';
 
 type Props = {
-  metadata: {permalink: string; title: string};
+  metadata: {permalink: string; title: string; blogDescription: string};
   items: {content}[];
 };
 
@@ -24,10 +24,10 @@ function BlogListPage(props: Props): JSX.Element {
   } = useDocusaurusContext();
   const isBlogOnlyMode = metadata.permalink === '/';
   const title = isBlogOnlyMode ? siteTitle : 'Blog';
-
+  const {blogDescription} = metadata;
   return (
-    <Layout title={title} description="Blog">
-      <div className="container margin-vert--lg">
+    <Layout title={title} description={blogDescription}>
+      <div className="container margin-vert--xl">
         <div className="row">
           <main className="col col--8 col--offset-2">
             {items.map(({content: BlogPostContent}) => (

website/docs/blog.md

@@ -163,6 +163,24 @@ Don't forget to delete the existing homepage at `./src/pages/index.js` or else t
 
 :::
 
+You can also add meta description to the blog list page for better SEO:
+
+```js {8} title="docusaurus.config.js"
+module.exports = {
+  // ...
+  presets: [
+    [
+      '@docusaurus/preset-classic',
+      {
+        blog: {
+          blogDescription: 'A docusuarus powered blog!',
+        },
+      },
+    ],
+  ],
+};
+```
+
 ### Multiple blogs
 
 By default, the classic theme assumes only one blog per website and hence includes only one instance of the blog plugin. If you would like to have multiple blogs on a single website, it's possible too! You can add another blog by specifying another blog plugin in the `plugins` option for `docusaurus.config.js`.

website/docs/using-plugins.md

@@ -200,6 +200,10 @@ module.exports = {
          */
         editUrl:
           'https://github.com/facebook/docusaurus/edit/master/website/blog/',
+        /**
+         * Blog page meta description for better SEO
+         */
+        blogDescription: '',
         /**
          * URL route for the blog section of your site.
          * *DO NOT* include a trailing slash.