搜索

[params.search]
  # 说明：启用搜索按钮与搜索弹窗。
  enable = true
  # 说明：加载构建流程生成的 /pagefind/<language>/pagefind.js。
  provider = 'pagefind'

[params.search]
  # 说明：启用搜索弹窗。
  enable = true
  # 说明：把前端搜索 provider 切换为 Meilisearch REST 搜索。
  provider = 'meilisearch'

  [params.search.meilisearch]
    # 说明：公开的 Meilisearch 访问地址，不要带结尾斜杠。
    host = 'https://search.example.com'
    # 说明：只能使用 Search API Key，禁止在前端暴露 master key 或 admin key。
    apiKey = 'search-only-public-key'
    # 说明：存放当前站点或当前语言文档的索引 UID。
    indexUid = 'tralume_posts_zh'

[params.search.meilisearch]
  # 说明：把结果标题映射到你的索引字段。
  titleAttribute = 'headline'
  # 说明：把结果链接映射到你的索引字段。
  urlAttribute = 'permalink'
  # 说明：映射显示在标题下方的简短元信息。
  metaAttribute = 'category'
  # 说明：让 Meilisearch 从这些字段中裁剪摘要。
  excerptAttributes = ['body', 'summary']

[params.search.meilisearch]
  # 说明：搜索弹窗最多展示多少条结果。
  limit = 20
  # 说明：Meilisearch 返回摘要时最多保留多少个词。
  cropLength = 24
  # 说明：限制返回字段；这些字段必须属于 Meilisearch 的 displayedAttributes。
  attributesToRetrieve = ['title', 'url', 'content', 'section']
  # 说明：限制参与搜索的字段；这些字段必须属于 Meilisearch 的 searchableAttributes。
  attributesToSearchOn = ['title', 'content']
  # 说明：可选过滤表达式；被过滤字段必须属于 Meilisearch 的 filterableAttributes。
  filter = 'lang = "zh-Hans"'
  # 说明：可选排序规则；被排序字段必须属于 Meilisearch 的 sortableAttributes。
  sort = ['date:desc']
  # 说明：可选查询匹配策略，取值需由 Meilisearch 支持。
  matchingStrategy = 'last'
  # 说明：可选高亮字段；匹配到的词条会被 <em> 标签包裹。
  highlightAttributes = ['title', 'content']

[params.search.meilisearch]
  # 说明：当每个 Hugo 语言都有独立 params 覆盖时，可使用语言专属索引。
  indexUid = 'tralume_posts_zh'

[params.search.meilisearch]
  # 说明：共用同一索引，并用文档中的 lang 字段过滤当前语言。
  indexUid = 'tralume_posts'
  filter = 'lang = "zh-Hans"'

[params.search.meilisearch]
  # 说明：帮助 Meilisearch 为查询选择预期的语言分析器。
  locales = ['zh']

# 说明：为单个索引创建权限收窄的 Search API Key。
# 注意：这条命令只能在可信机器上配合 master key 执行，不能放进浏览器代码。
curl -X POST "${MEILISEARCH_URL}/keys" \
  -H "Authorization: Bearer ${MEILISEARCH_MASTER_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Tralume frontend search",
    "actions": ["search"],
    "indexes": ["tralume_posts_zh"],
    "expiresAt": null
  }'