离线环境下如何对Antora生成站点执行精确短语搜索

目前Antora生态已经有成熟的可离线使用的搜索扩展，不需要对接后端服务，生成的纯静态站点本地打开就能用，具体可选方案和配置方式如下：

• 官方维护方案：@antora/lunr-extension
  这是Antora官方团队维护的原生搜索扩展，完全适配Antora 3.x及以上版本，构建时会自动把全量文档索引打包到静态资源中，零后端依赖支持离线使用。
  安装扩展后，在你的Antora playbook配置文件中增加以下参数，即可开启精确短语搜索能力，关闭默认的模糊拆词匹配：

antora:
  extensions:
    - require: '@antora/lunr-extension'
      config:
        exact_phrase_boost: 10
        search_options:
          distance: 0
          prefix_length: 999

配置完成后重新执行构建命令，生成的站点搜索框会优先返回和输入短语完全匹配的内容，不会出现关键词拆分后无关内容排在前面的问题。如果需要强制只返回精确匹配结果，可以额外增加配置项require_exact_phrase_match: true，此时只要输入的短语没有在文档中连续出现，就不会返回对应结果。

• 多语言场景适配方案：社区离线分词搜索扩展
  如果你的文档包含中文、日文等非拉丁语系内容，官方lunr扩展默认的分词逻辑无法正确识别连续短语，可以使用社区适配了对应语种分词器的离线搜索扩展，这类扩展同样是纯静态构建无后端依赖，配置时开启exact_match_only开关即可实现非拉丁语系的精确短语搜索。

注意：所有离线搜索扩展的索引都是在Antora构建阶段生成的，文档内容更新后必须重新执行构建命令重建索引，否则搜索结果不会同步。不要选用需要对接外部搜索服务的扩展，这类扩展在本地离线打开静态站点时会因为跨域限制、服务不可用完全无法工作。

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