What is @docusaurus/plugin-content-blog?
@docusaurus/plugin-content-blog is a plugin for Docusaurus, a static site generator. This plugin allows you to create and manage a blog within your Docusaurus site. It provides features like blog post creation, pagination, tags, and more.
What are @docusaurus/plugin-content-blog's main functionalities?
Create Blog Posts
This feature allows you to create and manage blog posts in Markdown or MDX format. The configuration specifies the path to the blog directory, the route base path, and other settings like the blog title and description.
module.exports = {
plugins: [
[
'@docusaurus/plugin-content-blog',
{
path: './blog',
routeBasePath: '/blog',
include: ['*.md', '*.mdx'],
blogTitle: 'My Blog',
blogDescription: 'A Docusaurus powered blog!',
},
],
],
};
Pagination
This feature enables pagination for your blog posts. You can specify the number of posts per page using the `postsPerPage` option.
module.exports = {
plugins: [
[
'@docusaurus/plugin-content-blog',
{
path: './blog',
routeBasePath: '/blog',
postsPerPage: 10,
},
],
],
};
Tags
This feature allows you to categorize your blog posts using tags. The configuration can also include options to show reading time and customize the blog sidebar.
module.exports = {
plugins: [
[
'@docusaurus/plugin-content-blog',
{
path: './blog',
routeBasePath: '/blog',
showReadingTime: true,
blogSidebarCount: 'ALL',
blogSidebarTitle: 'All posts',
},
],
],
};
Other packages similar to @docusaurus/plugin-content-blog
hexo
Hexo is a fast, simple, and powerful blog framework. It provides a wide range of features for creating and managing blogs, including support for Markdown, extensive theming options, and plugins for additional functionalities. Unlike @docusaurus/plugin-content-blog, Hexo is a standalone framework rather than a plugin for a static site generator.
jekyll
Jekyll is a static site generator focused on blogging. It offers features like Markdown support, templates, and plugins. Jekyll is highly customizable and is often used for GitHub Pages. While it provides similar blogging functionalities, it is a standalone tool rather than a plugin for another static site generator like @docusaurus/plugin-content-blog.
2.0.0-alpha.30 (2019-10-22)
- Fix babel transpilation include/exclude logic to be more efficient. This also fix a very weird bug
TypeError: Cannot assign to read only property 'exports' of object '#<Object>'
.(#1868)
If you are still encountering the error. Please check whether you use module.exports
for your .js
file instead of doing export
(mixing CJS and ES). See https://github.com/webpack/webpack/issues/4039#issuecomment-477779322 and https://github.com/webpack/webpack/issues/4039#issuecomment-273804003 for more context.