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 - REWRITE _parseLine:! It doesn't properly deal with escaped characters
  27   as it SHOULD, thus properly corrupting content
  28 - improve error handling (SaxExceptions !)
  29 - make the driver fully xCal compliant
  30
  31
  32 Examples
  33 ========
  34
  35 To "convert" an iCalendar to xCal (the test programs print out some XML):
  36
  37   saxxml -XMLReader VSiCalSaxDriver test1.ics
  38   domxml -XMLReader VSiCalSaxDriver -xml  test1.ics
  39
  40 To "convert" an iCalendar to PYX:
  41
  42   domxml -XMLReader VSiCalSaxDriver -pyx  test1.ics