From e57e9b19f4257768441a8025d08ce0e3430c7d78 Mon Sep 17 00:00:00 2001
From: Mike Taylor <mike@indexdata.com>
Date: Fri, 20 Sep 2002 09:58:04 +0000
Subject: [PATCH] Rolling tweaks

---
 doc/examples.xml     |   53 +++++++++++++++++++++--
 doc/introduction.xml |  117 ++++++++++++++++++++++++++------------------------
 2 files changed, 110 insertions(+), 60 deletions(-)

diff --git a/doc/examples.xml b/doc/examples.xml
index 956e7d0..153eaed 100644
--- a/doc/examples.xml
+++ b/doc/examples.xml
@@ -1,5 +1,5 @@
 <chapter id="examples">
- <!-- $Id: examples.xml,v 1.5 2002-09-19 19:51:48 adam Exp $ -->
+ <!-- $Id: examples.xml,v 1.6 2002-09-20 09:58:04 mike Exp $ -->
  <title>Example Configurations</title>
 
  <sect1>
@@ -161,7 +161,7 @@ zebraidx -t grs.sgml update records
      The master configuration file, <literal>zebra.cfg</literal>,
      which is as short and simple as it can be:
      <screen>
-	# $Header: /home/cvsroot/idis/doc/examples.xml,v 1.5 2002-09-19 19:51:48 adam Exp $
+	# $Header: /home/cvsroot/idis/doc/examples.xml,v 1.6 2002-09-20 09:58:04 mike Exp $
 	# Bare-bones master configuration file for Zebra
 	profilePath: .:../../tab:../../../yaz/tab
      </screen>
@@ -178,7 +178,7 @@ zebraidx -t grs.sgml update records
      The BIB-1 attribute set configuration file,
      <literal>bib1.att</literal>, which is also as short as possible:
      <screen>
-	# $Header: /home/cvsroot/idis/doc/examples.xml,v 1.5 2002-09-19 19:51:48 adam Exp $
+	# $Header: /home/cvsroot/idis/doc/examples.xml,v 1.6 2002-09-20 09:58:04 mike Exp $
 	# Bare-bones BIB-1 attribute set file for Zebra
 	reference Bib-1
      </screen>
@@ -222,6 +222,53 @@ zebraidx -t grs.sgml update records
 	elm (2,21)      subject  subject
 -->
 
+<!--
+How to include images:
+
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="system.eps" format="eps">
+	  </imageobject>
+	  <imageobject>
+	    <imagedata fileref="system.gif" format="gif">
+	  </imageobject>
+	  <textobject>
+	    <phrase>The Multi-Lingual Search System Architecture</phrase>
+	  </textobject>
+	  <caption>
+	    <para>
+	      <emphasis role="strong">
+		The Multi-Lingual Search System Architecture.
+	      </emphasis>
+	      <para>
+		Network connections across local area networks are
+		represented by straight lines, and those over the
+		internet by jagged lines.
+	  </caption>
+	</mediaobject>
+
+Whene the three <*object> thingies inside the top-level <mediaobject>
+are decreasingly preferred version to include depending on what the
+rendering engine can handle.  I generated the EPS version of the image
+by exporting a line-drawing done in TGIF, then converted that to the
+GIF using a shell-script called "epstogif" which used an appallingly
+baroque sequence of conversions, which I would prefer not to pollute
+the Zebra build environment with:
+
+	#!/bin/sh
+
+	# Yes, what follows is stupidly convoluted, but I can't find a
+	# more straightforward path from the EPS generated by tgif's
+	# "Print" command into a browser-friendly format.
+
+	file=`echo "$1" | sed 's/\.eps//'`
+	ps2pdf "$1" "$file".pdf
+	pdftopbm "$file".pdf "$file"
+	pnmscale 0.50 < "$file"-000001.pbm | pnmcrop | ppmtogif
+	rm -f "$file".pdf "$file"-000001.pbm
+
+-->
+
  <!-- Keep this comment at the end of the file
  Local variables:
  mode: sgml
diff --git a/doc/introduction.xml b/doc/introduction.xml
index 03401df..8303231 100644
--- a/doc/introduction.xml
+++ b/doc/introduction.xml
@@ -1,5 +1,5 @@
 <chapter id="introduction">
- <!-- $Id: introduction.xml,v 1.12 2002-08-30 01:17:10 mike Exp $ -->
+ <!-- $Id: introduction.xml,v 1.13 2002-09-20 09:58:04 mike Exp $ -->
  <title>Introduction</title>
  
  <sect1>
@@ -184,7 +184,7 @@
   
  </sect1>
  
- <sect1 id="apps">
+  <sect1 id="apps">
   <title>Applications</title>
   <para>
    Zebra has been deployed in numerous applications, in both the
@@ -222,61 +222,56 @@
    </para>
   </sect2>
 
