XSL stylesheets and QSF.
========================

    If you need to convert pilot-qof data into other formats, take a look
    at the example stylesheets installed with pilot-qof. You are welcome to
    contribute new or amended stylesheets - just post them on the QOF-devel
    mailing list.

    http://lists.sourceforge.net/lists/listinfo/qof-devel

    See the Pilot-QOF Extensions Manual for more information.

	The XSL stylesheets use a URI based at http://www.data-freedom.org/
	and local access is supported via the XML_CATALOG_FILES environment
	variable:

$ export XML_CATALOG_FILES="/usr/share/xml/datafreedom/xsl/catalog.xml"

$ pilot-qof -x address.xml -c Travel | \
xsltproc -o tmp/ http://www.data-freedom.org/xsl/pilot-qof-address-vcard1.xsl -


Limitations
===========

	  XSL can only do so much. Converting to file formats of a similar
	  structure and layout is relatively simple and problem-free. Converting
	  to file formats or objects that require multiple calculations or
	  associating data within objects of different types is less reliable.
	  An example is the invoice XSL: It works OK for simple invoices
	  (one client per day, one expense, one mileage claim per invoice) but
	  fails with more complex invoices.

	  For complex calculations and to convert non-XML formats (like vCard),
	  see the perl scripts.

Redirection, scripts and backups
================================

      Although it is fine to do this:
      $ pilot-qof -x business.xml --invoice-city -t 2006-03-01 | \
		xsltproc http://www.data-freedom.org/xsl/pilot-qof-invoice-xhtml.xsl -

      Just remember that it might not be so wise to do this:
      $ pilot-qof -a --invoice-city -t 2006-03-01 | \
		xsltproc http://www.data-freedom.org/xsl/pilot-qof-invoice-xhtml.xsl -

      Why? Because using -a means that your Palm data is not being backed
      up in this process. Now, of course, you can sync your Palm twice but
      reading from the backup file is a lot faster. In general, the best advice
      is:

      "If the Palm data has changed, use -a to backup to file.
       If the Palm data has not changed, use -x to read the backup file."


Stylesheets imported by pilot-qof
=================================

      pilot-qof uses XSL templates and functions defined in two XSL libraries:

      XSLT Standard Library : http://xsltsl.sourceforge.net/ (Lesser GPL).

      EXSLT : http://www.exslt.org/ (public domain)
      http://lists.fourthought.com/pipermail/exslt/2004-July/001053.html
