X-Git-Url: http://jsfdemo.indexdata.com/?a=blobdiff_plain;f=doc%2Fexamples.xml;h=153eaed73afd22adc7d3a3215094ca8c7a4782f2;hb=bf07c880d791008bb81431e479c93c03d7567a44;hp=2735cb2412f1fc87a642f0fe40c78f4d24f43fa6;hpb=bffe964768496135023ab242d6b468558fa1c2be;p=idzebra-moved-to-github.git

diff --git a/doc/examples.xml b/doc/examples.xml
index 2735cb2..153eaed 100644
--- a/doc/examples.xml
+++ b/doc/examples.xml
@@ -1,5 +1,5 @@
 <chapter id="examples">
- <!-- $Id: examples.xml,v 1.3 2002-08-30 01:17:10 mike Exp $ -->
+ <!-- $Id: examples.xml,v 1.6 2002-09-20 09:58:04 mike Exp $ -->
  <title>Example Configurations</title>
 
  <sect1>
@@ -43,7 +43,7 @@
   </para>
  </sect1>
 
- <sect1>
+ <sect1 id="example1">
   <title>Example 1: Minimal Configuration</title>
 
   <para>
@@ -126,7 +126,7 @@
   </para>
  </sect1>
 
- <sect1>
+ <sect1 id="example2">
   <title>Example 2: Adding Some Configuration</title>
 
   <para>
@@ -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.3 2002-08-30 01:17:10 mike 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.3 2002-08-30 01:17:10 mike 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>
@@ -196,6 +196,79 @@ zebraidx -t grs.sgml update records
    </listitem>
 -->
 
+<!--
+	The simplest hello-world example could go like this:
+	
+	Index the document
+	
+	<book>
+	   <title>The art of motorcycle maintenance</title>
+	   <subject scheme="Dewey">zen</subject>
+	</book>
+	
+	And search it like
+	
+	f @attr 1=/book/title motorcycle
+	
+	f @attr 1=/book/subject[@scheme=Dewey] zen
+	
+	If you suddenly decide you want broader interop, you can add
+	an abs file (more or less like this):
+	
+	attset bib1.att
+	tagset tagsetg.tag
+	
+	elm (2,1)       title   title
+	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