主题介绍
主题初衷
VuePress 在一定程度上扩展了 Markdown 语法,但仍然缺少一些常用的功能,例如文本对齐、标记、流程图、公式、演示等,同时默认主题提供的一些功能较弱或缺失,如图片预览、代码块复制、目录页等。同时 VuePress 默认主题太简陋,功能不够强大。在这种情况下,vuepress-theme-hope
和一些系列插件就应运诞生。
与默认主题相比,我们不仅大大改进了美观度,而且通过主题插件为 VuePress 提供了全方位的增强功能。
设计目标
强大且独立的功能
我们将每个功能提取到一个插件中,以便用户可以在其他主题中使用它们或单独自定义它们的行为。
最小化配置
如果可能,所有功能都会尝试使用默认值,因此你可以在零配置或最小配置下使用它们。
这有助于减少你的迁移或学习成本,同时直接享受它们的便利。
改进的布局
主题界面已经完全重构,以提供可定制和漂亮的布局。
可拆分
借助 Vue3 的组合 API,主题在保持强大的同时充分实现了“Tree-shaking”。
主题将只运行你想要的功能,而不会因其他功能而变慢或影响打包大小。
因何强大
更丰富的内容
主题为 Markdown 提供了大量的扩展语法支持,让你在正文插入更多的内容。
我们对 图片进行了一些内置增强。
如果你是一名程序员需要大量展示代码与 demo,本主题为代码块提供了浅色与深色两种主题,代码组 与 代码块复制按钮。同时我们还提供 代码演示,Playground Kotlin Playground 和 Vue Playground 功能,方便你展示自己的 Vue、React 组件或者其他 demo。
如果你需要提供产品文档与展示,主题提供了 选项卡、幻灯片、图表、echarts、流程图、 Mermaid 图表 与 Plant UML 功能。
为了重新组织你的内容,主题提供了文件包含功能。
总之,任何人都可以享受 Markdown 增强语法带来的便利。
UI 改进
布局改进
页面元数据
页面信息 包括:
- 作者
- 书写日期
- 字数统计和预计阅读时间
- 标签和类别
- 浏览量
功能
完整的博客支持
该主题支持博客,有置顶功能的文章列表,星标文章,自动摘录生成,自动摘要。
内置插件 🧩
本主题包含了以下内建插件,如果有需要,你也可以单独进行使用或搭配其他主题。
- vuepress-plugin-components
: 提供一些开箱即用的插件 - vuepress-plugin-md-enhance
: 提供更多 Markdown 语法
提示
这里还有一些其他没有被主题捆绑的插件,你可以根据自己的需求自行启用。
- vuepress-plugin-lightgallery
: 基于 lightgallery 图片浏览插件 - vuepress-plugin-search-pro
: 客户端搜索插件