Etusivu Tutki Apua
Kirjaudu sisään
bn
/
se
2
0
Fork 0
Tiedostot Ongelmat 0 Pull-pyynnöt 0 Wiki
Puu: 23a803db8e
Haarat Tagit
se
/
SE
/
schema
/
WPS_Functions
/
dita-ot
/
dita-ot-3.0.4
/
doc
/
topics
/
migrating-to-1.6.html

migrating-to-1.6.html 12 KB
Historia Raaka

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160 
  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 2018"><meta name="DC.rights.owner" content="(C) Copyright 2018"><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.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.0</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/extending-the-ot.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/globalization.html">Globalizing DITA content</a></li><li><a href="../topics/custom-plugins.html">Custom 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.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/rebuilding-the-dita-ot-documentation.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.   <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
    14. 

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

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

  16.     <section class="section">
    17. 

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

  18.         removed.</p>
    19. 

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

  20.           <span class="ph filepath">plugins</span> folder:</p>
    21. 

  21.       <table class="simpletable"><colgroup><col style="width:50%"><col style="width:50%"></colgroup><thead><tr class="sthead">
    22. 

  22.           <th class="stentry" scope="col">old path</th>
    23. 

  23.           <th class="stentry" scope="col">new path</th>
    24. 

  24.         </tr></thead><tbody><tr class="strow">
    25. 

  25.           <td class="stentry"><span class="ph filepath">demo/dita11</span></td>
    26. 

  26.           <td class="stentry"><span class="ph filepath">plugins/org.dita.specialization.dita11</span></td>
    27. 

  27.         </tr><tr class="strow">
    28. 

  28.           <td class="stentry"><span class="ph filepath">demo/dita132</span></td>
    29. 

  29.           <td class="stentry"><span class="ph filepath">plugins/org.dita.specialization.dita132</span></td>
    30. 

  30.         </tr><tr class="strow">
    31. 

  31.           <td class="stentry"><span class="ph filepath">demo/eclipsemap</span></td>
    32. 

  32.           <td class="stentry"><span class="ph filepath">plugins/org.dita.specialization.eclipsemap</span></td>
    33. 

  33.         </tr><tr class="strow">
    34. 

  34.           <td class="stentry"><span class="ph filepath">demo/fo</span></td>
    35. 

  35.           <td class="stentry"><span class="ph filepath">plugins/org.dita.pdf2</span></td>
    36. 

  36.         </tr><tr class="strow">
    37. 

  37.           <td class="stentry"><span class="ph filepath">demo/tocjs</span></td>
    38. 

  38.           <td class="stentry"><span class="ph filepath">plugins/com.sophos.tocjs</span></td>
    39. 

  39.         </tr><tr class="strow">
    40. 

  40.           <td class="stentry"><span class="ph filepath">demo/h2d</span></td>
    41. 

  41.           <td class="stentry"><span class="ph filepath">plugins/h2d</span></td>
    42. 

  42.         </tr><tr class="strow">
    43. 

  43.           <td class="stentry"><span class="ph filepath">demo/legacypdf</span></td>
    44. 

  44.           <td class="stentry"><span class="ph filepath">plugins/legacypdf</span></td>
    45. 

  45.         </tr></tbody></table>
    46. 

  46.       <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>
    47. 

  47.     </section>
    48. 

  48.     <section class="section">
    49. 

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

  50.           <code class="ph codeph">args.filter</code>.</p>
    51. 

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

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

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

  54.         become static configuration.</p>
    55. 

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

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

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

  58.     </section>
    59. 

  59.     <section class="section"><h2 class="title sectiontitle">Preprocessing</h2>
    60. 

  60.       
    61. 

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

  62.       <ul class="ul">
    63. 

  63.         <li class="li">inherit</li>
    64. 

  64.         <li class="li">get-stuff</li>
    65. 

  65.         <li class="li">verify-type-attribute</li>
    66. 

  66.         <li class="li">classval</li>
    67. 

  67.         <li class="li">getshortdesc</li>
    68. 

  68.         <li class="li">getlinktext</li>
    69. 

  69.         <li class="li">blocktext</li>
    70. 

  70.         <li class="li">figtext</li>
    71. 

  71.         <li class="li">tabletext</li>
    72. 

  72.         <li class="li">litext</li>
    73. 

  73.         <li class="li">fntext</li>
    74. 

  74.         <li class="li">dlentrytext</li>
    75. 

  75.         <li class="li">firstclass</li>
    76. 

  76.         <li class="li">invalid-list-item</li>
    77. 

  77.         <li class="li">xref</li>
    78. 

  78.       </ul>
    79. 

  79.     </section>
    80. 

  80.     <section class="section"><h2 class="title sectiontitle">PDF2</h2>
    81. 

  81.       
    82. 

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

  83.       <ul class="ul">
    84. 

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

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

  86.           in 2007.</li>
    87. 

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

  88.             <code class="ph codeph">createDefaultLayoutMasters</code> template instead.</li>
    89. 

  89.       </ul>
    90. 

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

  91.       <ul class="ul">
    92. 

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

  93.       </ul>
    94. 

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

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

  96.         removed from shell stylesheets.</p>
    97. 

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

  98.       <ul class="ul">
    99. 

  99.         <li class="li">toc-prefix-text</li>
    100. 

  100.         <li class="li">toc-topic-text</li>
    101. 

  101.       </ul>
    102. 

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

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

  104.         <li class="li">processTopic</li>
    105. 

  105.         <li class="li">createMiniToc</li>
    106. 

  106.         <li class="li">processTopicTitle</li>
    107. 

  107.         <li class="li">createTopicAttrsName</li>
    108. 

  108.         <li class="li">processConcept</li>
    109. 

  109.         <li class="li">processReference</li>
    110. 

  110.         <li class="li">getTitle</li>
    111. 

  111.         <li class="li">placeNoteContent</li>
    112. 

  112.         <li class="li">placeImage</li>
    113. 

  113.         <li class="li">processUnknowType</li>
    114. 

  114.         <li class="li">insertReferenceTitle</li>
    115. 

  115.         <li class="li">buildRelationships</li>
    116. 

  116.         <li class="li">processTask</li>
    117. 

  117.       </ul>
    118. 

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

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

  120.         ID rewrite requirement.</p>
    121. 

  121.     </section>
    122. 

  122.     <section class="section"><h2 class="title sectiontitle">XHTML</h2>
    123. 

  123.       
    124. 

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

  125.       <ul class="ul">
    126. 

  126.         <li class="li">make-index-ref</li>
    127. 

  127.       </ul>
    128. 

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

  129.       <ul class="ul">
    130. 

  130.         <li class="li">revblock-deprecated</li>
    131. 

  131.         <li class="li">revstyle-deprecated</li>
    132. 

  132.         <li class="li">start-revision-flag-deprecated</li>
    133. 

  133.         <li class="li">end-revision-flag-deprecated</li>
    134. 

  134.         <li class="li">concept-links</li>
    135. 

  135.         <li class="li">task-links</li>
    136. 

  136.         <li class="li">reference-links</li>
    137. 

  137.         <li class="li">relinfo-links</li>
    138. 

  138.         <li class="li">sort-links-by-role</li>
    139. 

  139.         <li class="li">create-links</li>
    140. 

  140.         <li class="li">add-linking-attributes</li>
    141. 

  141.         <li class="li">add-link-target-attribute</li>
    142. 

  142.         <li class="li">add-user-link-attributes</li>
    143. 

  143.       </ul>
    144. 

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

  145.         to use the new templates.</p>
    146. 

  146.     </section>
    147. 

  147.     <section class="section"><h2 class="title sectiontitle">ODT</h2>
    148. 

  148.       
    149. 

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

  150.       <ul class="ul">
    151. 

  151.         <li class="li">revblock-deprecated</li>
    152. 

  152.         <li class="li">revstyle-deprecated</li>
    153. 

  153.         <li class="li">start-revision-flag-deprecated</li>
    154. 

  154.         <li class="li">end-revision-flag-deprecated</li>
    155. 

  155.       </ul>
    156. 

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

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

  158.     </section>
    159. 

  159.   </div>
    160. 

  160. <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.0, 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>
    161.