1*cdf0e10cSrcweir<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
2*cdf0e10cSrcweir<!--
3*cdf0e10cSrcweir #*************************************************************************
4*cdf0e10cSrcweir #
5*cdf0e10cSrcweir  DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
6*cdf0e10cSrcweir
7*cdf0e10cSrcweir  Copyright 2000, 2010 Oracle and/or its affiliates.
8*cdf0e10cSrcweir
9*cdf0e10cSrcweir  OpenOffice.org - a multi-platform office productivity suite
10*cdf0e10cSrcweir
11*cdf0e10cSrcweir  This file is part of OpenOffice.org.
12*cdf0e10cSrcweir
13*cdf0e10cSrcweir  OpenOffice.org is free software: you can redistribute it and/or modify
14*cdf0e10cSrcweir  it under the terms of the GNU Lesser General Public License version 3
15*cdf0e10cSrcweir  only, as published by the Free Software Foundation.
16*cdf0e10cSrcweir
17*cdf0e10cSrcweir  OpenOffice.org is distributed in the hope that it will be useful,
18*cdf0e10cSrcweir  but WITHOUT ANY WARRANTY; without even the implied warranty of
19*cdf0e10cSrcweir  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
20*cdf0e10cSrcweir  GNU Lesser General Public License version 3 for more details
21*cdf0e10cSrcweir  (a copy is included in the LICENSE file that accompanied this code).
22*cdf0e10cSrcweir
23*cdf0e10cSrcweir  You should have received a copy of the GNU Lesser General Public License
24*cdf0e10cSrcweir  version 3 along with OpenOffice.org.  If not, see
25*cdf0e10cSrcweir  <http://www.openoffice.org/license.html>
26*cdf0e10cSrcweir  for a copy of the LGPLv3 License.
27*cdf0e10cSrcweir
28*cdf0e10cSrcweir #*************************************************************************
29*cdf0e10cSrcweir -->
30*cdf0e10cSrcweir<HTML>
31*cdf0e10cSrcweir<HEAD>
32*cdf0e10cSrcweir	<TITLE>org.openoffice.xmerge.converter.xml.xslt package</TITLE>
33*cdf0e10cSrcweir</HEAD>
34*cdf0e10cSrcweir<BODY>
35*cdf0e10cSrcweir<P>Provides the tools for doing the conversion of StarWriter XML to
36*cdf0e10cSrcweirand from supported formats, through the use of an XSLT
37*cdf0e10cSrcweirtransformation.</P>
38*cdf0e10cSrcweir<P>It follows the {@link org.openoffice.xmerge}
39*cdf0e10cSrcweirframework for the conversion process.</P>
40*cdf0e10cSrcweir<P>This converter does not currently support merge.</P>
41*cdf0e10cSrcweir<P><FONT FACE="Times New Roman, serif"><FONT SIZE=5><B>XSLT
42*cdf0e10cSrcweirTransformation</B></FONT></FONT></P>
43*cdf0e10cSrcweir<p>The converter makes use
44*cdf0e10cSrcweirof one or more XSLT style sheets, which are used in the
45*cdf0e10cSrcweirDocumentSerializer and DocumentDeserializer, to perform the actual
46*cdf0e10cSrcweirtranslations. 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.
47*cdf0e10cSrcweirA sample OpenOffice to Html stylesheet and Html to
48*cdf0e10cSrcweirOpenffice stylesheet, has been provided as a sample implementation.
49*cdf0e10cSrcweirThe 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.
50*cdf0e10cSrcweir</p>
51*cdf0e10cSrcweir
52*cdf0e10cSrcweir<H2>TODO list</H2>
53*cdf0e10cSrcweir
54*cdf0e10cSrcweir<p><ol>
55*cdf0e10cSrcweir<li>Expand XSLT style sheets to support more office/html
56*cdf0e10cSrcweir    capabilities</li>
57*cdf0e10cSrcweir<li>Add support for certain character codes, such as &amp;nbsp
58*cdf0e10cSrcweir    which currently causes the transformer to break.</li>
59*cdf0e10cSrcweir<li>Change the DocumentDeserializer transformer, so that the DOMResult is serialized using the xalan serializer and create an SxwDocument from the result</li>
60*cdf0e10cSrcweir</ol></p>
61*cdf0e10cSrcweir
62*cdf0e10cSrcweir@see org.openoffice.xmerge.util.registry
63*cdf0e10cSrcweir
64*cdf0e10cSrcweir</BODY>
65*cdf0e10cSrcweir</HTML>
66*cdf0e10cSrcweir
67*cdf0e10cSrcweir
68