xmerge/source/htmlsoff/package.html

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