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