err.no Git - sope/blob - sope-ical/versitSaxDriver/README

   1 # $Id$
   2
   3 Overview
   4 ========
   5
   6 Two SaxObjC drivers for iCalendar and vCard files, initially written by
   7 Max Berger <max@berger.name>.
   8
   9 VSiCalSaxDriver basically maps iCal 2.0 components, properties and parameters
  10 to the XML events according to the xCal 02 draft (iCal 3.0).
  11
  12 Having a SAX driver for iCal might seem strange and a bit inefficient at
  13 first look, but the time saved for the application-level developer is
  14 significant, since he only needs to learn (or usually already knows) the
  15 SAX or DOM APIs and any XML API based on them (like XPATH, XQUERY).
  16
  17 The VSiCalSaxDriver is aimed to be a replacement for the older (but better
  18 tested as of now) iCalSaxDriver. However, the iCalSaxDriver depends on the
  19 abandoned and hardly maintainable libical, which itself is an additional
  20 dependency to the OGo project and thus a welcome candidate for replacement.
  21
  22
  23 ToDo
  24 ====
  25
  26 - improve error handling (SaxExceptions !)
  27 - make the driver fully xCal compliant
  28
  29
  30 Examples
  31 ========
  32
  33 To "convert" an iCalendar to xCal (the test programs print out some XML):
  34
  35   saxxml -XMLReader iCalSaxDriver test1.ics
  36   domxml -XMLReader iCalSaxDriver -xml  test1.ics
  37
  38 To "convert" an iCalendar to PYX:
  39
  40   domxml -XMLReader iCalSaxDriver -pyx  test1.ics