rel1.8.dita 9.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
  3. "reference.dtd">
  4. <reference id="rel1.8" xml:lang="en">
  5. <title>DITA Open Toolkit Release 1.8</title>
  6. <!--reference id="releasehighlights" xml:lang="en-US">
  7. <title>Release highlights</title>
  8. <refbody>
  9. <section/>
  10. </refbody>
  11. </reference-->
  12. <reference id="general-enhancements-and-changes" xml:lang="en-US">
  13. <title>General Enhancements and Changes</title>
  14. <refbody>
  15. <section>
  16. <title>Preprocessing</title>
  17. <p>Additional validation has been added to check e.g. element ID uniqueness, and <codeph>xml:lang</codeph> and URI syntax.</p>
  18. </section>
  19. <section>
  20. <title>PDF</title>
  21. <p>Bundled FOP has been updated from 1.0 to 1.1.</p>
  22. </section>
  23. </refbody>
  24. </reference>
  25. <reference id="reference_yvj_ttj_bd">
  26. <title>Migration from previous releases</title>
  27. <refbody>
  28. <section>
  29. <p>Stylesheets for the following transtypes have moved
  30. to plug-in specific folders:</p>
  31. <ul>
  32. <li>eclipsehelp</li>
  33. <li>htmlhelp</li>
  34. <li>javahelp</li>
  35. <li>odt</li>
  36. <li>xhtml</li>
  37. </ul>
  38. </section>
  39. <section>
  40. <title>Preprocessing</title>
  41. <p>The following deprecated Ant properties have been removed:</p>
  42. <ul id="ul_rp5_hjs_53">
  43. <li><codeph>dita.script.dir</codeph>, use <codeph>${dita.plugin.<varname>id</varname>.dir}</codeph>
  44. instead</li>
  45. <li><codeph>dita.resource.dir</codeph>, use <codeph>${dita.plugin.org.dita.base.dir}/resource</codeph> instead</li>
  46. <li><codeph>dita.empty</codeph></li>
  47. <li><codeph>args.message.file</codeph></li>
  48. </ul>
  49. </section>
  50. <section>
  51. <title>XHTML</title>
  52. <p>XSLT Java extension <codeph>ImgUtils</codeph> has been removed from stylesheets and been replaced with preprocessing module <codeph>ImageMetadataModule</codeph>.
  53. The old <codeph>ImgUtils</codeph> Java classes are still included in the build.</p>
  54. </section>
  55. <section>
  56. <title>PDF</title>
  57. <p>The following deprecated XSLT stylesheets have been removed:</p>
  58. <ul id="ul_vmw_v3s_53">
  59. <li><filepath>artwork-preprocessor.xsl</filepath></li>
  60. <li><filepath>otdita2fo_frontend.xsl</filepath></li>
  61. </ul>
  62. <p>The following deprecated XSLT templates have been removed:</p>
  63. <ul id="ul_bwz_r3s_53">
  64. <li><codeph>insertVariable.old</codeph></li>
  65. </ul>
  66. <p>The following deprecated XSLT modes have been removed:</p>
  67. <ul>
  68. <li><codeph>layout-masters-processing</codeph></li>
  69. <li><codeph>toc-prefix-text</codeph>, use <codeph>tocPrefix</codeph> mode instead</li>
  70. <li><codeph>toc-topic-text</codeph>, use <codeph>tocText</codeph> mode instead</li>
  71. </ul>
  72. <p>Link generation has been simplified by removing deprecated arguments in favour of <codeph>args.rellinks</codeph>.
  73. The following deprecated Ant properties have been removed:</p>
  74. <ul>
  75. <li><codeph>args.fo.include.rellinks</codeph></li>
  76. </ul>
  77. <p>The following XSLT parameters have been removed:</p>
  78. <ul>
  79. <li><codeph>antArgsIncludeRelatedLinks</codeph></li>
  80. <li><codeph>disableRelatedLinks</codeph></li>
  81. </ul>
  82. <p>A call to a named template <codeph>pullPrologIndexTerms.end-range</codeph> has been added to <codeph>processTopic*</codeph> templates to handle topic wide index ranges.</p>
  83. </section>
  84. <section>
  85. <title>Legacy PDF</title>
  86. <p>The following deprecated XSLT stylesheets have been removed:</p>
  87. <ul>
  88. <li><filepath>dita2fo-shell_template.xsl</filepath></li>
  89. <li><filepath>topic2fo-shell.xsl</filepath></li>
  90. </ul>
  91. </section>
  92. <section>
  93. <title>ODT</title>
  94. <p>Link generation has been simplified by removing deprecated arguments in favour of <codeph>args.rellinks</codeph>.
  95. The following deprecated Ant properties have been removed:</p>
  96. <ul>
  97. <li><codeph>args.odt.include.rellinks</codeph></li>
  98. </ul>
  99. <p>The following XSLT parameters have been added:</p>
  100. <ul>
  101. <li><codeph>include.rellinks</codeph></li>
  102. </ul>
  103. <p>The following XSLT parameters have been removed:</p>
  104. <ul>
  105. <li><codeph>disableRelatedLinks</codeph></li>
  106. </ul>
  107. </section>
  108. </refbody>
  109. </reference>
  110. <reference id="rel1.8.issues">
  111. <title>Issues</title>
  112. <shortdesc>The following items are included in DITA Open Toolkit Release 1.8. Issue numbers
  113. correspond to the tracking number in the <ph><xref keyref="dita-ot-issues" scope="external"
  114. >GitHub issues tracker</xref></ph>.</shortdesc>
  115. <refbody>
  116. <section>
  117. <title>Feature requests</title>
  118. <ul>
  119. <li>#1406 Bundle FOP 1.1 (milestone 1)</li>
  120. <li>#1447 Move stylesheets and resource files to plug-in folder (milestone 1)</li>
  121. <li>#1449 Add support for Slovenian (milestone 1)</li>
  122. <li>#1453 Add image metadata filter (milestone 1)</li>
  123. <li>#1435 Add validation filter to debug-filter step</li>
  124. <li>#1455 Remove deprecated features</li>
  125. <li>#1460 "Get String" template should use parameter instead of variable</li>
  126. <li>#1461 Move file list generation to Ant</li>
  127. <li>#1465 New doc topic listing non-standard tweaks to preprocessed files</li>
  128. <li>#1480 Correcting values for the @relcolwidth attribute</li>
  129. <li>#1492 Line range extension to coderef processing</li>
  130. <li>#1494 Move integrator configuration to lib/configuration.properties</li>
  131. <li>#1495 Remove ancient doc directories</li>
  132. </ul>
  133. </section>
  134. <section>
  135. <title>Bugs</title>
  136. <ul>
  137. <li>#1425 XHTML flagging included before imports (milestone 1)</li>
  138. <li>#1428 Topic level calculated incorrectly for appendices (milestone 1)</li>
  139. <li>#1427 Fix text overflow issue in lot/lof entries with long titles (milestone 1)</li>
  140. <li>#1430 PDF transformation: Problems with index in OT 1.7 (milestone 1)</li>
  141. <li>#1432 startcmd.sh broken in 1.7 (milestone 1)</li>
  142. <li>#1433 Profiling filter included multiple times (milestone 1)</li>
  143. <li>#1437 Fatal UTF-8 error in .job.xml (milestone 1)</li>
  144. <li>#1456 XHTML Build failed when referencing subject scheme in different file path (milestone 1)</li>
  145. <li>#1080 Index page range issues (milestone 2)</li>
  146. <li>#1423 Formatting glitch in PDF index (milestone 2)</li>
  147. <li>#1468 Reference to remote image does not appear in PDF (milestone 2)</li>
  148. <li>#1469 @outputclass and @class values not passed from &lt;chhead> to &lt;tr> in XHTML output (milestone 2)</li>
  149. <li>#1472 PDF output: whitespace not preserved in msgblock element (milestone 2)</li>
  150. <li>#1475 Error received in console does not point correctly to location of published DITA Map (milestone 2)</li>
  151. <li>#1477 Tables: using percentage in colwidth values [PDF2 plugin] (milestone 2)</li>
  152. <li>#1464 Flagging a simpletable row throws off @keycol counting bug (milestone 2)</li>
  153. <li>#1459 Link not created in the XHTML output for a xref/@keyref element</li>
  154. <li>#1473 Troff output not working in latest build bug troff</li>
  155. <li>#1498 White space will break tocjs</li>
  156. <li>#1519 Latest code in develop branch fails to build PDF</li>
  157. <li>#1528 PDF fails when topic referenced with and without topic ID (maintenance 1)</li>
  158. <li>#1529 NPE when topichead has @copy-to and @chunk="to-content" (maintenance 1)</li>
  159. <li>#1535 Specialized class cannot be handled during XML parsing (maintenance 1)</li>
  160. <li>#1537 Whitespace issue when @conref is preceded by a linefeed in map &lt;title> (maintenance 1)</li>
  161. <li>#1538 Incorrect handling of topics outside of map path (maintenance 1)</li>
  162. <li>#1531 CSS link generated with backslash on Windows (maintenance 2)</li>
  163. <li>#1532 Keyref link generated with backslash and %5C on Windows (maintenance 2)</li>
  164. <li>#1540 Add missing @class attribute to &lt;navref> in chunking phase (maintenance 2)</li>
  165. <li>#1547 startPageNumbering missing from some page sequence (maintenance 2)</li>
  166. <li>#1073 Some elements are not handled correctly in troff transform (maintenance 3)</li>
  167. <li>#1175 pdf2 plugin: PDF transform produces invalid FO doc with DITAVAL (flag on simpletable) (maintenance 3)</li>
  168. <li>#1234 pdf2 plugin: Note image path broken for "other" note type (maintenance 3)</li>
  169. <li>#1373 Cells of a Properties table misaligned in PDF output if Value column is missing (maintenance 3)</li>
  170. <li>#1563 path2project generated PI is invalid in copy-to file (maintenance 3)</li>
  171. <li>#1570 pdf2 plugin: 'Body first header' variable does not support 'prodname' parameter (maintenance 3)</li>
  172. <li>#1571 pdf2 plugin: top level topic titles styled as normal text (maintenance 3)</li>
  173. <li>#1581 pdf2 plugin: Change bars from DITAVAL crash FOP (maintenance 3)</li>
  174. <li>#1584 Add basic table support to troff #1073 (maintenance 3)</li>
  175. <li>#1585 Properties table cell misalligned if no value column #1373 (maintenance 3)</li>
  176. <li>#1603 XSD schema for Machinery Task does not allow attributes in prelreqs element (maintenance 3)</li>
  177. </ul>
  178. </section>
  179. </refbody>
  180. </reference>
  181. </reference>