1*b1cdbd2cSJim Jagielski<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
2*b1cdbd2cSJim Jagielski<!--
3*b1cdbd2cSJim Jagielski#**************************************************************
4*b1cdbd2cSJim Jagielski#
5*b1cdbd2cSJim Jagielski#  Licensed to the Apache Software Foundation (ASF) under one
6*b1cdbd2cSJim Jagielski#  or more contributor license agreements.  See the NOTICE file
7*b1cdbd2cSJim Jagielski#  distributed with this work for additional information
8*b1cdbd2cSJim Jagielski#  regarding copyright ownership.  The ASF licenses this file
9*b1cdbd2cSJim Jagielski#  to you under the Apache License, Version 2.0 (the
10*b1cdbd2cSJim Jagielski#  "License"); you may not use this file except in compliance
11*b1cdbd2cSJim Jagielski#  with the License.  You may obtain a copy of the License at
12*b1cdbd2cSJim Jagielski#
13*b1cdbd2cSJim Jagielski#    http://www.apache.org/licenses/LICENSE-2.0
14*b1cdbd2cSJim Jagielski#
15*b1cdbd2cSJim Jagielski#  Unless required by applicable law or agreed to in writing,
16*b1cdbd2cSJim Jagielski#  software distributed under the License is distributed on an
17*b1cdbd2cSJim Jagielski#  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
18*b1cdbd2cSJim Jagielski#  KIND, either express or implied.  See the License for the
19*b1cdbd2cSJim Jagielski#  specific language governing permissions and limitations
20*b1cdbd2cSJim Jagielski#  under the License.
21*b1cdbd2cSJim Jagielski#
22*b1cdbd2cSJim Jagielski#**************************************************************
23*b1cdbd2cSJim Jagielski -->
24*b1cdbd2cSJim Jagielski<HTML>
25*b1cdbd2cSJim Jagielski<HEAD>
26*b1cdbd2cSJim Jagielski	<TITLE>org.openoffice.xmerge.converter.xml.xslt package</TITLE>
27*b1cdbd2cSJim Jagielski</HEAD>
28*b1cdbd2cSJim Jagielski<BODY>
29*b1cdbd2cSJim Jagielski<P>Provides the tools for doing the conversion of StarWriter XML to
30*b1cdbd2cSJim Jagielskiand from supported formats, through the use of an XSLT
31*b1cdbd2cSJim Jagielskitransformation.</P>
32*b1cdbd2cSJim Jagielski<P>It follows the {@link org.openoffice.xmerge}
33*b1cdbd2cSJim Jagielskiframework for the conversion process.</P>
34*b1cdbd2cSJim Jagielski<P>This converter does not currently support merge.</P>
35*b1cdbd2cSJim Jagielski<P><FONT FACE="Times New Roman, serif"><FONT SIZE=5><B>XSLT
36*b1cdbd2cSJim JagielskiTransformation</B></FONT></FONT></P>
37*b1cdbd2cSJim Jagielski<p>The converter makes use
38*b1cdbd2cSJim Jagielskiof one or more XSLT style sheets, which are used in the
39*b1cdbd2cSJim JagielskiDocumentSerializer and DocumentDeserializer, to perform the actual
40*b1cdbd2cSJim Jagielskitranslations. 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.
41*b1cdbd2cSJim JagielskiA sample OpenOffice.org XML to Html stylesheet and Html to
42*b1cdbd2cSJim JagielskiOpenffice.org XML stylesheet, has been provided as a sample implementation.
43*b1cdbd2cSJim JagielskiThe 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.
44*b1cdbd2cSJim Jagielski</p>
45*b1cdbd2cSJim Jagielski
46*b1cdbd2cSJim Jagielski<H2>TODO list</H2>
47*b1cdbd2cSJim Jagielski
48*b1cdbd2cSJim Jagielski<p><ol>
49*b1cdbd2cSJim Jagielski<li>Expand XSLT style sheets to support more office/html
50*b1cdbd2cSJim Jagielski    capabilities</li>
51*b1cdbd2cSJim Jagielski<li>Add support for certain character codes, such as &amp;nbsp
52*b1cdbd2cSJim Jagielski    which currently causes the transformer to break.</li>
53*b1cdbd2cSJim Jagielski<li>Change the DocumentDeserializer transformer, so that the DOMResult is serialized using the xalan serializer and create an SxwDocument from the result</li>
54*b1cdbd2cSJim Jagielski</ol></p>
55*b1cdbd2cSJim Jagielski
56*b1cdbd2cSJim Jagielski@see org.openoffice.xmerge.util.registry
57*b1cdbd2cSJim Jagielski
58*b1cdbd2cSJim Jagielski</BODY>
59*b1cdbd2cSJim Jagielski</HTML>
60*b1cdbd2cSJim Jagielski
61*b1cdbd2cSJim Jagielski
62