使用插件
安装
pnpm add -D vuepress-plugin-blog2
yarn add -D vuepress-plugin-blog2
npm i -D vuepress-plugin-blog2
使用
// .vuepress/config.ts
import { blogPlugin } from "vuepress-plugin-blog2";
export default {
plugins: [
blogPlugin({
//插件选项
}),
],
};
// .vuepress/config.js
import { blogPlugin } from "vuepress-plugin-blog2";
export default {
plugins: [
blogPlugin({
//插件选项
}),
],
};
从 V1 迁移
此插件未发布 V1 版本。
如果你在 VuePress1 中使用了 @vuepress/plugin-blog
,你应该了解这个插件的受众与 @vuepress/plugin-blog
完全不同。
@vuepress/plugin-blog
更像是一个针对用户的博客工具集合。它为你提供了使用 frontmatter、dir 和其他条件进行过滤的详细选项。此外,它还附带了 Feed、Sitemap、mailchimp、分页和其他博客相关功能。总体来说,你可以使用复杂的选项获得所需的集合,并且结果会在全局范围内注入 Vue 组件,并提供分页。
然而,
vuepress-plugin-blog2
是针对主题开发者的,并且只有 < 1kb Gzipped 的客户端大小。由于 VuePress2 出于可扩展性的原因,
siteData.pages
不再可用,该插件仅将 Node 侧将它们注入到 routeMeta 并提供组合 API 供你在客户端获取它们。同时,它不提供任何相关功能,例如分页、feed、sitemap。总体来说,你需要编写函数从页面对象返回内容来获取文章信息,同时自己配置所需的分类和类别;在客户端,你只能通过 API 拿到其他数据,需要自己处理分页相关功能,以及引用其他插件来提供其他博客功能。