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