website
website copied to clipboard
fluxcd
Paginate Algolia search results
It would be great if we could show more than 5 search results. https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js/ seems to describe how it's done.
@hiddeco found https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/infinite-scroll/js/ as a probably better suggestion.
@dholbach is there some metadata that we can add in the markdown for Angolia to prioritise some pages based on keywords? For example we would like for FAQ to have the FAQ page as the first result, for OCI the OCI cheatsheet, for bootstrap the bootstrap cheatsheet and so on.
Another issue is that Angolia prioritises the generated API docs instead of the one written for end-users, which is less than ideal. I personally stopped using the search due to this. I think I've proposed this before, @hiddeco would you agree to remove the generated API spec from search and main menu?
docsearch is what we are using in https://github.com/fluxcd/website/blob/main/layouts/partials/hooks/body-end.html
Unfortunately it's not supported there yet: https://github.com/algolia/docsearch/issues/883
So Hidde's example in the earlier comment could be helpful. If anyone could help with that, that'd be great.
Regarding pagination: docusaurus seems to do this better than docsy, but I couldn't find how it's configured there.
Check out the https://docs.gitops.weave.works/ search as an example.