xmerge/source/htmlsoff/package.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
   2 <!--
   3  #*************************************************************************
   4  #
   5   DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   6
   7   Copyright 2008 by Sun Microsystems, Inc.
   8
   9   OpenOffice.org - a multi-platform office productivity suite
  10
  11   $RCSfile: package.html,v $
  12
  13   $Revision: 1.4 $
  14
  15   This file is part of OpenOffice.org.
  16
  17   OpenOffice.org is free software: you can redistribute it and/or modify
  18   it under the terms of the GNU Lesser General Public License version 3
  19   only, as published by the Free Software Foundation.
  20
  21   OpenOffice.org is distributed in the hope that it will be useful,
  22   but WITHOUT ANY WARRANTY; without even the implied warranty of
  23   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  24   GNU Lesser General Public License version 3 for more details
  25   (a copy is included in the LICENSE file that accompanied this code).
  26
  27   You should have received a copy of the GNU Lesser General Public License
  28   version 3 along with OpenOffice.org.  If not, see
  29   <http://www.openoffice.org/license.html>
  30   for a copy of the LGPLv3 License.
  31
  32  #*************************************************************************
  33  -->
  34 <HTML>
  35 <HEAD>
  36         <TITLE>org.openoffice.xmerge.converter.xml.xslt package</TITLE>
  37 </HEAD>
  38 <BODY>
  39 <P>Provides the tools for doing the conversion of StarWriter XML to
  40 and from supported formats, through the use of an XSLT
  41 transformation.</P>
  42 <P>It follows the {@link org.openoffice.xmerge}
  43 framework for the conversion process.</P>
  44 <P>This converter does not currently support merge.</P>
  45 <P><FONT FACE="Times New Roman, serif"><FONT SIZE=5><B>XSLT
  46 Transformation</B></FONT></FONT></P>
  47 <p>The converter makes use
  48 of one or more XSLT style sheets, which are used in the
  49 DocumentSerializer and DocumentDeserializer, to perform the actual
  50 translations. The location of these stylesheets is extracted from the {@link org.openoffice.xmerge.util.registry.ConverterInfo ConverterInfo} data structure, and are specified using the optional converter-xslt-serialize and converter-xsltdeserialize tags in a plugins converter.xml file. Please refer to the SDK document for more information about how to implement a Plugin Configuration XML File for a specific plugin.
  51 A sample OpenOffice to Html stylesheet and Html to
  52 Openffice stylesheet, has been provided as a sample implementation.
  53 The converter also makes use of an XsltPlugin.properties file, which may be edited by the user to provide MIME-TYPE to file extension mappings. This file is used by the {@link org.openoffice.xmerge.converter.xml.xslt.PluginFactoryImpl getDeviceFileExtension} method.
  54 </p>
  55
  56 <H2>TODO list</H2>
  57
  58 <p><ol>
  59 <li>Expand XSLT style sheets to support more office/html
  60     capabilities</li>
  61 <li>Add support for certain character codes, such as &amp;nbsp
  62     which currently causes the transformer to break.</li>
  63 <li>Change the DocumentDeserializer transformer, so that the DOMResult is serialized using the xalan serializer and create an SxwDocument from the result</li>
  64 </ol></p>
  65
  66 @see org.openoffice.xmerge.util.registry
  67
  68 </BODY>
  69 </HTML>
  70
  71