搜索

搜索功能默认启用，由 Pagefind 提供支持——一个静态的、构建时索引引擎。无需任何配置。

工作原理

在 astro build 之后，Nimbus 会对输出目录 dist/ 运行 Pagefind，并将搜索索引写入页面旁边。索引以静态方式提供服务，因此搜索可在任何无后端的主机上运行。

将 Pagefind 安装为开发依赖，以便构建步骤能找到它：

npm i pagefind

yarn add pagefind

pnpm add pagefind

bun add pagefind

控制索引内容

页面是否纳入搜索索引取决于 noindex 字段，除非你显式设置了 searchable：

---
title: Internal note
noindex: true        # 不被搜索引擎收录……
searchable: true     # ……但仍可在站内搜索中找到
---

draft: true 的页面永远不会被索引。详见 Frontmatter。

禁用或替换搜索

完全关闭框架的搜索功能：

nimbus({ /* … */, search: false });

或者保留 UI 但提供自定义后端（Algolia、托管服务等），只需实现 SearchProvider 接口并设置 search: { provider: "custom" }——Nimbus 会跳过 Pagefind 构建步骤，由你的代码来渲染搜索结果。