butcherman / Tech_Bench

 * searchtools.js

 * ~~~~~~~~~~~~~~~~

 *

 * Sphinx JavaScript utilities for the full-text search.

 *

 * :copyright: Copyright 2007-2019 by the Sphinx team, see AUTHORS.

 * :license: BSD, see LICENSE for details.

 *

 */

  /**

   * Simple result scoring code.

   */

  var Scorer = {

    // Implement the following function to further tweak the score for each result

    // The function takes a result array [filename, title, anchor, descr, score]

    // and returns the new score.

    /*

    score: function(result) {

      return result[4];

    },

    */

    // query matches the full name of an object

    objNameMatch: 11,

    // or matches in the last dotted part of the object name

    objPartialMatch: 6,

    // Additive scores depending on the priority of the object

    objPrio: {0:  15,   // used to be importantResults

              1:  5,   // used to be objectResults

              2: -5},  // used to be unimportantResults

    //  Used when the priority is not in the mapping.

    objPrioDefault: 0,

    // query found in title

    title: 15,

    partialTitle: 7,

    // query found in terms

    term: 5,

    partialTerm: 2

  };

}

if (!splitQuery) {

    return query.split(/\s+/);

  }

}

/**

 * Search Module

 */

var Search = {

  _index : null,

  _queued_query : null,

  _pulse_status : -1,

  htmlToText : function(htmlString) {

      var htmlElement = document.createElement('span');

      htmlElement.innerHTML = htmlString;

      $(htmlElement).find('.headerlink').remove();

      return docContent.textContent || docContent.innerText;

  },

  init : function() {

      var params = $.getQueryParameters();

      if (params.q) {

          var query = params.q[0];

          $('input[name="q"]')[0].value = query;

          this.performSearch(query);

      }

  },

  loadIndex : function(url) {

    $.ajax({type: "GET", url: url, data: null,

            dataType: "script", cache: true,

            complete: function(jqxhr, textstatus) {

              if (textstatus != "success") {

                document.getElementById("searchindexloader").src = url;

              }

            }});

  },

  setIndex : function(index) {

    var q;

    this._index = index;

    if ((q = this._queued_query) !== null) {

      this._queued_query = null;

      Search.query(q);

    }

  },

  hasIndex : function() {

      return this._index !== null;

  },

  deferQuery : function(query) {

      this._queued_query = query;

  },

  stopPulse : function() {

      this._pulse_status = 0;

  },

  startPulse : function() {

    if (this._pulse_status >= 0)

    function pulse() {

      var i;

      Search._pulse_status = (Search._pulse_status + 1) % 4;

      var dotString = '';

      for (i = 0; i < Search._pulse_status; i++)

      Search.dots.text(dotString);

      if (Search._pulse_status > -1)

    }

    pulse();

  },

  /**

   * perform a search for something (or wait until index is loaded)

   */

  performSearch : function(query) {

    // create the required interface elements

    this.out = $('#search-results');

    this.title = $('<h2>' + _('Searching') + '</h2>').appendTo(this.out);

    this.dots = $('<span></span>').appendTo(this.title);

    this.status = $('<p class="search-summary">&nbsp;</p>').appendTo(this.out);

    this.output = $('<ul class="search"/>').appendTo(this.out);

    $('#search-progress').text(_('Preparing search...'));

    this.startPulse();

    // index already loaded, the browser was quick!

    if (this.hasIndex())

    else

      this.deferQuery(query);

  },

  /**

   * execute search (requires search index to be loaded)

   */

  query : function(query) {

    var i;

    // stem the searchterms and add them to the correct list

    var searchterms = [];

    var excluded = [];

    var hlterms = [];

    var tmp = splitQuery(query);

    var objectterms = [];

    for (i = 0; i < tmp.length; i++) {

      if (tmp[i] !== "") {

          objectterms.push(tmp[i].toLowerCase());

      }

          tmp[i] === "") {

        // skip this "word"

        continue;

      }

      // stem the word

      var word = stemmer.stemWord(tmp[i].toLowerCase());

      // prevent stemmer from cutting word smaller than two chars

      if(word.length < 3 && tmp[i].length >= 3) {

        word = tmp[i];

      }

      var toAppend;

      // select the correct list

      if (word[0] == '-') {

        toAppend = excluded;

        word = word.substr(1);

      }

      else {

        toAppend = searchterms;

        hlterms.push(tmp[i].toLowerCase());

      }

      // only add if not already in the list

      if (!$u.contains(toAppend, word))

    }

    var highlightstring = '?highlight=' + $.urlencode(hlterms.join(" "));

    // console.debug('SEARCH: searching for:');

    // console.info('required: ', searchterms);

    // console.info('excluded: ', excluded);

    // prepare search

    var terms = this._index.terms;

    var titleterms = this._index.titleterms;

    // array of [filename, title, anchor, descr, score]

    var results = [];

    $('#search-progress').empty();

    // lookup as object

    for (i = 0; i < objectterms.length; i++) {

      var others = [].concat(objectterms.slice(0, i),

                             objectterms.slice(i+1, objectterms.length));

      results = results.concat(this.performObjectSearch(objectterms[i], others));

    }

    // lookup as search terms in fulltext

    results = results.concat(this.performTermsSearch(searchterms, excluded, terms, titleterms));

    // let the scorer override scores with a custom scoring function

    if (Scorer.score) {

      for (i = 0; i < results.length; i++)

    }

    // now sort the results by score (in opposite order of appearance, since the

    // display function below uses pop() to retrieve items) and then

    // alphabetically

    results.sort(function(a, b) {

      var left = a[4];

      var right = b[4];

      if (left > right) {

        return 1;

      } else if (left < right) {

        return -1;

      } else {

        // same score: sort alphabetically

        left = a[1].toLowerCase();

        right = b[1].toLowerCase();

        return (left > right) ? -1 : ((left < right) ? 1 : 0);

      }

    });

    // for debugging

    //Search.lastresults = results.slice();  // a copy

    //console.info('search results:', Search.lastresults);

    // print the results

    var resultCount = results.length;

    function displayNextItem() {

      // results left, load the summary and display it

      if (results.length) {

        var item = results.pop();

        var listItem = $('<li style="display:none"></li>');

          // dirhtml builder

          var dirname = item[0] + '/';

          if (dirname.match(/\/index\/$/)) {

            dirname = dirname.substring(0, dirname.length-6);

          } else if (dirname == 'index/') {

            dirname = '';

          }

          listItem.append($('<a/>').attr('href',

            DOCUMENTATION_OPTIONS.URL_ROOT + dirname +

            highlightstring + item[2]).html(item[1]));

        } else {

          // normal html builders

          listItem.append($('<a/>').attr('href',

            item[0] + DOCUMENTATION_OPTIONS.FILE_SUFFIX +

            highlightstring + item[2]).html(item[1]));

        }

        if (item[3]) {

          listItem.append($('<span> (' + item[3] + ')</span>'));

          Search.output.append(listItem);

          listItem.slideDown(5, function() {

            displayNextItem();

          });

        } else if (DOCUMENTATION_OPTIONS.HAS_SOURCE) {

          $.ajax({url: DOCUMENTATION_OPTIONS.URL_ROOT + item[0] + DOCUMENTATION_OPTIONS.FILE_SUFFIX,

                  dataType: "text",

                    var data = jqxhr.responseText;

                    if (data !== '' && data !== undefined) {

                      listItem.append(Search.makeSearchSummary(data, searchterms, hlterms));

                    }

                    Search.output.append(listItem);

                    listItem.slideDown(5, function() {

                      displayNextItem();

                    });

                  }});

        } else {

          // no source available, just display title

          Search.output.append(listItem);

          listItem.slideDown(5, function() {

            displayNextItem();

          });

        }

      }

      // search finished, update title and status message

      else {

        Search.stopPulse();

        Search.title.text(_('Search Results'));

        if (!resultCount)

        else

            Search.status.text(_('Search finished, found %s page(s) matching the search query.').replace('%s', resultCount));

        Search.status.fadeIn(500);

      }

    }

    displayNextItem();

  },

  /**

   * search for object names

   */

  performObjectSearch : function(object, otherterms) {

    var filenames = this._index.filenames;

    var docnames = this._index.docnames;

    var objects = this._index.objects;

    var objnames = this._index.objnames;

    var titles = this._index.titles;

    var i;

    var results = [];

        var fullname = (prefix ? prefix + '.' : '') + name;

        if (fullname.toLowerCase().indexOf(object) > -1) {

          var score = 0;

          var parts = fullname.split('.');

          // check for different match types: exact matches of full name or

          // "last name" (i.e. last dotted part)

          if (fullname == object || parts[parts.length - 1] == object) {

            score += Scorer.objNameMatch;

          // matches in last name

          } else if (parts[parts.length - 1].indexOf(object) > -1) {

            score += Scorer.objPartialMatch;

          }

          var match = objects[prefix][name];

          var objname = objnames[match[1]][2];

          var title = titles[match[0]];

          // If more than one term searched for, we require other words to be

          // found in the name/title/description

          if (otherterms.length > 0) {

            var haystack = (prefix + ' ' + name + ' ' +

                            objname + ' ' + title).toLowerCase();

            var allfound = true;

            for (i = 0; i < otherterms.length; i++) {

              if (haystack.indexOf(otherterms[i]) == -1) {

                allfound = false;

                break;

              }

            }

            if (!allfound) {

              continue;

            }

          }

          var descr = objname + _(', in ') + title;

          var anchor = match[3];

          if (anchor === '')

          else if (anchor == '-')

          // add custom score for some objects according to scorer

          if (Scorer.objPrio.hasOwnProperty(match[2])) {

            score += Scorer.objPrio[match[2]];

          } else {

            score += Scorer.objPrioDefault;

          }

          results.push([docnames[match[0]], fullname, '#'+anchor, descr, score, filenames[match[0]]]);

        }

      }

    }

    return results;

  },

  /**

   * search for full-text terms in the index

   */

  /**

   * helper function to return a node containing the

   * search summary for a given text. keywords is a list

   * of stemmed words, hlwords is the list of normal, unstemmed

   * words. the first one is used to find the occurrence, the

   * latter for highlighting it.

   */

  makeSearchSummary : function(htmlText, keywords, hlwords) {

    var text = Search.htmlToText(htmlText);

    var textLower = text.toLowerCase();

    var start = 0;

    $.each(keywords, function() {

      var i = textLower.indexOf(this.toLowerCase());

      if (i > -1)

    });

    start = Math.max(start - 120, 0);

    var excerpt = ((start > 0) ? '...' : '') +

      $.trim(text.substr(start, 240)) +

      ((start + 240 - text.length) ? '...' : '');

    var rv = $('<div class="context"></div>').text(excerpt);

    $.each(hlwords, function() {

      rv = rv.highlightText(this, 'highlighted');

    });

    return rv;

  }

};

$(document).ready(function() {

  Search.init();

});