[Koha-bugs] [Bug 11232] Retrieve facets from Zebra

[bugzilla-daemon at bugs.koha-community.org]

http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=11232

--- Comment #6 from David Cook <dcook at prosentient.com.au> ---
I'm outlining below a rough guide to how to enable Zebra facetting. Note that
this has nothing to do with Koha per se. This is just about setting up Zebra.
The actual Koha code to make use of Zebra's facets will have to come after
initial setup, and at the moment it's just not at the top of my list of
priorities.

First, take stock of which version of Koha you're running and note which type
of indexing you're using (DOM or GRS1).

Look for these two files in your /etc/zebradb/ folder:
"retrieval-info-bib-dom.xml"
"retrieval-info-bib-grs1.xml"

If you can't find them, you're probably running an older version of Koha and
you'll want to modify your "koha-conf.xml". If you do find them, the config in
"koha-conf.xml" is only a fallback, so not necessary for testing.


Step One:
a) Edit the file that suits your version of Koha and method of indexing.
(i.e. if you're running the latest Koha with dom, edit
"retrieval-info-bib-dom.xml". If you're running the latest Koha with grs1, edit
"retrieval-info-bib-grs1.xml". If you're running an older version of Koha,
you're only using grs1 and you'll need to edit "koha-conf.xml"

Step Two:
a) Add lines like the following as children to the "<retrievalinfo>" node (N.B.
do not add them to the top as they will displace the default retrieval syntax
setting. Add them at the bottom.):

<retrieval syntax="xml" name="zebra::facet::any:w"/>
<retrieval syntax="xml" name="zebra::facet::title:w"/>
<retrieval syntax="xml" name="zebra::facet::title:0"/>

(N.B. Paul Poulain mentioned that the "0" register is a "raw"(?) register and
that this should be used if you have issues with diacritics or non-Latin
characters. I imagine that this needs to be set up in your records.abs or DOM
XSLT.)

(N.B. You can substitute any index in for "any" or "title". You can also use
any register instead of "w" or "0", such as "p".)

Step Three: 
a) Restart your Zebra server

Step Four:
a) Connect to Zebra using yaz-client (e.g. yaz-client open
"unix:/zebra/test/var/run/zebradb/bibliosocket")(You can find your specific
path by looking at the top of koha-conf.xml for a "listen" node with an ID of
"biblioserver")

b) Tell Zebra to use facets (e.g. elements zebra::facet::any:w,title:w,title:0)
c) Do a search (e.g. find test)
d) Show your results (e.g. show 1+1)
e) You should now see a list of facets for your search results

--

If you have any issues with these instructions, comment here, find me in the
IRC channel or visit the sites that I'm linking below.

--

For more information, visit the following links:

http://www.indexdata.com/zebra/doc/zebra.pdf (Search in the document for
"facet")

http://lists.indexdata.dk/pipermail/zebralist/2007-July/001682.html (This is a
discussion of setting up Zebra facets)

-- 
You are receiving this mail because:
You are watching all bug changes.