vitepress替换默认搜索本地方案
- 默认搜索比较慢且支持不是很好,有多种替换方案,
- 这里使用插件
vitepress-plugin-pagefind
,该插件不依赖第三方,实时性强,推荐使用- 当然也可以申请
Algolia
的在线搜索服务
安装和配置插件
安装
bash
npm install vitepress-plugin-pagefind
配置
.vitepress\config.js
- 记得移除默认的搜索
js
import { defineConfig } from 'vitepress'
import { pagefindPlugin, chineseSearchOptimize } from 'vitepress-plugin-pagefind'
export default defineConfig({
// 使用 Pagefind 插件
vite: {
plugins: [
pagefindPlugin({
btnPlaceholder: '搜索', // 搜索按钮上的文字
placeholder: '搜索文档内容...', // 搜索框的占位符
emptyText: '没有找到相关内容', // 搜索无结果的提示
heading: '共找到 {{searchResult}} 条结果', // 搜索结果标题
customSearchQuery: chineseSearchOptimize, // 优化中文分词
forceLanguage: 'zh-cn', // 强制使用中文策略
excludeSelector: ['img', 'a.header-anchor'], // 排除不必要的元素
})
]
}
})
效果
速度快,索引强