Simplified configuration for the Zebra system.
==============================================

Depends on idzebra-2.0, yaz and xsltproc debian packages beeing installed.
Example files included:
  ZebraConf.xml.ex : Main configuration file
  testDoc.xml.ex : 2 records in one file, for indexing
  testRecord.xml.ex : 1 record, for testing with xsltproc
  record2dc.xsl : output filter generates DC metadata in XML
  record2brief.xsl : 
  record2detailed.xsl : output filter generates detailed HTML snippets

Operation:
----------
Write a master configuration file called ZebraConf.xml
  (model after example in ZebraConf.xml.ex)

Running 'make' will generate all Zebra configuration files:
  zebra.cfg
  yazserver.xml
  explain.xml
  indexfilter.xsl
  cql2pqf.txt
  filter_alvis_conf.xml
needed to use Zebra with Alvis XSLT filters and CQL.
It will also generate a simple PHP UI for searching the database.
  simplesearch.phtml
  extrRecordData.xsl

Then you are set to go with the Zebra system.

Testing, debugging.
-------------------
'make test' will index test documents in 'testDoc.xml' (provided by you),
start a zebra-server and make a search (for the word 'the') using yaz-client.
Study the output and look for warnings or errors. At the very end a record
should be displayed if everything was successfull.

'make testXSL' will run your indexing-filter on a test document (again
provided by you) 'testRecord.xml'. Keep in mind that this has to be
a XML snippet corresponding to one record, using split-level from 'ZebraConf.xml'.

'make testIndex' will just try to index the records in 'textDoc.xml'.

As a further test after 'make testIndex' you can start a zebra-server with
the command 'zebrasrv -f yazserver.xml' and use FireFox to browse to
http://localhost:<portNo>/ where <portNo> is the port you defined in
ZebraConf.xml

Test the UI by copying 'simplesearch' and 'extrRecordData.xsl' to
a PHP-enabled (including extensions curl and XSL) Web-server.
(A simple way of getting such a Webserever is to install debian
 packages apache2, php5, php5-curl and php5-xsl)

Further hints on the way to a complete system.
----------------------------------------------
Write the output filters you need for your application. See 'record2*.xsl' examples.

Write the UI you need for your application. See 'simplesearch.phtml' example.
