1cdf0e10cSrcweir<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
2cdf0e10cSrcweir<!--
3161f4cd1SAndrew Rist#**************************************************************
4161f4cd1SAndrew Rist#
5161f4cd1SAndrew Rist#  Licensed to the Apache Software Foundation (ASF) under one
6161f4cd1SAndrew Rist#  or more contributor license agreements.  See the NOTICE file
7161f4cd1SAndrew Rist#  distributed with this work for additional information
8161f4cd1SAndrew Rist#  regarding copyright ownership.  The ASF licenses this file
9161f4cd1SAndrew Rist#  to you under the Apache License, Version 2.0 (the
10161f4cd1SAndrew Rist#  "License"); you may not use this file except in compliance
11161f4cd1SAndrew Rist#  with the License.  You may obtain a copy of the License at
12161f4cd1SAndrew Rist#
13161f4cd1SAndrew Rist#    http://www.apache.org/licenses/LICENSE-2.0
14161f4cd1SAndrew Rist#
15161f4cd1SAndrew Rist#  Unless required by applicable law or agreed to in writing,
16161f4cd1SAndrew Rist#  software distributed under the License is distributed on an
17161f4cd1SAndrew Rist#  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
18161f4cd1SAndrew Rist#  KIND, either express or implied.  See the License for the
19161f4cd1SAndrew Rist#  specific language governing permissions and limitations
20161f4cd1SAndrew Rist#  under the License.
21161f4cd1SAndrew Rist#
22161f4cd1SAndrew Rist#**************************************************************
23cdf0e10cSrcweir -->
24cdf0e10cSrcweir<HTML>
25cdf0e10cSrcweir<HEAD>
26cdf0e10cSrcweir	<TITLE>org.openoffice.xmerge.converter.xml.xslt package</TITLE>
27cdf0e10cSrcweir</HEAD>
28cdf0e10cSrcweir<BODY>
29cdf0e10cSrcweir<P>Provides the tools for doing the conversion of StarWriter XML to
30cdf0e10cSrcweirand from supported formats, through the use of an XSLT
31cdf0e10cSrcweirtransformation.</P>
32cdf0e10cSrcweir<P>It follows the {@link org.openoffice.xmerge}
33cdf0e10cSrcweirframework for the conversion process.</P>
34cdf0e10cSrcweir<P>This converter does not currently support merge.</P>
35cdf0e10cSrcweir<P><FONT FACE="Times New Roman, serif"><FONT SIZE=5><B>XSLT
36cdf0e10cSrcweirTransformation</B></FONT></FONT></P>
37cdf0e10cSrcweir<p>The converter makes use
38cdf0e10cSrcweirof one or more XSLT style sheets, which are used in the
39cdf0e10cSrcweirDocumentSerializer and DocumentDeserializer, to perform the actual
40cdf0e10cSrcweirtranslations. 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*ff3f4ebcSOliver-Rainer WittmannA sample OpenOffice.org XML to Html stylesheet and Html to
42*ff3f4ebcSOliver-Rainer WittmannOpenffice.org XML stylesheet, has been provided as a sample implementation.
43cdf0e10cSrcweirThe 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.
44cdf0e10cSrcweir</p>
45cdf0e10cSrcweir
46cdf0e10cSrcweir<H2>TODO list</H2>
47cdf0e10cSrcweir
48cdf0e10cSrcweir<p><ol>
49cdf0e10cSrcweir<li>Expand XSLT style sheets to support more office/html
50cdf0e10cSrcweir    capabilities</li>
51cdf0e10cSrcweir<li>Add support for certain character codes, such as &amp;nbsp
52cdf0e10cSrcweir    which currently causes the transformer to break.</li>
53cdf0e10cSrcweir<li>Change the DocumentDeserializer transformer, so that the DOMResult is serialized using the xalan serializer and create an SxwDocument from the result</li>
54cdf0e10cSrcweir</ol></p>
55cdf0e10cSrcweir
56cdf0e10cSrcweir@see org.openoffice.xmerge.util.registry
57cdf0e10cSrcweir
58cdf0e10cSrcweir</BODY>
59cdf0e10cSrcweir</HTML>
60cdf0e10cSrcweir
61cdf0e10cSrcweir
62