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