To generate a HTML version from the xml file download from

   http://www.nwalsh.com/docbook/xsl/index.html
   (http://www.jtauber.com/fop/)

   dbx106.zip

Unzip it and correct the path below from /opt/docbook to
your installation path.

Read http://gnosis.cx/publish/programming/xml_matters_4.txt
for background info on xml based DocBook.

For XML editing with a Java GUI you can use Xeena:
http://www.alphaworks.ibm.com/tech/xeena


Simply type

     build.sh whitepaper

to create an PDF and HTML variant.


Generate HTML output:
=====================

   I added our css into /opt/docbook/html/docbook.xsl (how to include it into the xml file?)
      <link REL="stylesheet" type="text/css" href="xmlBlaster.css"/>

   java -Dcom.jclark.xsl.sax.parser=com.jclark.xsl.dom.SunXMLProcessorImpl com.jclark.xsl.sax.Driver whitepaper.xml /opt/docbook/html/docbook.xsl whitepaper.html
  or
   java -Dcom.jclark.xsl.sax.parser=com.sun.xml.parser.Parser com.jclark.xsl.sax.Driver whitepaper.xml /opt/docbook/html/docbook.xsl whitepaper.html
  or
   java -Dcom.jclark.xsl.sax.parser=com.sun.xml.parser.ValidatingParser com.jclark.xsl.sax.Driver whitepaper.xml /opt/docbook/html/docbook.xsl whitepaper.html


Generate XHTML output:
======================

   java -Dcom.jclark.xsl.sax.parser=com.jclark.xsl.dom.SunXMLProcessorImpl com.jclark.xsl.sax.Driver whitepaper.xml /opt/docbook/xhtml/docbook.xsl whitepaper.xhtml


Generate fo output:
===================

   java -Dcom.jclark.xsl.sax.parser=com.jclark.xsl.dom.SunXMLProcessorImpl com.jclark.xsl.sax.Driver whitepaper.xml /opt/docbook/fo/docbook.xsl whitepaper.fo


Generate pdf output:
====================
   First create the fo output (previous step).

   Download the fo tools from apache: http://xml.apache.org/fop/running.html

   FOP is the world's first print formatter driven by XSL formatting objects

      fop_bin_0_12_0.jar

   export CLASSPATH=$CLASSPATH:/opt/fop_bin_0_12_0.jar

   java -Dorg.xml.sax.parser=com.sun.xml.parser.Parser org.apache.fop.apps.CommandLine whitepaper.fo whitepaper.pdf


Other pdf generators:
=====================
   Rendering Engine from XML/XSL to PDF format (REXP), Open source
      http://www.esng.dibe.unige.it/REXP/


   FO to PDF (Latex based)
      http://users.ox.ac.uk/~rahtz/passivetex/
      Converts FO to TeX to PDF. Has direct support for MathML. Need a
      pdftex installed.


   FO2PDF (commercial, no demo version)
      http://www.renderx.com
      Looks to be the most complete FO processor, commercial but unreleased,
      converts to PDF. Web site has validator service and many examples.
