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 30 and from supported formats, through the use of an XSLT 31 transformation.</P> 32 <P>It follows the {@link org.openoffice.xmerge} 33 framework 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 36 Transformation</B></FONT></FONT></P> 37 <p>The converter makes use 38 of one or more XSLT style sheets, which are used in the 39 DocumentSerializer and DocumentDeserializer, to perform the actual 40 translations. 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 A sample OpenOffice to Html stylesheet and Html to 42 Openffice stylesheet, has been provided as a sample implementation. 43 The 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 &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