0%
Skip to content

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'], // 排除不必要的元素
            })
        ]
    }

})

效果

速度快,索引强