博客功能介绍

Mr.Hope ... 2021年3月6日 22:49 Blog
  • Blog
  • Intro
大约 1 分钟

主题通过引入 @vuepress/plugin-blog 默认启用了一些博客功能。

如果你不需要任何的博客功能 (比如一个纯文档站点),你可以配置 themeConfig.blogfalse 来禁用全部的博客功能。

# 综述

总体上,通过启用博客功能,主题允许你通过页面的 frontmatter,为页面配置分类、标签、是否是文章、是否出现在时间线中、收藏、置顶等功能。

同时主题还为你提供了 博客风格的主页

# 侧边栏

主题提供了一个博客相关的侧边栏。该侧边栏会在博客相关的页面显示 (在桌面会显示在右侧,在移动视图下收起到侧边栏中)

你可以通过 themeConfig.blog.sidebarDisplay 控制该侧边栏在非博客相关的页面的显示行为。可选的值有 'mobile' | 'none' | 'always'。默认为 mobile,即当你在移动视图下访问非博客相关的页面时,你也可以在侧边栏看到它。

# 分页配置

对于所有页面的文章列表,我们都会在底部显示一个分页组件。你可以通过这个组件快捷的在首页、尾页、前后两页进行跳转。你也可以输入数字跳转到指定页面。

默认每个分页的文章数为 10,你可以设置 themeConfig.blog.perPage 来覆盖它。

# 注意事项

注意

请勿在根目录中添加并放置对应的文件夹("article", "slide", "star", "encrypt", "category", "tag", "timeline"),否则可能造成编译时文件被覆盖而造成错误。

比如你的确需要一个“文章”文件夹的话,请考虑使用 "articles"。