-<!--
-Envelope-to: zebra@miketaylor.org.uk
-From: Johannes Leveling <Johannes.Leveling@FernUni-Hagen.de>
-Content-Type: text/plain; charset=iso-8859-1
-Date: Thu, 29 Aug 2002 19:19:55 +0200
-To: zebra@miketaylor.org.uk
-Subject: [Zebralist] Looking for Deployment Stories
-In-Reply-To: <200208281002.LAA16526@seatbooker.net>
-X-Virus-Scanned: by AMaViS perl-11
-X-MIME-Autoconverted: from quoted-printable to 8bit by localhost.localdomain id g7TLWR905724
-
-Mike Taylor writes:
- > People,
- > 
- > In collaboration with Sebastian, Adam and Heikki, I am reworking some
- > parts of the Zebra documentation in preparation for the forthcoming
- > release.  One area I am keen to expand on is (briefly) describing
- > interesting applications of Zebra.  If you've deployed it in a way
- > that you consider interesting, I'd love to hear from you, however
- > briefly.  Think of this as a chance to get some free publicity for
- > your application in the Zebra documentation.
- > 
- > Replies off-list to <zebra@miketaylor.org.uk>, please.
- > 
- >  _/|_	 _______________________________________________________________
- > /o ) \/  Mike Taylor   <mike@miketaylor.org.uk>   www.miketaylor.org.uk
- > )_v__/\  There are some good things you can never have too much of.
- > 
- > 
- > _______________________________________________
- > Zebralist mailing list
- > Zebralist@indexdata.dk
- > http://www.indexdata.dk/mailman/listinfo/zebralist
- > 
-Intersting?
-We have developed a natural language interface (NLI-Z39.50) for access
-to library databases at the Fernuniversität Hagen, Germany
-(http://ki212.fernuni-hagen.de/nli/NLI.html).
-To prepare formal information retrieval evaluation,
-we chose the Zebra server as the basis for
-evaluating retrieval effectiveness (measuring recall 
-and precision for the GIRT database). The Zebra database 
-consists of more than 76000 records in SGML format (bibliographic 
-records from social science), which are mapped to MARC for presentation. 
-Evaluation will take place as part of the TREC/CLEF campaign 2003 
-(see http://clef.iei.pi.cnr.it or http://www4.eurospider.ch/CLEF/).
-
-
-Johannes Leveling        Praktische Informatik VII/KI           
-                         FernUniversität Hagen
-
-Email : Johannes.Leveling@FernUni-Hagen.De  
-Tel.  : +49 2331 987-4525
+  <sect2>
+   <title>NLI-Z39.50 - a Natural Language Interface for Libraries</title>
+   <para>
+    Fernuniversität Hagen in Germany have developed a natural
+    language interface for access to library databases.
+    <ulink url="http://ki212.fernuni-hagen.de/nli/NLIintro.html"/>
+    In order to evaluate this interface for recall and precision, they
+    chose Zebra as the basis for retrieval effectiveness.  The Zebra
+    server contains a copy of the GIRT database, consisting of more
+    than 76000 records in SGML format (bibliographic records from
+    social science), which are mapped to MARC for presentation.
+   </para>
+   <para>
+    (GIRT is the German Indexing and Retrieval Testdatabase.  It is a
+    standard German-language test database for intelligent indexing
+    and retrieval systems.  See
+    <ulink url="http://www.gesis.org/forschung/informationstechnologie/clef-delos.htm"/>
+   </para>
+   <para>
+    Evaluation will take place as part of the TREC/CLEF campaign 2003 
+    <ulink url="http://clef.iei.pi.cnr.it or http://www4.eurospider.ch/CLEF/"/>
+   </para>
+   <para>
+    For more information, contact Johannes Leveling
+    <email>Johannes.Leveling@FernUni-Hagen.De</email>
+   </para>
+  </sect2>
 
--->
+  <sect2>
+   <title>ULS (Union List of Serials)</title>
+   <para>
+    The London School of Economics (### I think)
+    are involved in a projects called ULS to provide a union catalogue
+    for periodicals in 21 member libraries.  They do this with an
+    unusual architecture which they call a
+    ``non-distributed virtual union catalogue''.
+   </para>
+   <para>
+    The member libraries send in data files representing their
+    periodicals, including both brief bibliographic data and summary
+    holdings.  Then 21 individual Z39.50 targets are created, each
+    using Zebra, and all mounted on the single hardware server.
+    The live service provides a web gateway allowing Z39.50 searching
+    of all 21 targets or a selection of them.
+   </para>
+   <para>
+    More information can be found at
+    <ulink url="http://www.m25lib.ac.uk/ULS/"/>
+   </para>
+  </sect2>
 
   <sect2>
    <title>Various web indexes</title>
@@ -288,7 +283,15 @@ Tel.  : +49 2331 987-4525
     or subset of the whole Web.
    </para>
    <para>
-    ### examples, details and numbers, please!
+    For example, Liverpool University's web-search facility (see on
+    the home page at
+    <ulink url="http://www.liv.ac.uk/"/>
+    and many sub-pages) works by relevance-searching a Zebra database
+    which is populated by the Harvest-NG web-crawling software.
+   </para>
+   <para>
+    For more information, contact John Gilbertson
+    <email>jgilbert@liverpool.ac.uk</email>
    </para>
   </sect2>
  </sect1>
-- 
1.7.10.4