Integrate with Algolia search

[jviotti]

No description provided.

[Era-cell]

Hi!! I think if the aim of the search will be to redirect to url just based on the keyword search.
we can implement it just using Javascript? - simple searching substrings method in JS.
-- with autocomplete and suggestions on best match
Also I tried algolia search, rn maybe I didn't find it that successful ... so, maybe I need to know the structure of the objects array on which we need to implement algolia search

[jviotti]

Whatever works and gives us a good search experience. I saw many similar sites using Algolia, so that's why I suggested that, but maybe there are other options. Definitely worth doing some proper research.

On the JS approach, that'd work but I think it might be too simple. For example, you could search on the metadata of each keyword but not in the content explanations?

[jviotti]

cc @RonItelman Are you aware of nice services to implement search capabilities on static sites?

[Era-cell]

Whatever works and gives us a good search experience. I saw many similar sites using Algolia, so that's why I suggested that, but maybe there are other options. Definitely worth doing some proper research.

On the JS approach, that'd work but I think it might be too simple. For example, you could search on the metadata of each keyword but not in the content explanations?

What I can get from this is we may need to store the description data again in JSON files, as algolia search works on JSON files...
Like keyword, description, title, etc, or find a way to use markdown files in the algolia search...

[jviotti]

I was wondering if there is any search provider service that automatically scans/caches the live pages they would see at learnjsonschema.com to serve for their own search without us doing anything.

[Era-cell]

I was wondering if there is any search provider service that automatically scans/caches the live pages they would see at learnjsonschema.com to serve for their own search without us doing anything.

{noted} we can go with Algolia search as it is faster and is second best search as a service provider, elasticsearch is first but its for large databases..
So, for algolia search the input will be search word and json file in which we need to search for:
json structure I propose is:
{ "objectId": 1, "keyword": "$id", "url": "http://learnjsonschema.com/2020-12/core/id", "description": "This is what may be too long and I need help for " }
And other thing:
As many versions will be implemented what should be done in this:

1. When the user is on base "http://learnjsonschema.com/2020-12/*" and searches keyword X, there will be ambiguity in whether 2019-09 or 2020-12 so should the search consider same version on which user is searching on?
2. And if user types explicitely "2019 additionalProiperties".. like that then only we switch the version right? "http://learnjsonschema.com/2020-12

[jviotti]

Yeah, I don't know how we could even generate those JSON documents. Probably worth a bit more research

[jviotti]

This looks interesting: https://harrycresswell.com/writing/hugo-algolia/

[jviotti]

There are also plenty of alternatives that work well with Hugo listed here: https://gohugo.io/tools/search/. Maybe some of them are much easier to work with

[jviotti]

This one seems very local and easy: https://makewithhugo.com/add-search-to-a-hugo-site/ and here is a nice Hugo + Fuse.js template: https://github.com/zwbetz-gh/hugo-client-side-search-template