add search box

[orbeckst]

It would be nice to be able to search the pages, especially the blog. Possibilities:

• some js-based search, which will need an external services such as Algolia DocSearch
• Google custom search

[orbeckst]

I am currently trying out DocSearch and will report back.... more comments welcome, of course.

You can see DocSearch in action at https://jekyllrb.com/ – e.g., type "search" into the search box.

[orbeckst]

I applied for free DocSearch (2 days ago and again today):

Thank you !
We'll review your request shortly, after making sure your website is eligible to DocSearch.

This is a manual process and can take some time.

We'll then email you the code you need to integrate on your website

We'll see if they reply eventually. They promise

We’ll get back to you within a few hours with everything you need to integrate your new search into your website.
Oh, and did we mention it's FREE? No commitment. No subscription. Everything is on us! And it won't change.

[orbeckst]

Algolia set up their crawler and we only have to add a search box to our site and include the following code:

Congratulations, your search is now ready! 
I've successfully configured the underlying crawler and it will now run every 24h. 

You're now a few steps away from having it working on your website: 

- Copy the following CSS/JS snippets and add them to your page 

<!-- at the end of the HEAD --> 
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css" /> 

<!-- at the end of the BODY --> 
<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.js"></script> 
<script type="text/javascript"> docsearch({ 
apiKey: '307d780013d06fdde7a4eae462db0e74', 
indexName: 'mdanalysis', 
inputSelector: '### REPLACE ME ####', 
debug: false // Set debug to true if you want to inspect the dropdown 
}); 
</script> 

- Add a search input in your page if you don't have any yet. Then update the inputSelector value in JS snippet to a CSS selector that targets your search input field. 

- Optionally customize the look and feel by following the DocSearch documentation (https://community.algolia.com/docsearch/documentation/) 
- You can also check your configuration in our github repo (https://github.com/algolia/docsearch-configs/blob/master/configs/mdanalysis.json). 

Please open a pull request if want to leverage your configuration! 

Feel free to get back to us if you have any issues or questions regarding the integration. 

We'd also be happy to get your feedback and thoughts about DocSearch - so we can continue to improve it. 

[orbeckst]

https://community.algolia.com/algoliasearch-jekyll-hyde/ is what I want to get... see https://github.com/algolia/algoliasearch-jekyll-hyde

However, the above is considered deprecated so ought to look at https://github.com/algolia/jekyll-algolia and the tutorial Algolia for Jekyll.