VitePress 相关配置
VitePress 是一个基于 Vue 的静态网站生成器,专为构建技术文档而设计。它提供了现代化的开发体验和丰富的功能,是替代传统文档工具的理想选择。
一、默认主题样式调整
通过自定义 CSS 样式,可以调整 VitePress 默认主题的外观,使其更符合项目需求。
在 .vitepress/theme/reset.css 文件中添加以下样式:
二、本地搜索修改为中文
将 VitePress 的本地搜索功能修改为中文界面,提升用户体验。
在 themeConfig 中添加以下配置:
三、项目 defineConfig 配置
在
.vitepress/config.mts文件中进行项目的基本配置,包括标题、导航、侧边栏等。
四、vitepress-theme-demoblock 插件
vitepress-theme-demoblock 是一个用于 VitePress 的插件,可以方便地在文档中展示 Vue 组件示例和代码。
五、主题自定义配置
自定义主题 通过创建自定义主题文件,可以进一步扩展 VitePress 的功能,例如添加 Live2D 宠物等交互元素。
在 .vitepress/theme/index.js 文件中添加以下配置:
note Live2D 模型 以下是可用的 Live2D 模型链接,可以根据需要选择:
- hijiki:
https://unpkg.com/live2d-widget-model-hijiki@1.0.5/assets/hijiki.model.json- tororo:
https://unpkg.com/live2d-widget-model-tororo@1.0.5/assets/tororo.model.json- koharu:
https://unpkg.com/live2d-widget-model-koharu@1.0.5/assets/koharu.model.json- chitose:
https://unpkg.com/live2d-widget-model-chitose@1.0.5/assets/chitose.model.json- shizuku:
https://unpkg.com/live2d-widget-model-shizuku@1.0.5/assets/shizuku.model.json- hibiki:
https://unpkg.com/live2d-widget-model-hibiki@1.0.5/assets/hibiki.model.json- wanko:
https://unpkg.com/live2d-widget-model-wanko@1.0.5/assets/wanko.model.json- unitychan:
https://unpkg.com/live2d-widget-model-unitychan@1.0.5/assets/unitychan.model.json- nico:
https://unpkg.com/live2d-widget-model-nico@1.0.5/assets/nico.model.json- izumi:
https://unpkg.com/live2d-widget-model-izumi@1.0.5/assets/izumi.model.json- nipsilon:
https://unpkg.com/live2d-widget-model-nipsilon@1.0.5/assets/nipsilon.model.json- nito:
https://unpkg.com/live2d-widget-model-nito@1.0.5/assets/nito.model.json
Live2D 插件可能会影响页面加载性能,建议在生产环境中谨慎使用,并确保有足够的延迟加载时间。

