92 lines
2.8 KiB
Markdown
92 lines
2.8 KiB
Markdown
|
# How can I customize the `kbar` search?
|
||
|
|
||
|
Add a `SearchProvider` component such as the one shown below and use it in place of the default `SearchProvider` component in `app/layout.tsx`.
|
||
|
|
||
|
`defaultActions` are the initial list of actions.
|
||
|
|
||
|
`onSearchDocumentsLoad` is a callback function that is called when the documents specified by `searchDocumentsPath` are loaded. Set `searchDocumentsPath` to `false` to disable the dynamically loaded search feature.
|
||
|
|
||
|
```tsx
|
||
|
'use client'
|
||
|
|
||
|
import { KBarSearchProvider } from 'pliny/search/KBar'
|
||
|
import { useRouter } from 'next/navigation'
|
||
|
import { CoreContent } from 'pliny/utils/contentlayer'
|
||
|
import { Blog } from 'contentlayer/generated'
|
||
|
|
||
|
export const SearchProvider = ({ children }) => {
|
||
|
const router = useRouter()
|
||
|
return (
|
||
|
<KBarSearchProvider
|
||
|
kbarConfig={{
|
||
|
searchDocumentsPath: 'search.json',
|
||
|
defaultActions: [
|
||
|
{
|
||
|
id: 'homepage',
|
||
|
name: 'Homepage',
|
||
|
keywords: '',
|
||
|
shortcut: ['h', 'h'],
|
||
|
section: 'Home',
|
||
|
perform: () => router.push('/'),
|
||
|
},
|
||
|
{
|
||
|
id: 'projects',
|
||
|
name: 'Projects',
|
||
|
keywords: '',
|
||
|
shortcut: ['p'],
|
||
|
section: 'Home',
|
||
|
perform: () => router.push('/projects'),
|
||
|
},
|
||
|
],
|
||
|
onSearchDocumentsLoad(json) {
|
||
|
return json.map((post: CoreContent<Blog>) => ({
|
||
|
id: post.path,
|
||
|
name: post.title,
|
||
|
keywords: post?.summary || '',
|
||
|
section: 'Blog',
|
||
|
subtitle: post.tags.join(', '),
|
||
|
perform: () => router.push('/' + post.path),
|
||
|
}))
|
||
|
},
|
||
|
}}
|
||
|
>
|
||
|
{children}
|
||
|
</KBarSearchProvider>
|
||
|
)
|
||
|
}
|
||
|
```
|
||
|
|
||
|
You can even choose to do a full text search over the entire generated blog content though this would come at the expense of a larger search index file by modifying the `createSearchIndex` function in `contentlayer.config.ts` to:
|
||
|
|
||
|
```tsx
|
||
|
function createSearchIndex(allBlogs) {
|
||
|
if (
|
||
|
siteMetadata?.search?.provider === 'kbar' &&
|
||
|
siteMetadata.search.kbarConfig.searchDocumentsPath
|
||
|
) {
|
||
|
writeFileSync(
|
||
|
`public/${siteMetadata.search.kbarConfig.searchDocumentsPath}`,
|
||
|
JSON.stringify((sortPosts(allBlogs)))
|
||
|
)
|
||
|
console.log('Local search index generated...')
|
||
|
}
|
||
|
}
|
||
|
```
|
||
|
|
||
|
Note the change from `JSON.stringify(allCoreContent(sortPosts(allBlogs)))` to `JSON.stringify((sortPosts(allBlogs)))`.
|
||
|
|
||
|
Next, in the modified `SearchProvider`, dump the raw content to the `keywords` field in the `onSearchDocumentsLoad` prop:
|
||
|
|
||
|
```tsx
|
||
|
onSearchDocumentsLoad(json) {
|
||
|
return json.map((post: Blog) => ({
|
||
|
id: post.path,
|
||
|
name: post.title,
|
||
|
keywords: post.body.raw,
|
||
|
section: 'Blog',
|
||
|
subtitle: post.tags.join(', '),
|
||
|
perform: () => router.push('/' + post.path),
|
||
|
}))
|
||
|
}
|
||
|
```
|