博客功能介绍

主题通过内置的 @vuepress/plugin-blog 提供博客功能。该功能默认禁用，在主题选项中设置 plugins.blog: true 即可启用。

页面配置

你可以通过页面的 Frontmatter 配置文章分类、标签、时间线可见性、收藏（star）以及置顶（sticky）状态。

提示

访问演示站点 预览博客功能。

UI 组件

侧边栏

博客信息侧边栏在桌面端显示于页面右侧，在移动端会自动收起至主导航侧边栏中。

分页

文章列表底部会渲染分页组件。默认每页显示 10 篇文章。你可以通过配置主题选项中的 blog.articlePerPage 来覆盖此设置。

多语言支持

通过主题选项中的 locales，你可以为不同语言设置独立的博客配置。各语言环境下的文章列表和时间线均保持严格隔离与独立。

限制与注意事项

热更新 (HMR) 机制

出于性能考量，开发服务器（devServer）默认禁用博客元数据（如分类、时间、标签、置顶、收藏等）的热更新。你需要重启开发服务器才能应用这些元数据的变更。

此外，对 Markdown 内容敏感的指标（如阅读时间和字数统计）同样不会实时生效。

如果强制要求实时更新，请设置 hotReload: true。需要注意的是，每次修改都会触发页面完整刷新与底层重计算逻辑，并可能导致短暂的白屏现象。