Search

Using Algolia DocSearch

Docuo has official support for Algolia DocSearch.

The service is free for any developer documentation or technical blog: just make sure to read the checklist and apply to the DocSearch program.

DocSearch crawls your website once a week (the schedule is configurable from the web interface) and aggregates all the content in an Algolia index. This content is then queried directly from your front-end using the Algolia API.

If your website is not eligible for the free, hosted version of DocSearch, or if your website sits behind a firewall and is not public, then you can run your own DocSearch crawler.

Index Configuration

After your application has been approved and deployed, you will receive an email with all the details for you to add DocSearch to your project. Editing and managing your crawls can be done via the web interface. Indices are readily available after deployment, so manual configuration usually isn't necessary.

Modifying Crawler Configuration

Next you need to modify the crawl configuration as follows to ensure that you can crawl to all pages of your site.

1. Log in to crawlers background.
2. Select the corresponding crawler.

3. Go to Editor page

4. Enter the sitemap file address, which is "YOUR DOMAIN/sitemap.xml".

5. Crawling the page again.

Connecting Algolia

Add an algolia field in your search. Apply for DocSearch to get your Algolia index and API key.

{
  // ...
  "search": {
    "algolia": {
      "appId": "YOUR_APP_ID",
      "apiKey": "YOUR_API_KEY",
      "indexName": "YOUR_INDEX_NAME"
    }
  }
}

Manage layout

If you don't need the search function on your website, you can remove the component via hidden.

{
  "search": {
    "hidden": true
  }
}