Home Explore Help
Sign In
bn
/
se
2
0
Fork 0
Files Issues 0 Pull Requests 0 Wiki
Tree: a4b429aad5
Branches Tags
se
/
SE
/
schema
/
WPS_Functions
/
dita-ot
/
dita-ot-3.3.3
/
doc
/
topics
/
migrating-to-1.6.html

migrating-to-1.6.html 14 KB
History Raw

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173 
  1. <!DOCTYPE html
    2. 

  2.   SYSTEM "about:legacy-compat">
    3. 

  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 2019"><meta name="DC.rights.owner" content="(C) Copyright 2019"><meta name="DC.type" content="reference"><meta name="description" content="In DITA-OT 1.6, various demo 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 &#34;bkinfo&#34; demo plug-in, or layout-masters.xml configuration."><meta name="DC.subject" content="deprecated features, folder, demo, processing instruction, workdir, topic pull templates, list of, &#34;bkinfo&#34; demo plug-in, layout-masters.xml, PDF2 templates, list of, XHTML templates, list of, ODT templates, list of"><meta name="keywords" content="deprecated features, folder, demo, processing instruction, workdir, topic pull templates, list of, &#34;bkinfo&#34; demo plug-in, layout-masters.xml, PDF2 templates, list of, XHTML templates, list of, ODT templates, list of"><meta name="DC.relation" scheme="URI" content="../topics/migration.html"><meta name="DC.format" content="HTML5"><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 to release 1.6</title></head><body id="ID"><header role="banner"><div class="header">
    4. 

  4.   <p>DITA Open Toolkit</p>
    5. 

  5.   <hr>
    6. 

  6. </div></header><nav role="toc"><ul><li><a href="../index.html">DITA Open Toolkit 3.3</a></li><li><a href="../release-notes/index.html">Release Notes</a></li><li><a href="../topics/installing-client.html">Installing DITA-OT</a></li><li><a href="../topics/alternative-input-formats.html">Authoring formats</a></li><li><a href="../topics/building-output.html">Building output</a></li><li><a href="../parameters/index.html">Setting parameters</a></li><li><a href="../topics/customizing.html">Customizing DITA-OT</a><ul><li><a href="../topics/html-customization.html">Customizing HTML</a></li><li><a href="../topics/pdf-customization.html">Customizing PDF</a></li><li><a href="../topics/custom-plugins.html">Working with plug-ins</a></li><li><a href="../extension-points/plugin-extension-points.html">Extension points</a></li><li><a href="../topics/migration.html">Migrating customizations</a><ul><li><a href="../topics/migrating-to-3.3.html">To 3.3</a></li><li><a href="../topics/migrating-to-3.2.html">To 3.2</a></li><li><a href="../topics/migrating-to-3.1.html">To 3.1</a></li><li><a href="../topics/migrating-to-3.0.html">To 3.0</a></li><li><a href="../topics/migrating-to-2.5.html">To 2.5</a></li><li><a href="../topics/migrating-to-2.4.html">To 2.4</a></li><li><a href="../topics/migrating-to-2.3.html">To 2.3</a></li><li><a href="../topics/migrating-to-2.2.html">To 2.2</a></li><li><a href="../topics/migrating-to-2.1.html">To 2.1</a></li><li><a href="../topics/migrating-to-2.0.html">To 2.0</a></li><li><a href="../topics/migrating-to-1.8.html">To 1.8</a></li><li><a href="../topics/migrating-to-1.7.html">To 1.7</a></li><li class="active"><a href="../topics/migrating-to-1.6.html">To 1.6</a></li><li><a href="../topics/migrating-to-1.5.4.html">To 1.5.4</a></li></ul></li><li><a href="../topics/globalization.html">Globalizing DITA content</a></li><li><a href="../topics/rebuilding-docs.html">Rebuilding documentation</a></li></ul></li><li><a href="../topics/troubleshooting-overview.html">Troubleshooting</a></li><li><a href="../reference/index.html">Reference</a></li><li><a href="../topics/dita-and-dita-ot-resources.html">Resources</a></li></ul></nav><main role="main"><article role="article" aria-labelledby="ariaid-title1">
    7. 

  7. 

  8.   <h1 class="title topictitle1" id="ariaid-title1">Migrating to release 1.6</h1>
    9. 

  9.   
    10. 

  10. 

  11.   
    12. 

  12.   
    13. 

  13.   
    14. 

  14. 

  15.   <div class="body refbody"><p class="shortdesc">In DITA-OT 1.6, various <span class="ph filepath">demo</span> plug-ins were removed along with many deprecated
    16. 

  16.     properties, targets, templates and modes. The PDF2 transformation no longer supports the beta version of DITA from
    17. 

  17.     IBM, the "bkinfo" demo plug-in, or <span class="ph filepath">layout-masters.xml</span> configuration.</p>
    18. 

  18.     <section class="section">
    19. 

  19.       <p class="p">Support for the old DITAVAL format (used before OASIS added DITAVAL to the standard in 2007) has been
    20. 

  20.         removed.</p>
    21. 

  21.       <p class="p">The <span class="ph filepath">demo</span> folder has been deprecated and the following plug-ins have been moved to the
    22. 

  22.           <span class="ph filepath">plugins</span> folder:</p>
    23. 

  23.       <table class="table table-hover frame-none"><caption></caption><colgroup><col style="width:50%"><col style="width:50%"></colgroup><thead class="thead">
    24. 

  24.             <tr class="row">
    25. 

  25.               <th class="entry colsep-0 rowsep-1" id="ID__entry__1">old path</th>
    26. 

  26.               <th class="entry colsep-0 rowsep-1" id="ID__entry__2">new path</th>
    27. 

  27.             </tr>
    28. 

  28.           </thead><tbody class="tbody">
    29. 

  29.             <tr class="row">
    30. 

  30.               <td class="entry colsep-0 rowsep-1" headers="ID__entry__1"><span class="ph filepath">demo/dita11</span></td>
    31. 

  31.               <td class="entry colsep-0 rowsep-1" headers="ID__entry__2"><span class="ph filepath">plugins/org.dita.specialization.dita11</span></td>
    32. 

  32.             </tr>
    33. 

  33.             <tr class="row">
    34. 

  34.               <td class="entry colsep-0 rowsep-1" headers="ID__entry__1"><span class="ph filepath">demo/dita132</span></td>
    35. 

  35.               <td class="entry colsep-0 rowsep-1" headers="ID__entry__2"><span class="ph filepath">plugins/org.dita.specialization.dita132</span></td>
    36. 

  36.             </tr>
    37. 

  37.             <tr class="row">
    38. 

  38.               <td class="entry colsep-0 rowsep-1" headers="ID__entry__1"><span class="ph filepath">demo/eclipsemap</span></td>
    39. 

  39.               <td class="entry colsep-0 rowsep-1" headers="ID__entry__2"><span class="ph filepath">plugins/org.dita.specialization.eclipsemap</span></td>
    40. 

  40.             </tr>
    41. 

  41.             <tr class="row">
    42. 

  42.               <td class="entry colsep-0 rowsep-1" headers="ID__entry__1"><span class="ph filepath">demo/fo</span></td>
    43. 

  43.               <td class="entry colsep-0 rowsep-1" headers="ID__entry__2"><span class="ph filepath">plugins/org.dita.pdf2</span></td>
    44. 

  44.             </tr>
    45. 

  45.             <tr class="row">
    46. 

  46.               <td class="entry colsep-0 rowsep-1" headers="ID__entry__1"><span class="ph filepath">demo/tocjs</span></td>
    47. 

  47.               <td class="entry colsep-0 rowsep-1" headers="ID__entry__2"><span class="ph filepath">plugins/com.sophos.tocjs</span></td>
    48. 

  48.             </tr>
    49. 

  49.             
    50. 

  50.             <tr class="row">
    51. 

  51.               <td class="entry colsep-0 rowsep-1" headers="ID__entry__1"><span class="ph filepath">demo/h2d</span></td>
    52. 

  52.               <td class="entry colsep-0 rowsep-1" headers="ID__entry__2"><span class="ph filepath">plugins/h2d</span></td>
    53. 

  53.             </tr>
    54. 

  54.             <tr class="row">
    55. 

  55.               <td class="entry colsep-0 rowsep-1" headers="ID__entry__1"><span class="ph filepath">demo/legacypdf</span></td>
    56. 

  56.               <td class="entry colsep-0 rowsep-1" headers="ID__entry__2"><span class="ph filepath">plugins/legacypdf</span></td>
    57. 

  57.             </tr>
    58. 

  58.           </tbody></table>
    59. 

  59.       <p class="p">The remaining plug-ins in the demo folder have been moved to a separate repository at <a class="xref" href="https://github.com/dita-ot/ext-plugins" target="_blank">github.com/dita-ot/ext-plugins</a>.</p>
    60. 

  60.     </section>
    61. 

  61.     <section class="section">
    62. 

  62.       <p class="p">The deprecated property <code class="ph codeph">dita.input.valfile</code> should be replaced with the new argument property
    63. 

  63.           <code class="ph codeph">args.filter</code>.</p>
    64. 

  64.       <p class="p">The <code class="ph codeph">dita-preprocess</code> target has been removed and dependencies should be replaced with a target
    65. 

  65.         sequence <code class="ph codeph">build-init, preprocess</code>.</p>
    66. 

  66.       <p class="p">Support for the <code class="ph codeph">args.message.file</code> argument has been removed as message configuration has
    67. 

  67.         become static configuration.</p>
    68. 

  68.       <p class="p">The <code class="ph codeph">workdir</code> processing instruction has been deprecated in favor of
    69. 

  69.           <code class="ph codeph">workdir-uri</code>. The only difference between the two processing instructions is that
    70. 

  70.           <code class="ph codeph">workdir-uri</code> contains a URI instead of a system path.</p>
    71. 

  71.     </section>
    72. 

  72.     <section class="section"><h2 class="title sectiontitle">Preprocessing</h2>
    73. 

  73.       
    74. 

  74.       <p class="p">The following deprecated templates and modes have been removed in topic pull stylesheets:</p>
    75. 

  75.       <ul class="ul">
    76. 

  76.         <li class="li">inherit</li>
    77. 

  77.         <li class="li">get-stuff</li>
    78. 

  78.         <li class="li">verify-type-attribute</li>
    79. 

  79.         <li class="li">classval</li>
    80. 

  80.         <li class="li">getshortdesc</li>
    81. 

  81.         <li class="li">getlinktext</li>
    82. 

  82.         <li class="li">blocktext</li>
    83. 

  83.         <li class="li">figtext</li>
    84. 

  84.         <li class="li">tabletext</li>
    85. 

  85.         <li class="li">litext</li>
    86. 

  86.         <li class="li">fntext</li>
    87. 

  87.         <li class="li">dlentrytext</li>
    88. 

  88.         <li class="li">firstclass</li>
    89. 

  89.         <li class="li">invalid-list-item</li>
    90. 

  90.         <li class="li">xref</li>
    91. 

  91.       </ul>
    92. 

  92.     </section>
    93. 

  93.     <section class="section"><h2 class="title sectiontitle">PDF2</h2>
    94. 

  94.       
    95. 

  95.       <p class="p">The following deprecated items are no longer supported in the PDF transform:</p>
    96. 

  96.       <ul class="ul">
    97. 

  97.         <li class="li">Support for the beta version of DITA, available from IBM before the OASIS standard was created in 2005.</li>
    98. 

  98.         <li class="li">Support for the "bkinfo" demo plug-in, used to support book metadata before OASIS created the BookMap format
    99. 

  99.           in 2007.</li>
    100. 

  100.         <li class="li">Support for <span class="ph filepath">layout-masters.xml</span> configuration. Plug-ins should use the
    101. 

  101.             <code class="ph codeph">createDefaultLayoutMasters</code> template instead.</li>
    102. 

  102.       </ul>
    103. 

  103.       <p class="p">The following extension-points have been added:</p>
    104. 

  104.       <ul class="ul">
    105. 

  105.         <li class="li"><code class="ph codeph">dita.conductor.pdf2.param</code> to add XSLT parameters to XSL FO transformation.</li>
    106. 

  106.       </ul>
    107. 

  107.       <p class="p">Custom PDF2 shell stylesheets need to be revised to not include separate IBM and OASIS DITA stylesheets. The
    108. 

  108.             <span class="ph filepath"><var class="keyword varname">*</var>_1.0.xsl</span> stylesheets have been removed and their imports must be
    109. 

  109.         removed from shell stylesheets.</p>
    110. 

  110.       <p class="p">The following template modes have been deprecated:</p>
    111. 

  111.       <ul class="ul">
    112. 

  112.         <li class="li">toc-prefix-text</li>
    113. 

  113.         <li class="li">toc-topic-text</li>
    114. 

  114.       </ul>
    115. 

  115.       <p class="p">The following named templates have been removed:</p>
    116. 

  116.       <ul class="ul">
    117. 

  117.         <li class="li">processTopic</li>
    118. 

  118.         <li class="li">createMiniToc</li>
    119. 

  119.         <li class="li">processTopicTitle</li>
    120. 

  120.         <li class="li">createTopicAttrsName</li>
    121. 

  121.         <li class="li">processConcept</li>
    122. 

  122.         <li class="li">processReference</li>
    123. 

  123.         <li class="li">getTitle</li>
    124. 

  124.         <li class="li">placeNoteContent</li>
    125. 

  125.         <li class="li">placeImage</li>
    126. 

  126.         <li class="li">processUnknowType</li>
    127. 

  127.         <li class="li">insertReferenceTitle</li>
    128. 

  128.         <li class="li">buildRelationships</li>
    129. 

  129.         <li class="li">processTask</li>
    130. 

  130.       </ul>
    131. 

  131.       <p class="p">The main FO generation process now relies on the merging process to rewrite duplicate IDs. The default merging
    132. 

  132.         process did this already in previous releases, but now also custom merging processes must fulfill the duplicate
    133. 

  133.         ID rewrite requirement.</p>
    134. 

  134.     </section>
    135. 

  135.     <section class="section"><h2 class="title sectiontitle">XHTML</h2>
    136. 

  136.       
    137. 

  137.       <p class="p">The following named templates have been deprecated:</p>
    138. 

  138.       <ul class="ul">
    139. 

  139.         <li class="li">make-index-ref</li>
    140. 

  140.       </ul>
    141. 

  141.       <p class="p">The following deprecated templates have been removed:</p>
    142. 

  142.       <ul class="ul">
    143. 

  143.         <li class="li">revblock-deprecated</li>
    144. 

  144.         <li class="li">revstyle-deprecated</li>
    145. 

  145.         <li class="li">start-revision-flag-deprecated</li>
    146. 

  146.         <li class="li">end-revision-flag-deprecated</li>
    147. 

  147.         <li class="li">concept-links</li>
    148. 

  148.         <li class="li">task-links</li>
    149. 

  149.         <li class="li">reference-links</li>
    150. 

  150.         <li class="li">relinfo-links</li>
    151. 

  151.         <li class="li">sort-links-by-role</li>
    152. 

  152.         <li class="li">create-links</li>
    153. 

  153.         <li class="li">add-linking-attributes</li>
    154. 

  154.         <li class="li">add-link-target-attribute</li>
    155. 

  155.         <li class="li">add-user-link-attributes</li>
    156. 

  156.       </ul>
    157. 

  157.       <p class="p">The removed templates have been replaced by other templates in earlier releases and plug-ins should be changed
    158. 

  158.         to use the new templates.</p>
    159. 

  159.     </section>
    160. 

  160.     <section class="section"><h2 class="title sectiontitle">ODT</h2>
    161. 

  161.       
    162. 

  162.       <p class="p">The following deprecated templates have been removed:</p>
    163. 

  163.       <ul class="ul">
    164. 

  164.         <li class="li">revblock-deprecated</li>
    165. 

  165.         <li class="li">revstyle-deprecated</li>
    166. 

  166.         <li class="li">start-revision-flag-deprecated</li>
    167. 

  167.         <li class="li">end-revision-flag-deprecated</li>
    168. 

  168.       </ul>
    169. 

  169.       <p class="p">The removed templates have been replaced by other templates in earlier releases and plug-ins should be changed
    170. 

  170.         to use the new templates.</p>
    171. 

  171.     </section>
    172. 

  172.   </div>
    173. 

  173. <nav role="navigation" class="related-links"><div class="familylinks"><div class="parentlink"><strong>Parent topic:</strong> <a class="link" href="../topics/migration.html" title="If you have XSL transformation overrides, plug-ins or other customizations written prior to DITA-OT 3.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>
    174.