diagrams icon indicating copy to clipboard operation
diagrams copied to clipboard

[Documentation] [Feature Request] Enable search in documentation

Open kavimaluskam opened this issue 4 years ago • 3 comments

I am new to this project and found it super useful! But as i am not familiar to the resource in this project, and it would be great if the documentation support searching!

As the documentation is by docusaurus, any concern on integrating search by Algolia?

kavimaluskam avatar Oct 17 '20 17:10 kavimaluskam

It would be good to support. I need to review this feature.

mingrammer avatar Dec 03 '20 15:12 mingrammer

@mingrammer Here's the relevant Docusaurus documentation regarding integrating Algolia search.
Are you open for a PR for the feature?

guyzyl avatar Jul 26 '21 16:07 guyzyl

@mingrammer Would a PR be accepted to upgrade Docusaurus to version 2.0.0 or switch to another static site generator that supports local search out-of-the-box (e.g. mkdocs)?

It looks like Docusaurus version >= 2.x.x supports multiple search options, including local search plugins, whereas 1.x.x appears to only support Algolia.

Given that the docs site is relatively small, my instinct is that a local search plugin would be more than sufficient.

Update: I made a prototype mkdocs site for this project with search enabled. I added a line of configuration to split search terms on - and . characters since many of the useful items in the docs are separated by a .. I did a quick test of the mkdocs search feature and I found it to be satisfactory and convenient. If you are interested, I would be happy to open a pull request to this repository and implement the above change.

Collinbrown95 avatar Aug 06 '22 04:08 Collinbrown95