migrating-to-2.2.html 6.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556
  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="In DITA-OT 2.2, the HTML5 transformation was refactored as its own plugin and separate plugins were created for each of the rendering engine-specific PDF transformations."><meta name="DC.Relation" scheme="URI" content="../dev_ref/migration.html"><meta name="DC.Format" content="XHTML"><meta name="DC.Identifier" content="migrating-to-2.2"><link rel="stylesheet" type="text/css" href="../css/commonltr.css"><link rel="stylesheet" type="text/css" href="../css/dita-ot-doc.css"><title>Migrating to release 2.2</title></head><body id="migrating-to-2.2"><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><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 class="active"><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 to release 2.2</h1>
  8. <div class="body refbody"><p class="shortdesc">In DITA-OT 2.2, the <span class="keyword option">HTML5</span> transformation was refactored as its own
  9. plugin and separate plugins were created for each of the rendering engine-specific PDF
  10. transformations.
  11. </p>
  12. <section class="section">
  13. <div class="note note note_note"><span class="note__title notetitle">Note:</span> This topic provides a summary of changes in DITA-OT 2.2 that may require modifications to custom stylesheets
  14. or plug-ins. For more information on changes in this release, see the <a class="xref" href="http://www.dita-ot.org/2.2/release-notes/" target="_blank">DITA-OT 2.2 Release Notes</a>.</div>
  15. </section>
  16. <section class="section"><h2 class="title sectiontitle">HTML5</h2>
  17. <p class="p">The <span class="keyword option">HTML5</span> transformation introduced in release 2.0 as part of the
  18. <span class="keyword option">XHTML</span> plugin has been moved to a separate <span class="keyword option">HTML5</span> plugin.
  19. Customizations that extended the previous HTML5 output under the <span class="keyword option">XHTML</span>
  20. plugin will probably need to be refactored on the new HTML5 plugin.</p>
  21. <p class="p">Note title processing has been revised to use a common <code class="ph codeph">note__title</code> class for note elements of
  22. all types. The legacy <code class="ph codeph"><var class="keyword varname">{$type}</var>title</code> classes (such as
  23. <code class="ph codeph">.notetitle</code>, <code class="ph codeph">.cautiontitle</code>, <code class="ph codeph">.tiptitle</code>, etc.) are included
  24. for backwards compatibility, but are deprecated and will be removed in an upcoming release. Stylesheets that
  25. apply formatting overrides to note titles should be revised to replace the deprecated class selectors with the
  26. equivalent descendant selectors, for example <code class="ph codeph">.note_note .note__title</code>, <code class="ph codeph">.note_caution
  27. .note__title</code>, <code class="ph codeph">.note_tip .note__title</code>, etc.</p>
  28. </section>
  29. <section class="section"><h2 class="title sectiontitle">PDF</h2>
  30. <p class="p">Processing specific to Apache FOP, Antenna House Formatter, and RenderX XEP has been
  31. separated into separate plugins for each of those rendering engines. Customizations that
  32. extended this processing might need to extend the new <span class="keyword">org.dita.pdf2.fop</span>,
  33. <span class="keyword">org.dita.pdf2.axf</span>, or <span class="keyword">org.dita.pdf2.xep</span> plugins.</p>
  34. <p class="p">PDF customizations that are not specific to a rendering engine can continue to extend the
  35. <span class="keyword">org.dita.pdf2</span> plugin as before.</p>
  36. </section>
  37. <section class="section"><h2 class="title sectiontitle">Deprecated properties</h2>
  38. <div class="p">The following Ant properties have been deprecated:
  39. <ul class="ul">
  40. <li class="li"><span class="keyword parmname">user.input.file</span>, use <span class="keyword parmname">user.input.file.uri</span> instead to specify the
  41. input file system path</li>
  42. <li class="li"><span class="keyword parmname">user.input.dir</span>, use <span class="keyword parmname">user.input.dir.uri</span> instead to specify the
  43. input directory system path</li>
  44. <li class="li"><span class="keyword parmname">InputMapDir</span>, use <span class="keyword parmname">InputMapDir.uri</span> instead to specify the input
  45. map directory system path</li>
  46. </ul></div>
  47. </section>
  48. </div>
  49. <nav role="navigation" class="related-links"><div class="familylinks"><div class="parentlink"><strong>Parent topic:</strong> <a class="link" href="../dev_ref/migration.html" title="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.">Migrating customizations</a></div></div></nav></article></main></body></html>