bookdown如何切换为fuse搜索引擎并设置相关参数

解决方法 #

• 确认bookdown版本符合要求
  运行packageVersion("bookdown")查看本地安装版本，gitbook格式的fuse搜索引擎支持从0.23版本才正式上线，版本低于要求的话执行install.packages("bookdown")升级到最新稳定版。
• 彻底清理缓存后重新编译
  旧编译产物残留会导致配置不生效，先删除整个_book输出目录，以及项目下所有带_cache后缀的缓存文件夹，再重新执行bookdown编译，避免旧的plugin-search.js文件沿用之前的配置。
• 补全fuse搜索参数
  你当前的配置缺少实现多关键词无序全匹配的核心配置项，需要将search下的options调整为：

  options: 
    isCaseSensitive: false
    threshold: 0.0
    matchAllTokens: true
    ignoreLocation: true
    minMatchCharLength: 2
  

  其中matchAllTokens: true要求返回结果必须包含所有输入关键词，ignoreLocation: true取消关键词的位置顺序限制，完全匹配你的需求。
• 检查YAML缩进格式
  YAML对缩进要求严格，所有子层级配置项统一缩进2个空格，不要使用制表符，缩进错误会直接导致配置无法被识别。

如果调整后gitbook格式的fuse引擎仍然无法生效，直接改用bookdown::bs4_book输出格式即可，该格式默认使用fuse作为搜索引擎，无需额外配置就能实现你需要的搜索效果。

内容的提问来源于stack exchange，提问作者Floris Padt