This is a small plugin developed to help the opensource projects using asciibinder to implement search functionality in their site. With this plugin it is very convenient to implement search functionality in your documentation site. This plugin ships you a indexer that works on client side but it is easy to extend it's capability by plugging in other supported indexer or build your own indexer that works with the search engine that you want.
-
Make sure you have a working installation of python3
-
Create a virtualenv
python3 -m venv <name of virtualenv> -
Activate the virtualenv
source <name of virtualenv>/bin/activate -
Install
pip install git+https://github.com/smitthakkar96/ascii_binder_search_plugin
-
After successful installation it's time to give this plugin a try, this plugin by default ships a indexer that indexes the data on client side
ascii_binder_search -i front_end_indexer -v -
You can install and use different indexers like the one I wrote to use this plugin with elastic. elastic indexer
ascii_binder_search -i <indexer_name> -v <indexer args>
for indexer args you must checkout the doc that is present with the indexer that you install.
-
Download, and optionally customize search.html or other assets present in static directory
ascii_binder_search -s <path_to_static_directory>
Everything that would be present in static folder will be copied to their respective paths
Please consider using _javascripts/<js_file> for javascripts and _stylesheets/<js_file> for stylesheets in your search.html
Here is the guide that explains what needs to be done link and Check out the boilerplate