Rolling tweaks

[idzebra-moved-to-github.git] / doc / examples.xml

diff --git a/doc/examples.xml b/doc/examples.xml
index 956e7d0..153eaed 100644 (file)
--- 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