Skip to content
This repository has been archived by the owner on Mar 26, 2019. It is now read-only.

A seamless search integration plugin for ascii_binder generated sites

License

Notifications You must be signed in to change notification settings

gluster/ascii_binder_search_plugin

Repository files navigation

AsciiBinder Search Plugin Build Status

What is this?

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.

Installation instructions

  1. Make sure you have a working installation of python3

  2. Create a virtualenv

     python3 -m venv <name of virtualenv>
    
  3. Activate the virtualenv

     source <name of virtualenv>/bin/activate
    
  4. Install

     pip install git+https://github.com/smitthakkar96/ascii_binder_search_plugin
    

Usage

  1. 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
    
  2. 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.

  1. 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

How does it work?

How do I make my own pluggable indexer?

Here is the guide that explains what needs to be done link and Check out the boilerplate