Search
Zudoku offers search functionality that enhances user experience by enabling content discovery across your site. When configured, a search bar will appear in the header, allowing users to quickly find relevant information on any page.
We currently support two search providers:
Pagefind
Pagefind is a lightweight, static search library that can be used to add search to your Zudoku site without any external services.
To enable pagefind search, configure the search
option in your configuration:
Code(typescript)
Transforming/Filtering Search Results
You can transform or filter search results using the transformResults
option. This function receives the search result along with the current auth state and context, allowing you to:
- Filter results based on user permissions
- Modify result content
- Add custom results
The type of result
is the same as the type returned by Pagefind's search API.
Code(typescript)
For more information about how Pagefind's ranking system works and how to customize it for your content, see the Pagefind ranking documentation.
Inkeep
Inkeep is an AI-powered search and chat platform that can index your documentation and provide intelligent search capabilities to your users.
Setting up Inkeep Integration
Before you can use Inkeep search in your Zudoku site, you need to set up an Inkeep integration and have your site indexed. Here's how to get started:
1. Create an Inkeep Account
- Go to Inkeep and sign up for an account
- Navigate to the Inkeep Portal
2. Set up Site Indexing
- In the Inkeep Portal, create a new project or integration
- Configure your site URL so Inkeep can crawl and index your documentation
- Ensure your Zudoku site is deployed and publicly accessible for indexing
- Wait for Inkeep to crawl and index your site content (this may take some time)
3. Get Your Integration Credentials
To add Inkeep search to your site you will need to copy some variables from your Inkeep account setting:
- API Key
- Integration ID
- Organization ID
4. Configure Zudoku
Once you have your credentials and your site is indexed, you can configure the search
option in your Zudoku Configuration:
Code(typescript)