| 1 | <?xml version="1.0" encoding="UTF-8"?>
|
|---|
| 2 | <!DOCTYPE html
|
|---|
| 3 | PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|---|
| 4 | <html xml:lang="en" lang="en">
|
|---|
| 5 | <head>
|
|---|
| 6 | <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
|
|---|
| 7 | <meta name="copyright" content="(C) Copyright 2005"/>
|
|---|
| 8 | <meta name="DC.rights.owner" content="(C) Copyright 2005"/>
|
|---|
| 9 | <meta name="DC.Type" content="reference"/>
|
|---|
| 10 | <meta name="DC.Title" content="DITA Open Toolkit Release 1.8"/>
|
|---|
| 11 | <meta name="DC.Relation" scheme="URI" content="../../readme/overview-of-dita-ot.html"/>
|
|---|
| 12 | <meta name="DC.Format" content="XHTML"/>
|
|---|
| 13 | <meta name="DC.Identifier" content="rel1.8"/>
|
|---|
| 14 | <meta name="DC.Language" content="en"/>
|
|---|
| 15 | <link rel="stylesheet" type="text/css" href="../../commonltr.css"/>
|
|---|
| 16 | <link rel="stylesheet" type="text/css" href="../../dita-ot-doc.css"/>
|
|---|
| 17 | <title>DITA Open Toolkit Release 1.8</title>
|
|---|
| 18 | </head>
|
|---|
| 19 | <body id="rel1.8">
|
|---|
| 20 |
|
|---|
| 21 |
|
|---|
| 22 | <h1 class="title topictitle1">DITA Open Toolkit Release 1.8</h1>
|
|---|
| 23 |
|
|---|
| 24 |
|
|---|
| 25 | <div class="related-links">
|
|---|
| 26 | <div class="familylinks">
|
|---|
| 27 | <div class="parentlink"><strong>Parent topic:</strong> <a class="link" href="../../readme/overview-of-dita-ot.html" title="The DITA Open Toolkit (DITA-OT) is an open-source implementation of the OASIS DITA specification, which is developed by the OASIS DITA Technical Committee. The DITA-OT is a set of Java-based, open-source tools and Ant scripts that transform DITA content (maps and topics) into deliverable formats, including Eclipse Help, HTML Help, JavaHelp, PDF, and XHTML.">Overview of the DITA Open Toolkit</a></div>
|
|---|
| 28 | </div>
|
|---|
| 29 | </div>
|
|---|
| 30 | <div class="topic reference nested1" xml:lang="en-us" lang="en-us" id="general-enhancements-and-changes">
|
|---|
| 31 | <h2 class="title topictitle2">General Enhancements and Changes</h2>
|
|---|
| 32 |
|
|---|
| 33 | <div class="body refbody">
|
|---|
| 34 | <div class="section"><h3 class="title sectiontitle">Preprocessing</h3>
|
|---|
| 35 |
|
|---|
| 36 | <p class="p">Additional validation has been added to check e.g. element ID uniqueness, and <samp class="ph codeph">xml:lang</samp> and URI syntax.</p>
|
|---|
| 37 |
|
|---|
| 38 | </div>
|
|---|
| 39 |
|
|---|
| 40 | <div class="section"><h3 class="title sectiontitle">PDF</h3>
|
|---|
| 41 |
|
|---|
| 42 | <p class="p">Bundled FOP has been updated from 1.0 to 1.1.</p>
|
|---|
| 43 |
|
|---|
| 44 | </div>
|
|---|
| 45 |
|
|---|
| 46 | </div>
|
|---|
| 47 |
|
|---|
| 48 | </div>
|
|---|
| 49 |
|
|---|
| 50 | <div class="topic reference nested1" id="reference_yvj_ttj_bd">
|
|---|
| 51 | <h2 class="title topictitle2">Migration from previous releases</h2>
|
|---|
| 52 |
|
|---|
| 53 | <div class="body refbody">
|
|---|
| 54 | <div class="section">
|
|---|
| 55 | <p class="p">Stylesheets for the following transtypes have moved
|
|---|
| 56 | to plug-in specific folders:</p>
|
|---|
| 57 |
|
|---|
| 58 | <ul class="ul">
|
|---|
| 59 | <li class="li">eclipsehelp</li>
|
|---|
| 60 |
|
|---|
| 61 | <li class="li">htmlhelp</li>
|
|---|
| 62 |
|
|---|
| 63 | <li class="li">javahelp</li>
|
|---|
| 64 |
|
|---|
| 65 | <li class="li">odt</li>
|
|---|
| 66 |
|
|---|
| 67 | <li class="li">xhtml</li>
|
|---|
| 68 |
|
|---|
| 69 | </ul>
|
|---|
| 70 |
|
|---|
| 71 | </div>
|
|---|
| 72 |
|
|---|
| 73 | <div class="section"><h3 class="title sectiontitle">Preprocessing</h3>
|
|---|
| 74 |
|
|---|
| 75 | <p class="p">The following deprecated Ant properties have been removed:</p>
|
|---|
| 76 |
|
|---|
| 77 | <ul class="ul" id="reference_yvj_ttj_bd__ul_rp5_hjs_53">
|
|---|
| 78 | <li class="li"><samp class="ph codeph">dita.script.dir</samp>, use <samp class="ph codeph">${dita.plugin.<var class="keyword varname">id</var>.dir}</samp>
|
|---|
| 79 | instead</li>
|
|---|
| 80 |
|
|---|
| 81 | <li class="li"><samp class="ph codeph">dita.resource.dir</samp>, use <samp class="ph codeph">${dita.plugin.org.dita.base.dir}/resource</samp> instead</li>
|
|---|
| 82 |
|
|---|
| 83 | <li class="li"><samp class="ph codeph">dita.empty</samp></li>
|
|---|
| 84 |
|
|---|
| 85 | <li class="li"><samp class="ph codeph">args.message.file</samp></li>
|
|---|
| 86 |
|
|---|
| 87 | </ul>
|
|---|
| 88 |
|
|---|
| 89 | </div>
|
|---|
| 90 |
|
|---|
| 91 | <div class="section"><h3 class="title sectiontitle">XHTML</h3>
|
|---|
| 92 |
|
|---|
| 93 | <p class="p">XSLT Java extension <samp class="ph codeph">ImgUtils</samp> has been removed from stylesheets and been replaced with preprocessing module <samp class="ph codeph">ImageMetadataModule</samp>.
|
|---|
| 94 | The old <samp class="ph codeph">ImgUtils</samp> Java classes are still included in the build.</p>
|
|---|
| 95 |
|
|---|
| 96 | </div>
|
|---|
| 97 |
|
|---|
| 98 | <div class="section"><h3 class="title sectiontitle">PDF</h3>
|
|---|
| 99 |
|
|---|
| 100 | <p class="p">The following deprecated XSLT stylesheets have been removed:</p>
|
|---|
| 101 |
|
|---|
| 102 | <ul class="ul" id="reference_yvj_ttj_bd__ul_vmw_v3s_53">
|
|---|
| 103 | <li class="li"><span class="ph filepath">artwork-preprocessor.xsl</span></li>
|
|---|
| 104 |
|
|---|
| 105 | <li class="li"><span class="ph filepath">otdita2fo_frontend.xsl</span></li>
|
|---|
| 106 |
|
|---|
| 107 | </ul>
|
|---|
| 108 |
|
|---|
| 109 | <p class="p">The following deprecated XSLT templates have been removed:</p>
|
|---|
| 110 |
|
|---|
| 111 | <ul class="ul" id="reference_yvj_ttj_bd__ul_bwz_r3s_53">
|
|---|
| 112 | <li class="li"><samp class="ph codeph">insertVariable.old</samp></li>
|
|---|
| 113 |
|
|---|
| 114 | </ul>
|
|---|
| 115 |
|
|---|
| 116 | <p class="p">The following deprecated XSLT modes have been removed:</p>
|
|---|
| 117 |
|
|---|
| 118 | <ul class="ul">
|
|---|
| 119 | <li class="li"><samp class="ph codeph">layout-masters-processing</samp></li>
|
|---|
| 120 |
|
|---|
| 121 | <li class="li"><samp class="ph codeph">toc-prefix-text</samp>, use <samp class="ph codeph">tocPrefix</samp> mode instead</li>
|
|---|
| 122 |
|
|---|
| 123 | <li class="li"><samp class="ph codeph">toc-topic-text</samp>, use <samp class="ph codeph">tocText</samp> mode instead</li>
|
|---|
| 124 |
|
|---|
| 125 | </ul>
|
|---|
| 126 |
|
|---|
| 127 | <p class="p">Link generation has been simplified by removing deprecated arguments in favour of <samp class="ph codeph">args.rellinks</samp>.
|
|---|
| 128 | The following deprecated Ant properties have been removed:</p>
|
|---|
| 129 |
|
|---|
| 130 | <ul class="ul">
|
|---|
| 131 | <li class="li"><samp class="ph codeph">args.fo.include.rellinks</samp></li>
|
|---|
| 132 |
|
|---|
| 133 | </ul>
|
|---|
| 134 |
|
|---|
| 135 | <p class="p">The following XSLT parameters have been removed:</p>
|
|---|
| 136 |
|
|---|
| 137 | <ul class="ul">
|
|---|
| 138 | <li class="li"><samp class="ph codeph">antArgsIncludeRelatedLinks</samp></li>
|
|---|
| 139 |
|
|---|
| 140 | <li class="li"><samp class="ph codeph">disableRelatedLinks</samp></li>
|
|---|
| 141 |
|
|---|
| 142 | </ul>
|
|---|
| 143 |
|
|---|
| 144 | <p class="p">A call to a named template <samp class="ph codeph">pullPrologIndexTerms.end-range</samp> has been added to <samp class="ph codeph">processTopic*</samp> templates to handle topic wide index ranges.</p>
|
|---|
| 145 |
|
|---|
| 146 | </div>
|
|---|
| 147 |
|
|---|
| 148 | <div class="section"><h3 class="title sectiontitle">Legacy PDF</h3>
|
|---|
| 149 |
|
|---|
| 150 | <p class="p">The following deprecated XSLT stylesheets have been removed:</p>
|
|---|
| 151 |
|
|---|
| 152 | <ul class="ul">
|
|---|
| 153 | <li class="li"><span class="ph filepath">dita2fo-shell_template.xsl</span></li>
|
|---|
| 154 |
|
|---|
| 155 | <li class="li"><span class="ph filepath">topic2fo-shell.xsl</span></li>
|
|---|
| 156 |
|
|---|
| 157 | </ul>
|
|---|
| 158 |
|
|---|
| 159 | </div>
|
|---|
| 160 |
|
|---|
| 161 | <div class="section"><h3 class="title sectiontitle">ODT</h3>
|
|---|
| 162 |
|
|---|
| 163 | <p class="p">Link generation has been simplified by removing deprecated arguments in favour of <samp class="ph codeph">args.rellinks</samp>.
|
|---|
| 164 | The following deprecated Ant properties have been removed:</p>
|
|---|
| 165 |
|
|---|
| 166 | <ul class="ul">
|
|---|
| 167 | <li class="li"><samp class="ph codeph">args.odt.include.rellinks</samp></li>
|
|---|
| 168 |
|
|---|
| 169 | </ul>
|
|---|
| 170 |
|
|---|
| 171 | <p class="p">The following XSLT parameters have been added:</p>
|
|---|
| 172 |
|
|---|
| 173 | <ul class="ul">
|
|---|
| 174 | <li class="li"><samp class="ph codeph">include.rellinks</samp></li>
|
|---|
| 175 |
|
|---|
| 176 | </ul>
|
|---|
| 177 |
|
|---|
| 178 | <p class="p">The following XSLT parameters have been removed:</p>
|
|---|
| 179 |
|
|---|
| 180 | <ul class="ul">
|
|---|
| 181 | <li class="li"><samp class="ph codeph">disableRelatedLinks</samp></li>
|
|---|
| 182 |
|
|---|
| 183 | </ul>
|
|---|
| 184 |
|
|---|
| 185 | </div>
|
|---|
| 186 |
|
|---|
| 187 | </div>
|
|---|
| 188 |
|
|---|
| 189 | </div>
|
|---|
| 190 |
|
|---|
| 191 | <div class="topic reference nested1" id="rel1.8.issues">
|
|---|
| 192 | <h2 class="title topictitle2">Issues</h2>
|
|---|
| 193 |
|
|---|
| 194 |
|
|---|
| 195 | <div class="body refbody"><p class="shortdesc">The following items are included in DITA Open Toolkit Release 1.8. Issue numbers
|
|---|
| 196 | correspond to the tracking number in the <span class="ph"><a class="xref" href="https://github.com/dita-ot/dita-ot/issues" target="_blank">GitHub issues tracker</a></span>.</p>
|
|---|
| 197 |
|
|---|
| 198 | <div class="section"><h3 class="title sectiontitle">Feature requests</h3>
|
|---|
| 199 |
|
|---|
| 200 | <ul class="ul">
|
|---|
| 201 | <li class="li">#1406 Bundle FOP 1.1 (milestone 1)</li>
|
|---|
| 202 |
|
|---|
| 203 | <li class="li">#1447 Move stylesheets and resource files to plug-in folder (milestone 1)</li>
|
|---|
| 204 |
|
|---|
| 205 | <li class="li">#1449 Add support for Slovenian (milestone 1)</li>
|
|---|
| 206 |
|
|---|
| 207 | <li class="li">#1453 Add image metadata filter (milestone 1)</li>
|
|---|
| 208 |
|
|---|
| 209 | <li class="li">#1435 Add validation filter to debug-filter step</li>
|
|---|
| 210 |
|
|---|
| 211 | <li class="li">#1455 Remove deprecated features</li>
|
|---|
| 212 |
|
|---|
| 213 | <li class="li">#1460 "Get String" template should use parameter instead of variable</li>
|
|---|
| 214 |
|
|---|
| 215 | <li class="li">#1461 Move file list generation to Ant</li>
|
|---|
| 216 |
|
|---|
| 217 | <li class="li">#1465 New doc topic listing non-standard tweaks to preprocessed files</li>
|
|---|
| 218 |
|
|---|
| 219 | <li class="li">#1480 Correcting values for the @relcolwidth attribute</li>
|
|---|
| 220 |
|
|---|
| 221 | <li class="li">#1492 Line range extension to coderef processing</li>
|
|---|
| 222 |
|
|---|
| 223 | <li class="li">#1494 Move integrator configuration to lib/configuration.properties</li>
|
|---|
| 224 |
|
|---|
| 225 | <li class="li">#1495 Remove ancient doc directories</li>
|
|---|
| 226 |
|
|---|
| 227 | </ul>
|
|---|
| 228 |
|
|---|
| 229 | </div>
|
|---|
| 230 |
|
|---|
| 231 | <div class="section"><h3 class="title sectiontitle">Bugs</h3>
|
|---|
| 232 |
|
|---|
| 233 | <ul class="ul">
|
|---|
| 234 | <li class="li">#1425 XHTML flagging included before imports (milestone 1)</li>
|
|---|
| 235 |
|
|---|
| 236 | <li class="li">#1428 Topic level calculated incorrectly for appendices (milestone 1)</li>
|
|---|
| 237 |
|
|---|
| 238 | <li class="li">#1427 Fix text overflow issue in lot/lof entries with long titles (milestone 1)</li>
|
|---|
| 239 |
|
|---|
| 240 | <li class="li">#1430 PDF transformation: Problems with index in OT 1.7 (milestone 1)</li>
|
|---|
| 241 |
|
|---|
| 242 | <li class="li">#1432 startcmd.sh broken in 1.7 (milestone 1)</li>
|
|---|
| 243 |
|
|---|
| 244 | <li class="li">#1433 Profiling filter included multiple times (milestone 1)</li>
|
|---|
| 245 |
|
|---|
| 246 | <li class="li">#1437 Fatal UTF-8 error in .job.xml (milestone 1)</li>
|
|---|
| 247 |
|
|---|
| 248 | <li class="li">#1456 XHTML Build failed when referencing subject scheme in different file path (milestone 1)</li>
|
|---|
| 249 |
|
|---|
| 250 | <li class="li">#1080 Index page range issues (milestone 2)</li>
|
|---|
| 251 |
|
|---|
| 252 | <li class="li">#1423 Formatting glitch in PDF index (milestone 2)</li>
|
|---|
| 253 |
|
|---|
| 254 | <li class="li">#1468 Reference to remote image does not appear in PDF (milestone 2)</li>
|
|---|
| 255 |
|
|---|
| 256 | <li class="li">#1469 @outputclass and @class values not passed from <chhead> to <tr> in XHTML output (milestone 2)</li>
|
|---|
| 257 |
|
|---|
| 258 | <li class="li">#1472 PDF output: whitespace not preserved in msgblock element (milestone 2)</li>
|
|---|
| 259 |
|
|---|
| 260 | <li class="li">#1475 Error received in console does not point correctly to location of published DITA Map (milestone 2)</li>
|
|---|
| 261 |
|
|---|
| 262 | <li class="li">#1477 Tables: using percentage in colwidth values [PDF2 plugin] (milestone 2)</li>
|
|---|
| 263 |
|
|---|
| 264 | <li class="li">#1464 Flagging a simpletable row throws off @keycol counting bug (milestone 2)</li>
|
|---|
| 265 |
|
|---|
| 266 | <li class="li">#1459 Link not created in the XHTML output for a xref/@keyref element</li>
|
|---|
| 267 |
|
|---|
| 268 | <li class="li">#1473 Troff output not working in latest build bug troff</li>
|
|---|
| 269 |
|
|---|
| 270 | <li class="li">#1498 White space will break tocjs</li>
|
|---|
| 271 |
|
|---|
| 272 | <li class="li">#1519 Latest code in develop branch fails to build PDF</li>
|
|---|
| 273 |
|
|---|
| 274 | <li class="li">#1528 PDF fails when topic referenced with and without topic ID (maintenance 1)</li>
|
|---|
| 275 |
|
|---|
| 276 | <li class="li">#1529 NPE when topichead has @copy-to and @chunk="to-content" (maintenance 1)</li>
|
|---|
| 277 |
|
|---|
| 278 | <li class="li">#1535 Specialized class cannot be handled during XML parsing (maintenance 1)</li>
|
|---|
| 279 |
|
|---|
| 280 | <li class="li">#1537 Whitespace issue when @conref is preceded by a linefeed in map <title> (maintenance 1)</li>
|
|---|
| 281 |
|
|---|
| 282 | <li class="li">#1538 Incorrect handling of topics outside of map path (maintenance 1)</li>
|
|---|
| 283 |
|
|---|
| 284 | <li class="li">#1531 CSS link generated with backslash on Windows (maintenance 2)</li>
|
|---|
| 285 |
|
|---|
| 286 | <li class="li">#1532 Keyref link generated with backslash and %5C on Windows (maintenance 2)</li>
|
|---|
| 287 |
|
|---|
| 288 | <li class="li">#1540 Add missing @class attribute to <navref> in chunking phase (maintenance 2)</li>
|
|---|
| 289 |
|
|---|
| 290 | <li class="li">#1547 startPageNumbering missing from some page sequence (maintenance 2)</li>
|
|---|
| 291 |
|
|---|
| 292 | <li class="li">#1073 Some elements are not handled correctly in troff transform (maintenance 3)</li>
|
|---|
| 293 |
|
|---|
| 294 | <li class="li">#1175 pdf2 plugin: PDF transform produces invalid FO doc with DITAVAL (flag on simpletable) (maintenance 3)</li>
|
|---|
| 295 |
|
|---|
| 296 | <li class="li">#1234 pdf2 plugin: Note image path broken for "other" note type (maintenance 3)</li>
|
|---|
| 297 |
|
|---|
| 298 | <li class="li">#1373 Cells of a Properties table misaligned in PDF output if Value column is missing (maintenance 3)</li>
|
|---|
| 299 |
|
|---|
| 300 | <li class="li">#1563 path2project generated PI is invalid in copy-to file (maintenance 3)</li>
|
|---|
| 301 |
|
|---|
| 302 | <li class="li">#1570 pdf2 plugin: 'Body first header' variable does not support 'prodname' parameter (maintenance 3)</li>
|
|---|
| 303 |
|
|---|
| 304 | <li class="li">#1571 pdf2 plugin: top level topic titles styled as normal text (maintenance 3)</li>
|
|---|
| 305 |
|
|---|
| 306 | <li class="li">#1581 pdf2 plugin: Change bars from DITAVAL crash FOP (maintenance 3)</li>
|
|---|
| 307 |
|
|---|
| 308 | <li class="li">#1584 Add basic table support to troff #1073 (maintenance 3)</li>
|
|---|
| 309 |
|
|---|
| 310 | <li class="li">#1585 Properties table cell misalligned if no value column #1373 (maintenance 3)</li>
|
|---|
| 311 |
|
|---|
| 312 | <li class="li">#1603 XSD schema for Machinery Task does not allow attributes in prelreqs element (maintenance 3)</li>
|
|---|
| 313 |
|
|---|
| 314 | <li class="li">#1597 mappull generates DOTX021E and DTX025E for resource only topicrefs to png files (maintenance 4)</li>
|
|---|
| 315 |
|
|---|
| 316 | <li class="li">#1604 Failed to read job file: XML document structures must start and end within the same entity. (maintenance 4)</li>
|
|---|
| 317 |
|
|---|
| 318 | <li class="li">#1622 Update some XSD fixes that were found by developers from PTC. Also (maintenance 4)</li>
|
|---|
| 319 |
|
|---|
| 320 | <li class="li">#1626 DIITA-OT1.8.M2\plugins\org.dita.pdf2\lib\fo.jar does not include the xep directory (maintenance 4)</li>
|
|---|
| 321 |
|
|---|
| 322 | <li class="li">#1639 xhtml output replaces backslash in @href with escaped character (DOT 1.8M2) (maintenance 4)</li>
|
|---|
| 323 |
|
|---|
| 324 | <li class="li">#1640 ODT publishing doesn't work (DITA OT 1.8M2) (maintenance 4)</li>
|
|---|
| 325 |
|
|---|
| 326 | <li class="li">#1641 Legacy PDF doesn't work (DITA OT 1.8M2) (maintenance 4)</li>
|
|---|
| 327 |
|
|---|
| 328 | <li class="li">#1645 Conversion of File to URL is not properly done in several places (maintenance 4)</li>
|
|---|
| 329 |
|
|---|
| 330 | <li class="li">#1647 Illegal file separator used in created URI (DITA OT 1.8M2) (maintenance 4)</li>
|
|---|
| 331 |
|
|---|
| 332 | <li class="li">#1103 DITA-OT doesn't rewite lq/@href (maintenance 5)</li>
|
|---|
| 333 |
|
|---|
| 334 | <li class="li">#1189 PDF generation does not work with glossentry (maintenance 5)</li>
|
|---|
| 335 |
|
|---|
| 336 | <li class="li">#1653 2 invalid URI mappings in "DITA-OT/plugins/org.dita.pdf2/cfg/catalog.xml" (DOT 1.8.4) (maintenance 5)</li>
|
|---|
| 337 |
|
|---|
| 338 | <li class="li">#1663 Treat non-DITA links as external (maintenance 5)</li>
|
|---|
| 339 |
|
|---|
| 340 | <li class="li">#1665 NullPointerException with incorrect conkeyref (maintenance 5)</li>
|
|---|
| 341 |
|
|---|
| 342 | <li class="li">#1675 Image without an @href attribute generates error in XSLT stylesheet for PDF transformation (DOT 1.8) (maintenance 5)</li>
|
|---|
| 343 |
|
|---|
| 344 | <li class="li">#1730 Table border gone in Arabic PDF (maintenance 5)</li>
|
|---|
| 345 |
|
|---|
| 346 | </ul>
|
|---|
| 347 |
|
|---|
| 348 | </div>
|
|---|
| 349 |
|
|---|
| 350 | </div>
|
|---|
| 351 |
|
|---|
| 352 | </div>
|
|---|
| 353 |
|
|---|
| 354 |
|
|---|
| 355 | </body>
|
|---|
| 356 | </html>
|
|---|
