指南

提示

如果你在使用过程中遇到了 bug，可以 提一个 issue (opens new window) 或者 加入 QQ 群 (opens new window) (群号: 1003437555) 进行反馈。

✨ 主题特点

主题很大程度上保持了 VuePress 默认主题的风格，并在此基础上添加了大量功能与优化:

Markdown

为 Markdown 添加了更多语法，丰富文档与博客写作

• 徽章 <Badge /> 在官方基础上增加了颜色支持
• 代码组 <CodeGroup />
• Tex 支持
• 自定义对齐
• 流程图
• Mermaid 图表
• 标记
• 任务列表
• 上下角标
• 代码演示
• 幻灯片

布局

• 新增:

  • 路径导航

  • 自定义页脚

• 其他内置组件优化

  • 导航栏 与 侧边栏 添加 prefix 与 icon

  • 默认主页增强

    • 特性拥有全新动画并支持跳转
    • 多个动作按钮
    • 宽屏布局优化

界面

• 全新主题色，允许你在浏览过程中动态切换

• 深色模式，允许你手动切换或者是根据设备设置自动应用

• 图标支持

• 全屏按钮

• 返回顶部按钮

页面增强

• 一键复制代码

• 图片预览，支持放大，拖拽，滑动浏览，分享和下载

• 版权信息

• 评论系统

• 文章信息展示

  • 阅读量统计
  • 作者与写作日期
  • 自动生成的字数与预计阅读时间
  • 标签与分类

• 加密特定文章或路径

功能

• PWA 支持

• Feed 生成

• SEO 增强

• Sitemap 生成

• 利用 Git 的信息生成

• TypeScript 支持

博客

• 社交关注按钮与页面社交分享 (opens new window)

• 支持置顶的文章列表

• 标签分组列表

• 时间线

• 收藏文章

• 全新博客主页布局

🧩 内建插件

本主题还包含了以下内建插件，如果有需要，你也可以单独进行使用或搭配其他主题。

• @mr-hope/vuepress-plugin-comment (opens new window): 评论与文章信息功能

• @mr-hope/vuepress-plugin-components (opens new window): 提供一些开箱即用的插件

• @mr-hope/vuepress-plugin-copy-code (opens new window): 提供一键复制代码块功能。

• @mr-hope/vuepress-plugin-feed (opens new window): Feed 支持

• @mr-hope/vuepress-plugin-git (opens new window): 基于 Git 的页面信息插件

• @mr-hope/vuepress-plugin-pwa (opens new window): PWA 支持

• @mr-hope/vuepress-plugin-reading-time (opens new window): 阅读时间与字数统计

• @mr-hope/vuepress-plugin-seo (opens new window): SEO 增强插件

• @mr-hope/vuepress-plugin-sitemap (opens new window): 为你的站点生成 sitemap

• @mr-hope/vuepress-plugin-smooth-scroll: 启用平滑滚动 (移除了旧浏览器兼容)

• vuepress-plugin-active-hash (opens new window): 自动激活锚点

• vuepress-plugin-add-this (opens new window): 让网站支持社交分享与关注

• vuepress-plugin-md-enhance (opens new window): 提供更多 Markdown 语法

• vuepress-plugin-photo-swipe (opens new window): 使网站的图片支持缩放与滑动浏览