Skip to content
Branch: master
Find file Copy path
Find file Copy path
1 contributor

Users who have contributed to this file

60 lines (44 sloc) 2.39 KB
title: "Search"
output: rmarkdown::html_vignette
vignette: >
```{r, include = FALSE}
collapse = TRUE,
comment = "#>"
pkgdown websites can integrate search capability using [Docsearch]( from Algolia. Docsearch is a powerful search engine that is free for documentation websites. There are only two steps needed to enable Docsearch on a pkgdown website.
## Indexing
Once you have published your pkgdown website, submit the [pkgdown site URL to Docsearch]( Docsearch will contact you via e-mail to confirm you are the website owner.
Docsearch will set up a crawler configuration that indexes your site every 24 hours. pkgdown builds a suggested Docsearch crawler configuration in `docsearch.json` and you should point the Docsearch team to this configuration as a starting point. If you want to optimize your search, Docsearch will accept pull requests to the configuration that incorporate [additional options]( to fine tune the scraping.
## Configuration
The Docsearch team will e-mail you some JavaScript to integrate into your website.
<script type="text/javascript">
apiKey: 'API_KEY', // a long hex string
indexName: 'INDEX_NAME',
inputSelector: '### REPLACE ME ####',
debug: false // Set debug to true if you want to inspect the dropdown
Put the value of the `apiKey` and `indexName` parameters into your site `_pkgdown.yml` under `template: params`:
api_key: API_KEY
index_name: INDEX_NAME
You also need to add a `url:` field to `_pkgdown.yml` that specifies the location of your documentation on the web. For pkgdown, the URL field is:
If you are building your own custom Docsearch index, you can also include your Docsearch `app_id` in `_pkgdown.yml`.
See the [pkgdown configuration]( for a functional search configuration.
Once this configuration is complete, you should find a search bar after re-building your site. After search is enabled, pressing `shift` + `/` (i.e., "?") will move the focus to the search bar.
You can’t perform that action at this time.