migration.html 7.9 KB

1234567891011121314151617
  1. <!DOCTYPE html
  2. SYSTEM "about:legacy-compat">
  3. <html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta charset="UTF-8"><meta name="copyright" content="(C) Copyright 2016"><meta name="DC.rights.owner" content="(C) Copyright 2016"><meta name="DC.Type" content="reference"><meta name="description" content="If you have XSL transformation overrides, plug-ins or other customizations written prior to DITA-OT 2.3, you may need to make changes to ensure your overrides work properly with the latest toolkit versions."><meta name="DC.Relation" scheme="URI" content="../dev_ref/index.html"><meta name="DC.Relation" scheme="URI" content="../dev_ref/migrating-to-2.3.html"><meta name="DC.Relation" scheme="URI" content="../dev_ref/migrating-to-2.2.html"><meta name="DC.Relation" scheme="URI" content="../dev_ref/migrating-to-2.1.html"><meta name="DC.Relation" scheme="URI" content="../dev_ref/migrating-to-2.0.html"><meta name="DC.Relation" scheme="URI" content="../dev_ref/migrating-to-1.8.html"><meta name="DC.Relation" scheme="URI" content="../dev_ref/migrating-to-1.7.html"><meta name="DC.Relation" scheme="URI" content="../dev_ref/migrating-to-1.6.html"><meta name="DC.Relation" scheme="URI" content="../dev_ref/migrating-to-1.5.4.html"><meta name="DC.Format" content="XHTML"><meta name="DC.Identifier" content="ID"><link rel="stylesheet" type="text/css" href="../css/commonltr.css"><link rel="stylesheet" type="text/css" href="../css/dita-ot-doc.css"><title>Migrating customizations</title></head><body id="ID"><header role="banner"><div class="header">
  4. <p>DITA Open Toolkit</p>
  5. <hr>
  6. </div></header><nav role="toc"><ul><li><a href="../index.html">DITA Open Toolkit 2.3</a></li><li><a href="../release-notes/index.html">Release Notes</a></li><li><a href="../getting-started/index.html">Getting Started</a></li><li><a href="../user-guide/index.html">User Guide</a></li><li><a href="../parameters/index.html">Parameter Reference</a></li><li><a href="../dev_ref/index.html">Developer Reference</a><ul><li><a href="../dev_ref/DITA-OTArchitecture.html">DITA-OT Architecture</a></li><li><a href="../dev_ref/extending-the-ot.html">Extending the DITA-OT</a></li><li><a href="../dev_ref/plugin-creating.html">Creating plug-ins</a></li><li><a href="../dev_ref/plugin-extension-points.html">Extension points</a></li><li><a href="../dev_ref/pdf-customization.html">Customizing PDF output</a></li><li class="active"><a href="../dev_ref/migration.html">Migrating customizations</a><ul><li><a href="../dev_ref/migrating-to-2.3.html">To 2.3</a></li><li><a href="../dev_ref/migrating-to-2.2.html">To 2.2</a></li><li><a href="../dev_ref/migrating-to-2.1.html">To 2.1</a></li><li><a href="../dev_ref/migrating-to-2.0.html">To 2.0</a></li><li><a href="../dev_ref/migrating-to-1.8.html">To 1.8</a></li><li><a href="../dev_ref/migrating-to-1.7.html">To 1.7</a></li><li><a href="../dev_ref/migrating-to-1.6.html">To 1.6</a></li><li><a href="../dev_ref/migrating-to-1.5.4.html">To 1.5.4</a></li></ul></li></ul></li><li><a href="../user-guide/dita-and-dita-ot-resources.html">DITA Resources</a></li></ul></nav><main role="main"><article role="article" aria-labelledby="ariaid-title1">
  7. <h1 class="title topictitle1" id="ariaid-title1">Migrating customizations</h1>
  8. <div class="body refbody"><p class="shortdesc">If you have XSL transformation overrides, plug-ins or other customizations written prior to DITA-OT
  9. <span class="keyword">2.3</span>, you may need to make changes to ensure your overrides work properly with the latest
  10. toolkit versions. </p>
  11. <section class="section">
  12. <p class="p">In some cases, you may be able to remove old code that is no longer needed. In other cases, you may need to
  13. refactor your code to point to the modified extension points, templates or modes in recent toolkit versions.</p>
  14. </section>
  15. </div>
  16. <nav role="navigation" class="related-links"><ul class="ullinks"><li class="link ulchildlink"><strong><a href="../dev_ref/migrating-to-2.3.html">Migrating to release 2.3</a></strong><br>In DITA-OT 2.3, <span class="keyword option">HTML5</span> table processing has been refactored to use HTML5 best practices and improved CSS properties. In PDF output, table heads and key columns no longer include shading, and unused localization variables have been deprecated. The template for generated error messages has been updated to use a single <code class="ph codeph">id</code> variable that contains the entire message ID.</li><li class="link ulchildlink"><strong><a href="../dev_ref/migrating-to-2.2.html">Migrating to release 2.2</a></strong><br>In DITA-OT 2.2, the <span class="keyword option">HTML5</span> transformation was refactored as its own plugin and separate plugins were created for each of the rendering engine-specific PDF transformations. </li><li class="link ulchildlink"><strong><a href="../dev_ref/migrating-to-2.1.html">Migrating to release 2.1</a></strong><br>In DITA-OT 2.1, the <code class="ph codeph">insertVariable</code> template was deprecated for PDF transformations and should be replaced with the <code class="ph codeph">getVariable</code> template. Various <code class="ph codeph">dita.<strong class="ph b">out.</strong>map.*</code> targets have been deprecated in favor of updated <code class="ph codeph">dita.map.*</code> equivalents.</li><li class="link ulchildlink"><strong><a href="../dev_ref/migrating-to-2.0.html">Migrating to release 2.0</a></strong><br>In DITA-OT 2.0, XSLT templates were converted to XSLT 2.0, variable typing was implemented, and some older templates were refactored or removed. In addition, the <span class="keyword cmdname">dita</span> command simplifies distribution of plugins by allowing installation from a URL. </li><li class="link ulchildlink"><strong><a href="../dev_ref/migrating-to-1.8.html">Migrating to release 1.8</a></strong><br>In DITA-OT 1.8, certain stylesheets were moved to plug-in specific folders and various deprecated Ant properties, XSLT stylesheets, parameters and modes were removed from the XHTML, PDF and ODT transformations.</li><li class="link ulchildlink"><strong><a href="../dev_ref/migrating-to-1.7.html">Migrating to release 1.7</a></strong><br>In DITA-OT 1.7, a new preprocessing step implements flagging for HTML-based output formats. PDF processing was corrected with regard to <code class="ph codeph">shortdesc</code> handling, and a new XSLT template mode was introduced for HTML TOC processing. Several stylesheets were moved to plug-in specific folders and deprecated properties and XSLT variables were removed. </li><li class="link ulchildlink"><strong><a href="../dev_ref/migrating-to-1.6.html">Migrating to release 1.6</a></strong><br>In DITA-OT 1.6, various <span class="ph filepath">demo</span> plug-ins were removed along with many deprecated properties, targets, templates and modes. The PDF2 transformation no longer supports the beta version of DITA from IBM, the "bkinfo" demo plug-in, or <span class="ph filepath">layout-masters.xml</span> configuration.</li><li class="link ulchildlink"><strong><a href="../dev_ref/migrating-to-1.5.4.html">Migrating to release 1.5.4</a></strong><br>DITA-OT 1.5.4 adds new extension points to configure behavior based on file extensions, declare print transformation types and add mappings to the PDF configuration catalog file. PDF output supports mirrored page layout and uses new font family definitions. Support for several new languages was added for PDF and XHTML output.</li></ul><div class="familylinks"><div class="parentlink"><strong>Parent topic:</strong> <a class="link" href="../dev_ref/index.html" title="The Developer Reference is designed to provide more advanced information about the DITA-OT. It is geared to an audience that needs information about the DITA-OT architecture, extending the DITA-OT, and creating DITA-OT plug-ins.">DITA Open Toolkit Developer Reference</a></div></div></nav></article></main></body></html>