OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [docbook-apps] WebHelp search - anybody working on improving?

Current versions of Lucene are capable of finding single words or
phrases and can use various operators such as 'AND', 'NOT' etc. (See
https://lucene.apache.org/core/2_9_4/queryparsersyntax.html.) So the
search packaged with Webhelp is either an old version of Lucene or not
Lucene at all. Other search capabilities packaged with documentation
tools seem to suffer from the same limitations, the search used by
Sphinx (http://www.sphinx-doc.org/) for example.

I have used Apache Solr--a web wrapper for Lucene--with DocBook HTML
and PHP output and been very pleased with the result. But you're
right, people expect  Google-like behaviour and results and it's
difficult to get them to use the syntax required for sophisticated
Solr searches.

My 2 cents worth,


On 10 November 2016 at 09:07, Janice Manwiller <janice@sqrrl.com> wrote:
> Actually, it looks like I get the same results with or without the quotes.
> I'm not sure the quotes are enforcing phrase searching.
> The results list for either source connectors or "source connectors" is
> divided into the following sections:
> Results for: connectors, source
> Results for: source
> Results for: connectors
> Janice
> On Thu, Nov 10, 2016 at 8:41 AM, Barton Wright <ordinant@gmail.com> wrote:
>> Of course, using quotes around “source connectors” does enforce phrase
>> searching. But you’re right that having that become more automatic as in
>> Google searches would be wonderful.
>> As I remember DocBook WebHelp ends up with Apache Lucene as its search
>> engine, and Lucene is quite good. But, alas, the world has gotten very used
>> to Dr. Google.
>> On Nov 10, 2016, at 7:09 AM, Camille Bégnis <camille@neodoc.biz> wrote:
>> We've been facing the issue too, and any tip will be appreciated.
>> The issue is that people are used to Google Search, and doing that on the
>> client side is not easy ;-)
>> Cheers,
>> NeoDoc
>> Camille Bégnis
>> Gérant
>> camille@neodoc.fr
>> Tél:
>> http://www.neodoc.fr/
>> 789, rue de la gare
>> F-13770 Venelles
>> Le 10/11/2016 à 13:02, Janice Manwiller a écrit :
>> I use DocBook source with the docbkx Maven plugin to generate PDFs,
>> WebHelp, and some HTML.
>> The WebHelp search is a source of frustration, mostly because it does not
>> support phrase searches. So if you search for "source connectors", it looks
>> for topics that have either the word source or the word connectors. While
>> topics that contain both words do bubble to the top, the search does not
>> specifically look for the phrase "source connectors", where both words are
>> together in that order.
>> Has there been any effort to improve the search? Has anyone else
>> implemented a custom search that supports phrase searches?
>> Thanks,
>> Janice
>> --
>> Janice Manwiller
>> Principal Technical Writer
>> Sqrrl Data, Inc.
>> www.sqrrl.com | @SqrrlData
> --
> Janice Manwiller
> Principal Technical Writer
> Sqrrl Data, Inc.
> www.sqrrl.com | @SqrrlData


Peter Lavin
Telephone:      1 416 461 4991
Mobile:            1 416 882 9194
Skype:             peter.lavin
(GMT -05:00 Canada/US Eastern)

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]