migrating-to-3.2.dita 2.9 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">
  3. <!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
  4. <reference id="migrating-to-3.2">
  5. <title>Migrating to release 3.2</title>
  6. <titlealts>
  7. <navtitle>To 3.2</navtitle>
  8. </titlealts>
  9. <shortdesc>DITA-OT 3.2 includes <ph id="summary">new command-line options, support for RELAX NG parsing and
  10. validation, preliminary processing for the XDITA authoring format proposed for Lightweight DITA, and a plug-in
  11. registry that makes it easier to discover and install new plug-ins</ph>.</shortdesc>
  12. <prolog>
  13. <metadata>
  14. <keywords>
  15. <indexterm>deprecated features<indexterm><parmname>configuration-jar</parmname> Ant target</indexterm></indexterm>
  16. <indexterm>Lightweight DITA</indexterm>
  17. <indexterm>command line<indexterm>RELAX NG parsing</indexterm></indexterm>
  18. <indexterm>security</indexterm>
  19. <indexterm>TLS</indexterm>
  20. <indexterm>registry</indexterm>
  21. <indexterm>targets<indexterm>deprecated</indexterm></indexterm>
  22. <indexterm>classpath<indexterm><parmname>configuration-jar</parmname></indexterm></indexterm>
  23. </keywords>
  24. </metadata>
  25. </prolog>
  26. <refbody>
  27. <section>
  28. <note>This topic provides a summary of changes in DITA-OT 3.2 that may require modifications to custom stylesheets
  29. or plug-ins. For more information on changes in this release, see the
  30. <xref keyref="3.2-release-notes"/>.</note>
  31. </section>
  32. <section>
  33. <title>Deprecated targets</title>
  34. <p>The <parmname>configuration-jar</parmname> Ant target used during the plug-in integration process has been
  35. deprecated and may be removed in an upcoming release. This was previously used to package additional
  36. configuration files and properties into <filepath>lib/dost-configuration.jar</filepath>, but recent versions of
  37. DITA-OT include the <filepath>config</filepath> directory in the classpath for this purpose, so the
  38. configuration JAR is no longer necessary.</p>
  39. </section>
  40. <section>
  41. <title>Secure connections to the plug-in registry</title>
  42. <note type="attention">To ensure data integrity during the plug-in installation process, Transport Layer Security
  43. (TLS) will soon be required to access the plug-in registry. If you are using DITA-OT 3.2 or 3.2.1 and are unable
  44. to upgrade to the latest version, modify the <codeph>registry</codeph> key in the
  45. <filepath>config/configuration.properties</filepath> file to switch the URI schema to
  46. <codeph>http<b>s</b>://</codeph>, so the entry reads <codeph>https://plugins.dita-ot.org/</codeph>.</note>
  47. <p>For more information, see
  48. <xref keyref="plugins-registry"/>.</p>
  49. </section>
  50. </refbody>
  51. </reference>