index.html 55 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654
  1. <!DOCTYPE html
  2. SYSTEM "about:legacy-compat">
  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 2016"><meta name="DC.rights.owner" content="(C) Copyright 2016"><meta name="DC.Type" content="reference"><meta name="abstract" content="DITA Open Toolkit 2.3.3 is a maintenance release that fixes issues reported in DITA-OT 2.3, which includes enhanced HTML5 output, new language support and additional internationalization improvements."><meta name="description" content="DITA Open Toolkit 2.3.3 is a maintenance release that fixes issues reported in DITA-OT 2.3, which includes enhanced HTML5 output, new language support and additional internationalization improvements."><meta name="DC.Format" content="XHTML"><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>DITA Open Toolkit 2.3.3 Release Notes</title></head><body id="ID"><header role="banner"><div class="header">
  4. <p>DITA Open Toolkit</p>
  5. <hr>
  6. </div></header><nav role="toc"><ul><li><a href="../index.html">DITA Open Toolkit 2.3</a></li><li class="active"><a href="../release-notes/index.html">Release Notes</a></li><li><a href="../getting-started/index.html">Getting Started</a></li><li><a href="../user-guide/index.html">User Guide</a></li><li><a href="../parameters/index.html">Parameter Reference</a></li><li><a href="../dev_ref/index.html">Developer Reference</a></li><li><a href="../user-guide/dita-and-dita-ot-resources.html">DITA Resources</a></li></ul></nav><main role="main"><article role="article" aria-labelledby="ariaid-title1">
  7. <h1 class="title topictitle1" id="ariaid-title1">DITA Open Toolkit <span class="keyword">2.3.3</span> Release Notes</h1>
  8. <div class="abstract">
  9. <p class="shortdesc">DITA Open Toolkit <span class="keyword">2.3.3</span> is a maintenance release that fixes issues
  10. reported in DITA-OT <span class="keyword">2.3</span>, which includes <span class="ph">enhanced HTML5 output, new language support
  11. and additional internationalization improvements</span>.</p>
  12. <p class="p">Issue numbers correspond to the tracking number in the <span class="ph">
  13. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues" target="_blank">GitHub issues tracker</a></span>.</p>
  14. </div>
  15. <article class="topic reference nested1" aria-labelledby="ariaid-title2" id="ID__v233">
  16. <h2 class="title topictitle2" id="ariaid-title2">Maintenance Release <span class="keyword">2.3.3</span></h2>
  17. <div class="body refbody">
  18. <section class="section">
  19. <p class="p">DITA Open Toolkit Release <span class="keyword">2.3.3</span> includes the following bug fixes.</p>
  20. <ul class="ul">
  21. <li class="li" id="v233__2440">Lax processing now tolerates hyperlink references with leading or trailing whitespace in the
  22. <code class="keyword markupname xmlatt">@href</code> attribute value, such as:
  23. <pre class="pre codeblock"><code>&lt;xref href=" http://www.example.com" format="html"&gt;</code></pre> Earlier versions of DITA-OT
  24. would convert the space to its URL-encoded equivalent <code class="ph codeph">%20</code> and fail with an error. The URI
  25. validation routines have been modified to issue a warning and continue processing in lax mode, but still
  26. fail in strict mode.
  27. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2440" target="_blank">#2440</a>,
  28. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2488" target="_blank">#2488</a>
  29. </li>
  30. <li class="li" id="v233__2017">In certain cases, earlier versions of DITA-OT resolved relative paths to related links from the
  31. temporary directory rather than from the input DITA map file. Processing has been modified to ensure that
  32. links are generated correctly regardless of the target file location.
  33. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2017" target="_blank">#2017</a>,
  34. <a class="xref" href="https://github.com/dita-ot/dita-ot/pull/2444" target="_blank">#2444</a>
  35. </li>
  36. <li class="li" id="v233__2458">Several errors in the DITA 1.3 <span class="ph filepath">subjectScheme</span> catalog file were corrected to
  37. ensure that the module files and entities for the DITA Map Subject Classification Domain are properly
  38. resolved. Corresponding errata have been submitted to OASIS to ensure the fixes are applied to the official
  39. catalogs.
  40. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2458" target="_blank">#2458</a>
  41. </li>
  42. <li class="li" id="v233__2464">Related link processing has been adjusted to handle cases that generate empty related links
  43. groups.
  44. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2464" target="_blank">#2464</a>
  45. </li>
  46. <li class="li" id="v233__2470">The <code class="ph codeph">mappull</code> preprocessing step that pulls content from referenced topics into
  47. maps has been updated to use the XML catalog to resolve external entity references to their locally cached
  48. equivalents.
  49. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2470" target="_blank">#2470</a>
  50. </li>
  51. <li class="li" id="v233__2474">In PDF output generated by earlier versions of DITA-OT, roman numerals were used to number pages
  52. in the Notices section, assuming notices are most commonly located in the front matter, which uses roman
  53. numbering by default. The toolkit now checks whether the <code class="keyword markupname xmlelement">&lt;notices&gt;</code> element is inside
  54. <code class="keyword markupname xmlelement">&lt;backmatter&gt;</code>, and uses arabic numbering as appropriate.
  55. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2474" target="_blank">#2474</a>
  56. </li>
  57. <li class="li" id="v233__2477">When processing topics with unsupported languages, DITA-OT erroneously claimed it couldn't find
  58. the language <code class="ph codeph">en_us</code> rather than mentioning the unsupported language. The
  59. <span class="keyword msgnum">DOTX001W</span> message now includes the original, most complete value of the ancestor language
  60. to assist in troubleshooting.
  61. <a class="xref" href="https://github.com/dita-ot/dita-ot/pull/2477" target="_blank">#2477</a>
  62. </li>
  63. <li class="li" id="v233__2482">In DITA-OT 2.3.2, reference targets for link-like elements such as
  64. <code class="keyword markupname xmlelement">&lt;abbreviated-form&gt;</code> in short descriptions were incorrectly calculated in some cases.
  65. Processing has been updated to ensure that links are correctly resolved by adjusting references as necessary
  66. to match the path to the target document.
  67. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2482" target="_blank">#2482</a>
  68. </li>
  69. <li class="li" id="v233__2486">The copy-to processing routine failed to update image paths, resulting in invalid references in
  70. topics copied to locations other than the original or peer directories. Processing has been updated to
  71. ensure that image references are adjusted as necessary to reflect the location of the referencing document.
  72. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2486" target="_blank">#2486</a>
  73. </li>
  74. <li class="li" id="v233__2487">PDF: Definitions for several missing localization variables have been added to the Finnish,
  75. Romanian, Russian, and Swedish strings files.
  76. <a class="xref" href="https://github.com/dita-ot/dita-ot/pull/2487" target="_blank">#2487</a>
  77. </li>
  78. </ul>
  79. <p class="p">For the complete list of changes since the previous release, see the
  80. <a class="xref" href="https://github.com/dita-ot/dita-ot/compare/2.3.2...2.3.3" target="_blank">
  81. changelog</a> on GitHub.</p>
  82. </section>
  83. </div>
  84. </article>
  85. <article class="topic reference nested1" aria-labelledby="ariaid-title3" id="ID__v232">
  86. <h2 class="title topictitle2" id="ariaid-title3">Maintenance Release 2.3.2</h2>
  87. <div class="body refbody">
  88. <section class="section">
  89. <p class="p">DITA Open Toolkit Release 2.3.2 included the following bug fixes.</p>
  90. <ul class="ul">
  91. <li class="li" id="v232__1599">In earlier versions of DITA-OT, relative paths to cross-references from short descriptions were
  92. sometimes interpreted incorrectly if the source and target topics were located in different directories. New
  93. XSL functions now ensure that these references are correctly resolved.
  94. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/1599" target="_blank">#1599</a>
  95. </li>
  96. <li class="li" id="v232__2413">In DITA-OT 2.3, the HTML5 transtype failed on topics with tables when the
  97. <span class="keyword parmname">args.xhtml.classattr</span> parameter was set to <span class="keyword option">no</span>. Processing has been
  98. updated to handle these cases and correctly exclude the DITA class ancestry information when publishing
  99. HTML5 output.
  100. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2413" target="_blank">#2413</a>,
  101. <a class="xref" href="https://github.com/dita-ot/dita-ot/pull/2424" target="_blank">#2424</a>
  102. </li>
  103. <li class="li" id="v232__2439">In DITA-OT 2.3, the PDF2 build target dependency list contained redundant entries. The
  104. integration process has been corrected to remove the duplicates.
  105. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2439" target="_blank">#2439</a>,
  106. <a class="xref" href="https://github.com/dita-ot/dita-ot/pull/2451" target="_blank">#2451</a>
  107. </li>
  108. <li class="li" id="v232__2441">The script that checks for Antenna House installations has been updated to include installation
  109. paths with spaces as used by recent versions of Antenna House for Windows –
  110. <span class="ph filepath">C:\Program&nbsp;Files\Antenna&nbsp;House</span> and the (x86) equivalent.
  111. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2441" target="_blank">#2441</a>
  112. </li>
  113. </ul>
  114. <p class="p">For the complete list of changes since the previous release, see the
  115. <a class="xref" href="https://github.com/dita-ot/dita-ot/compare/2.3.1...2.3.2" target="_blank">
  116. changelog</a> on GitHub.</p>
  117. </section>
  118. </div>
  119. </article>
  120. <article class="topic reference nested1" aria-labelledby="ariaid-title4" id="ID__v231">
  121. <h2 class="title topictitle2" id="ariaid-title4">Maintenance Release 2.3.1</h2>
  122. <div class="body refbody">
  123. <section class="section">
  124. <p class="p">DITA Open Toolkit Release 2.3.1 included the following bug fixes.</p>
  125. <ul class="ul">
  126. <li class="li" id="v231__2395">The distribution package for the 2.3 release included several unnecessary subfolders and
  127. appended the Git commit ID to the version number in the <span class="ph filepath">lib/configuration.properties</span>
  128. file. The extra directories have been removed and the <code class="ph codeph">otversion</code> in the properties file has
  129. been corrected.
  130. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2395" target="_blank">#2395</a>
  131. </li>
  132. <li class="li" id="v231__2398">In DITA-OT 2.3, temporary file folders specified via the <span class="keyword parmname">dita.temp.dir</span>
  133. parameter were interpreted as relative to the folder where the Java process started. This regression has
  134. been fixed to ensure that temporary folders are once again interpreted as relative to the base directory of
  135. the Ant process as in previous toolkit versions.
  136. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2398" target="_blank">#2398</a>
  137. </li>
  138. <li class="li" id="v231__2400">On Windows, the <span class="keyword cmdname">dita</span> command would not run correctly if the name of a folder
  139. in the path to the DITA-OT 2.3 installation directory included spaces. The <span class="ph filepath">dita.bat</span>
  140. script has been modified to support installation paths with spaces.
  141. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2400" target="_blank">#2400</a>
  142. </li>
  143. <li class="li" id="v231__2401">The DITA 1.3 DTD, Schema, and RNG files have been updated to the final "OASIS Standard" copy;
  144. this change updates the OASIS link and date in many header files, but does not affect how the grammar files
  145. work. In addition, the catalog has been updated to restore two entries that will eventually be shipped in
  146. the DITA 1.3 Errata from OASIS.
  147. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2401" target="_blank">#2401</a>
  148. </li>
  149. <li class="li" id="v231__2408">Fixed an issue where some front-matter sections, such as <code class="keyword markupname xmlelement">&lt;draftintro&gt;</code> and
  150. <code class="keyword markupname xmlelement">&lt;bookabstract&gt;</code>, caused page numbering to switch back and forth between Roman
  151. numerals and body-style Arabic numerals.
  152. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2408" target="_blank">#2408</a>
  153. </li>
  154. </ul>
  155. <p class="p">For the complete list of changes since the previous release, see the
  156. <a class="xref" href="https://github.com/dita-ot/dita-ot/compare/2.3...2.3.1" target="_blank">
  157. changelog</a> on GitHub.</p>
  158. </section>
  159. </div>
  160. </article>
  161. <article class="topic reference nested1" aria-labelledby="ariaid-title5" id="ID__requirements">
  162. <h2 class="title topictitle2" id="ariaid-title5">Requirements</h2>
  163. <div class="body refbody">
  164. <section class="section">
  165. <p class="p">DITA Open Toolkit Release <span class="keyword">2.3</span> requires the Java Runtime Environment (JRE) version
  166. <span class="keyword">7</span> or later.</p>
  167. </section>
  168. </div>
  169. </article>
  170. <article class="topic reference nested1" aria-labelledby="ariaid-title6" id="ID__highlights">
  171. <h2 class="title topictitle2" id="ariaid-title6">Release Highlights</h2>
  172. <div class="body refbody"><p class="shortdesc">DITA-OT <span class="keyword">2.3</span> includes <span class="ph" id="highlights__summary">enhanced HTML5 output, new language support
  173. and additional internationalization improvements</span>.</p>
  174. <section class="section"><h3 class="title sectiontitle">Single .zip distribution package</h3>
  175. <p class="p" id="highlights__2269">DITA Open Toolkit now ships as a single distribution package in a <span class="ph filepath">.zip</span>
  176. archive, as modern versions of Linux and OS&nbsp;X no longer have the file permission issues that originally
  177. required the additional <span class="ph filepath">.tar.gz</span> distribution package.
  178. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2269" target="_blank">#2269</a>
  179. </p>
  180. </section>
  181. <section class="section"><h3 class="title sectiontitle">Enhanced HTML5 output</h3>
  182. <p class="p" id="highlights__2239">The <span class="keyword option">HTML5</span> table processing has been refactored to use valid HTML5 markup, HTML5
  183. best practices, and better CSS properties for styling.
  184. <a class="xref" href="https://en.bem.info/methodology/" target="_blank">BEM</a>-style CSS classes are
  185. now generated with the name of the containing element, the name of the attribute, and the value of the
  186. attribute.
  187. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2239" target="_blank">#2239</a>
  188. </p>
  189. <p class="p" id="highlights__2195-2196">Common CSS files are now generated using separate modules for each DITA domain, implemented as
  190. <a class="xref" href="http://sass-lang.com" target="_blank">Sass</a> partials to better support extensions with CSS frameworks, custom plug-ins and
  191. future toolkit versions.
  192. <a class="xref" href="https://github.com/dita-ot/dita-ot/pull/2195" target="_blank">#2195</a>,
  193. <a class="xref" href="https://github.com/dita-ot/dita-ot/pull/2196" target="_blank">#2196</a>,
  194. <a class="xref" href="https://github.com/dita-ot/dita-ot/pull/2218" target="_blank">#2218</a>,
  195. <a class="xref" href="https://github.com/dita-ot/dita-ot/pull/2369" target="_blank">#2369</a>
  196. </p>
  197. </section>
  198. <section class="section"><h3 class="title sectiontitle">New language support</h3>
  199. <div class="p" id="highlights__2137">The <span class="keyword option">PDF</span> transformation has been extended to support additional languages with
  200. localized strings files and index collation.
  201. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2137" target="_blank">#2137</a>,
  202. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2344" target="_blank">#2344</a>
  203. <ul class="ul">
  204. <li class="li">Belarusian</li>
  205. <li class="li">Bulgarian</li>
  206. <li class="li">Chinese (traditional), with limited support for index sorting</li>
  207. <li class="li">Estonian</li>
  208. <li class="li">Greek</li>
  209. <li class="li">Hindi</li>
  210. <li class="li">Indonesian</li>
  211. <li class="li">Kazakh</li>
  212. <li class="li">Korean</li>
  213. <li class="li">Lithuanian</li>
  214. <li class="li">Macedonian</li>
  215. <li class="li">Malay</li>
  216. <li class="li">Serbian (Cyrillic script)</li>
  217. <li class="li">Serbian (Latin script)</li>
  218. <li class="li">Thai</li>
  219. <li class="li">Ukrainian</li>
  220. <li class="li">Urdu</li>
  221. </ul>
  222. </div>
  223. <p class="p"><span class="keyword option">PDF</span>, <span class="keyword option">HTML</span>, and <span class="keyword option">XHTML</span> transformation types have been
  224. updated to support Bosnian, Montenegrin, and Vietnamese, including localized string files and (for
  225. <span class="keyword option">PDF</span>) index collation.
  226. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2150" target="_blank">#2150</a>,
  227. <a class="xref" href="https://github.com/dita-ot/dita-ot/pull/2360" target="_blank">#2360</a>
  228. </p>
  229. </section>
  230. <section class="section"><h3 class="title sectiontitle">Internationalization improvements</h3>
  231. <div class="p">Along with the new languages supported by the <span class="keyword option">PDF</span> and <span class="keyword option">HTML</span> transformations,
  232. DITA Open Toolkit Release <span class="keyword">2.3</span> provides additional internationalization improvements,
  233. including:
  234. <ul class="ul">
  235. <li class="li" id="highlights__2267">When testing for bi-directional content, more languages are now recognized as right-to-left.
  236. No additional support is added (for example, generated strings for new languages will appear using the
  237. DITA-OT default language), but otherwise content will use the proper direction by default. Arabic, Urdu,
  238. and Hebrew are already recognized by default; this change recognizes an additional 14 languages.
  239. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/1710" target="_blank">#1710</a>,
  240. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2267" target="_blank">#2267</a>
  241. </li>
  242. <li class="li" id="highlights__2279">PDF: Additional fallback fonts have been specified in the
  243. <span class="ph filepath">font-mappings.xml</span> file to provide better out-of-the-box support for Asian
  244. characters.
  245. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2279" target="_blank">#2279</a>,
  246. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2280" target="_blank">#2280</a>,
  247. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2296" target="_blank">#2296</a>
  248. </li>
  249. <li class="li" id="highlights__2302">HTML: Earlier releases of DITA-OT 2.x generated a <code class="keyword markupname xmlatt">@style</code> attribute with
  250. <code class="ph codeph">text-align:left</code> on table cells, regardless of whether the <code class="keyword markupname xmlatt">@align</code>
  251. attribute was set in the source. This caused problems with right-to-left languages. The default entry
  252. alignment has been removed, so the values of the <code class="keyword markupname xmlatt">@xml:lang</code> and <code class="keyword markupname xmlatt">@dir</code>
  253. attributes on the root of the topic will be respected. (This allows the browser to infer the value for the
  254. <code class="ph codeph">text-align</code> property from the parent elements/styles.)
  255. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2302" target="_blank">#2302</a>,
  256. <a class="xref" href="https://github.com/dita-ot/dita-ot/pull/2368" target="_blank">#2368</a>
  257. </li>
  258. <li class="li" id="highlights__2343">PDF: The Dutch variable file now includes translations for Glossary, List of tables, and List
  259. of figures. In addition, German, Italian, French, and Spanish have been updated to define missing
  260. variables, including one that previously resulted in a build error ("Table of Contents Notices").
  261. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2131" target="_blank">#2131</a>,
  262. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2343" target="_blank">#2343</a>
  263. </li>
  264. <li class="li" id="highlights__2357">The DITA-OT configuration value <code class="ph codeph">default.language</code> is now used as the default
  265. language in all output formats. The value ships as <code class="ph codeph">en</code>, but can be changed in
  266. <span class="ph filepath">configuration.properties</span> or specified as a parameter to the build. For HTML output,
  267. the default is now the closest specified language; if a document does not specify
  268. <code class="keyword markupname xmlatt">@xml:lang</code>, <code class="ph codeph">default.language</code> is used. For PDF output, the default is the
  269. closest specified language; if a document does not specify <code class="keyword markupname xmlatt">@xml:lang</code>, the root map is
  270. used; if the root map does not specify <code class="keyword markupname xmlatt">@xml:lang</code>, <code class="ph codeph">default.language</code> is
  271. used.
  272. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/1476" target="_blank">#1476</a>,
  273. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2201" target="_blank">#2201</a>,
  274. <a class="xref" href="https://github.com/dita-ot/dita-ot/pull/2356" target="_blank">#2356</a>,
  275. <a class="xref" href="https://github.com/dita-ot/dita-ot/pull/2357" target="_blank">#2357</a>
  276. </li>
  277. </ul>
  278. </div>
  279. </section>
  280. </div>
  281. </article>
  282. <article class="topic reference nested1" aria-labelledby="ariaid-title7" id="ID__issues">
  283. <h2 class="title topictitle2" id="ariaid-title7">Resolved issues</h2>
  284. <div class="body refbody"><p class="shortdesc">In addition to the highlights mentioned above, DITA Open Toolkit Release <span class="keyword">2.3</span>
  285. includes the following changes.</p>
  286. <section class="section" id="issues__features"><h3 class="title sectiontitle">Features</h3>
  287. <p class="p">DITA Open Toolkit Release <span class="keyword">2.3</span> includes the following new features:</p>
  288. <ul class="ul">
  289. <li class="li" id="issues__1116">The <code class="ph codeph">args.eclipsehelp.toc</code> parameter for Eclipse Help, which has not worked
  290. properly for several releases after it was made obsolete in DITA-OT 1.3, has been removed.
  291. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/1116" target="_blank">#1116</a>,
  292. <a class="xref" href="https://github.com/dita-ot/dita-ot/pull/2354" target="_blank">#2354</a>
  293. </li>
  294. <li class="li" id="issues__1777">DITA 1.3: Initial support has been added for the <code class="keyword markupname xmlatt">@orient</code> attribute on
  295. <code class="keyword markupname xmlelement">&lt;table&gt;</code> elements. These changes allow Antenna House Formatter to render tables in
  296. landscape mode when the <code class="keyword markupname xmlatt">@orient</code> attribute is set to <span class="keyword option">land</span>. A future release
  297. will provide extended support for multi-page landscape tables with additional rendering engines.
  298. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/1777" target="_blank">#1777</a>,
  299. <a class="xref" href="https://github.com/dita-ot/dita-ot/pull/2387" target="_blank">#2387</a>
  300. </li>
  301. <li class="li" id="issues__2130">To permit automated building and testing on any platform, the HTMLHelp version of the
  302. documentation is no longer included in the distribution package. An HTMLHelp version of the documentation
  303. can still be built on Windows using the downloaded distribution package.
  304. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2130" target="_blank">#2130</a>
  305. </li>
  306. <li class="li" id="issues__2144">SAX pipes can now be configured in Ant <code class="keyword markupname xmlelement">&lt;pipeline&gt;</code> tasks. This allows new
  307. tasks to take advantage of in-memory processing without the need to write out files to disk.
  308. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2144" target="_blank">#2144</a>
  309. </li>
  310. <li class="li" id="issues__2155">The process for generating topic headers in the <span class="keyword option">PDF</span> transformation type has
  311. been simplified to use a single template with <code class="ph codeph">mode="insertTopicHeaderMarker"</code>. This reduces
  312. the amount of work needed to format titles differently in the header and body.
  313. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2155" target="_blank">#2155</a>
  314. </li>
  315. <li class="li" id="issues__2185">The <span class="keyword option">HTML5</span> transformation type supports two new extension points
  316. <code class="ph codeph">dita.conductor.html5.param</code> and <code class="ph codeph">dita.conductor.html5.toc.param</code>, allowing
  317. plugins to provide new parameters for HTML5 processing.
  318. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2185" target="_blank">#2185</a>
  319. </li>
  320. <li class="li" id="issues__2210">Processing for <code class="keyword markupname xmlatt">@copy-to</code> has been moved out of the <code class="ph codeph">gen-list</code>
  321. preprocessing module and into a separate step. This improves processing for
  322. <code class="keyword markupname xmlelement">&lt;topicref&gt;</code> elements that use <code class="keyword markupname xmlatt">@copy-to</code> and <code class="keyword markupname xmlatt">@keyref</code>.
  323. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2210" target="_blank">#2210</a>
  324. </li>
  325. <li class="li" id="issues__2230">The DITA-OT preprocessing step that reads images for information about height and width now
  326. supports reading dimension metadata from SVG images.
  327. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2230" target="_blank">#2230</a>
  328. </li>
  329. <li class="li" id="issues__2317">The <span class="keyword option">PDF</span> transformation type has been updated to support the
  330. <code class="keyword markupname xmlatt">@expanse</code> value "page" for elements that use the attribute. In addition, the
  331. <code class="keyword markupname xmlelement">&lt;msgblock&gt;</code> element has been updated to support <code class="keyword markupname xmlatt">@frame</code> and
  332. <code class="keyword markupname xmlatt">@scale</code>, which generally appear on the same elements that use <code class="keyword markupname xmlatt">@expanse</code>.
  333. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2317" target="_blank">#2317</a>,
  334. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2352" target="_blank">#2352</a>
  335. </li>
  336. <li class="li" id="issues__2359">Cross-references to footnotes now generate hyperlinks in PDF output.
  337. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2359" target="_blank">#2359</a>,
  338. <a class="xref" href="https://github.com/dita-ot/dita-ot/pull/2364" target="_blank">#2364</a>
  339. </li>
  340. </ul>
  341. </section>
  342. <section class="section" id="issues__enhancements"><h3 class="title sectiontitle">Enhancements</h3>
  343. <p class="p">DITA Open Toolkit Release <span class="keyword">2.3</span> includes the following enhancements and changes to
  344. existing features:</p>
  345. <ul class="ul">
  346. <li class="li" id="issues__1860">PDF: Information from the <span class="ph filepath">README.txt</span> files in the
  347. <span class="ph filepath">org.dita.pdf2</span> plugin have been moved to the “PDF plug-in structure” topic in the DITA
  348. Open Toolkit <cite class="cite">Developer Reference</cite>. Now that all useful information is available in the
  349. documentation, the <span class="ph filepath">README.txt</span> files have been removed.
  350. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/1860" target="_blank">#1860</a>
  351. </li>
  352. <li class="li" id="issues__1924">PDF: In earlier versions of DITA-OT, filtering out all rows from a
  353. <code class="keyword markupname xmlelement">&lt;simpletable&gt;</code> element resulted in invalid XSL-FO. When all rows are filtered out,
  354. the XSL-FO file now contains an empty (but valid) table so that processing can continue.
  355. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/1924" target="_blank">#1924</a>,
  356. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/1950" target="_blank">#1950</a>
  357. </li>
  358. <li class="li" id="issues__2122">Guava libraries are now used to simplify access to collections in Java code (among other
  359. things).
  360. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2122" target="_blank">#2122</a>
  361. </li>
  362. <li class="li" id="issues__2133">HTML: The documentation for the <span class="keyword option">args.hdr</span> and <span class="keyword option">args.ftr</span> options
  363. now clarifies that header and footer files must be specified using an absolute path. The options have always
  364. required an absolute path, but the documentation for earlier releases did not include this requirement.
  365. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2133" target="_blank">#2133</a>
  366. </li>
  367. <li class="li" id="issues__2140">The <span class="keyword cmdname">dita</span> command will now run using Java headless mode by default. This
  368. optimizes the use of system resources during a build and prevents the build process from stealing focus from
  369. other applications.
  370. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2140" target="_blank">#2140</a>
  371. </li>
  372. <li class="li" id="issues__2160">HTML: Static text for XHTML tables and figures (such as "Table 5") is now surrounded with a
  373. <code class="keyword markupname xmlelement">&lt;span&gt;</code> element, making it easier to style or hide the static text using CSS. In
  374. addition, HTML5 output is updated to use semantic elements for figure and table captions.
  375. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2160" target="_blank">#2160</a>
  376. </li>
  377. <li class="li" id="issues__2177">Two members of the <code class="ph codeph">AbstractPipelineModuleImpl</code> class have been marked as
  378. protected, to allow plugins to access them from derived classes.
  379. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2177" target="_blank">#2177</a>
  380. </li>
  381. <li class="li" id="issues__2179">PDF: The I18N Java and XSLT processing code has been merged into single task. This is not
  382. visible to most users of the PDF code, apart from a reduction in processing time. It also eliminates the
  383. need for a <span class="ph filepath">stage3.fo</span> file in the temporary directory; instead,
  384. <span class="ph filepath">topic.fo</span> is generated directly from <span class="ph filepath">stage2.fo</span>.
  385. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2179" target="_blank">#2179</a>
  386. </li>
  387. <li class="li" id="issues__2181">In a previous release, the HTML5 extension point <code class="ph codeph">dita.conductor.html5.param</code> was
  388. declared but not implemented. The improper declaration was removed and the extension was properly
  389. implemented.
  390. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2181" target="_blank">#2181</a>
  391. </li>
  392. <li class="li" id="issues__2191">HTML: In previous releases, short descriptions in <code class="keyword markupname xmlelement">&lt;abstract&gt;</code> elements
  393. were rendered as division elements (<code class="keyword markupname xmlelement">&lt;div&gt;</code>), rather than paragraphs
  394. (<code class="keyword markupname xmlelement">&lt;p&gt;</code>). Processing has been revised to ensure that short descriptions are
  395. consistently rendered as paragraphs, regardless of whether they appear in <code class="keyword markupname xmlelement">&lt;abstract&gt;</code>
  396. elements.
  397. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2191" target="_blank">#2191</a>
  398. </li>
  399. <li class="li" id="issues__2207">The order of the <code class="ph codeph">chunk</code> and <code class="ph codeph">move-meta-entries</code> pre-processing
  400. stages has been switched so that <code class="ph codeph">chunk</code> comes first. This ensures that metadata is properly
  401. pulled or pushed into the chunked version of DITA topics.
  402. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2207" target="_blank">#2207</a>
  403. </li>
  404. <li class="li" id="issues__2217">HTML: The process for handling <code class="keyword markupname xmlatt">@othertype</code> on a <code class="keyword markupname xmlelement">&lt;note&gt;</code>
  405. element in HTML has been updated to use XSLT 2.0 best practices.
  406. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2217" target="_blank">#2217</a>
  407. </li>
  408. <li class="li" id="issues__2229">PDF: Earlier versions used an <code class="keyword markupname xmlelement">&lt;fo:inline&gt;</code> element as a link target within
  409. topic titles, which can result in extra white space for certain common customizations. The process now
  410. places an ID on <code class="keyword markupname xmlelement">&lt;fo:wrapper&gt;</code>, which removes the extra element and extra white space.
  411. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2229" target="_blank">#2229</a>
  412. </li>
  413. <li class="li" id="issues__2231">XSLT processing now uses a single parameter for message IDs rather than combining one parameter
  414. for the error number with another parameter for severity. This simplifies message processing and allows a
  415. greater range of message IDs in the future. In addition, the <span class="keyword msgnum">DOTX071W</span> message will display
  416. a warning for customizations that use the older, deprecated parameters.
  417. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2231" target="_blank">#2231</a>
  418. </li>
  419. <li class="li" id="issues__2233">Common XSLT utility templates have been rewritten as functions. In addition, XSpec tests have
  420. been created so that the functions are now covered by automated DITA-OT testing.
  421. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2233" target="_blank">#2233</a>
  422. </li>
  423. <li class="li" id="issues__2241">The distribution integration and docs stages of the build process are now run in a forked JVM .
  424. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2241" target="_blank">#2241</a>
  425. </li>
  426. <li class="li" id="issues__2249">PDF: A reference to the PDF2 catalog has been added to <span class="ph filepath">catalog-dita.xml</span>. In
  427. previous releases, running <span class="ph filepath">topic2fo_shell.xsl</span> directly would fail because the XSLT
  428. processor couldn't resolve paths that use the <code class="ph codeph">cfg:</code> scheme.
  429. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2249" target="_blank">#2249</a>
  430. </li>
  431. <li class="li" id="issues__2268">The distribution package is now built via a fully automated Continuous Integration process.
  432. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2268" target="_blank">#2268</a>
  433. </li>
  434. <li class="li" id="issues__2276">HTML5: A new stable ID generation process has been implemented, instead of relying on the
  435. <code class="ph codeph">generate-id()</code> function. By removing reliance on a dynamic value, this change enables
  436. automated testing of <code class="keyword markupname xmlatt">@id</code> and <code class="keyword markupname xmlatt">@headers</code> (generated for table accessibility).
  437. This also speeds up regression testing when comparing HTML output with previous versions.
  438. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2276" target="_blank">#2276</a>
  439. </li>
  440. <li class="li" id="issues__2277">A new ditaFileset function has been implemented to replace list files. This has no visible
  441. impact for builds, but improves the processing model overall and allows the older way of working with
  442. individual list files to be deprecated in a future release.
  443. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2277" target="_blank">#2277</a>
  444. </li>
  445. <li class="li" id="issues__2288">The build script for HTMLHelp, <span class="ph filepath">build_dita2htmlhelp.xml</span>, now uses an
  446. environment variable to locate the HTMLHelp compiler. This allows the process to build a CHM file when the
  447. HTML Help Workshop is not installed on the <span class="ph filepath">C:</span> drive.
  448. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2288" target="_blank">#2288</a>
  449. </li>
  450. <li class="li" id="issues__2305">HTML5: new extension points allow for customization of HTML5 output, HTML5 TOC processing, and
  451. HTML5 cover processing. These extension points were declared (but not implemented) in DITA-OT 2.2; this was
  452. addressed in 2.2.5 by removing the declarations. In DITA-OT 2.3, the declarations are restored and properly
  453. implemented.
  454. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2305" target="_blank">#2305</a>
  455. </li>
  456. <li class="li" id="issues__2341">The <span class="ph filepath">startcmd</span> scripts are now generated by the DITA-OT integration process.
  457. This ensures that the <code class="ph codeph">CLASSPATH</code> setting in the scripts is updated with any new or required
  458. Java libraries referenced by custom plug-ins.
  459. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2341" target="_blank">#2341</a>
  460. <div class="note important note_important"><span class="note__title importanttitle">Important:</span> Users who still run DITA-OT using a custom start script based on a copy of
  461. <span class="ph filepath">startcmd</span> may need to update their script after installing custom plug-ins. The
  462. <code class="ph codeph">CLASSPATH</code> declarations are stored in alphabetical order, so they should only change
  463. when new plug-in libraries are added. To avoid these issues, run DITA-OT using the <span class="keyword cmdname">dita</span>
  464. command instead of the deprecated <span class="ph filepath">startcmd</span> scripts.</div></li>
  465. <li class="li" id="issues__2350">PDF: Index group headings now appear in the PDF bookmarks. The new bookmarks will always appear
  466. in collapsed form under the Index heading. For example, a large index that covers every heading in English
  467. will now have bookmarks for "Special characters", "Numerics", and every letter from "A" to "Z".
  468. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2350" target="_blank">#2350</a>
  469. </li>
  470. <li class="li" id="issues__2382">PDF: The <code class="ph codeph">antiquewhite</code> background color has been removed from table heads and
  471. key column contents in <code class="keyword markupname xmlelement">&lt;simpletable&gt;</code> and <code class="keyword markupname xmlelement">&lt;properties&gt;</code> tables
  472. to synchronize presentation with <code class="keyword markupname xmlelement">&lt;choicetable&gt;</code> and provide a more uniform
  473. customization baseline between PDF output and HTML-based formats.
  474. <a class="xref" href="https://github.com/dita-ot/dita-ot/pull/2382" target="_blank">#2382</a>,
  475. <a class="xref" href="https://github.com/dita-ot/dita-ot/pull/2386" target="_blank">#2386</a>
  476. </li>
  477. <li class="li" id="issues__2383">Localization variables that are no longer used in PDF processing have been deprecated and will
  478. be removed in an upcoming release.
  479. <a class="xref" href="https://github.com/dita-ot/dita-ot/pull/2383" target="_blank">#2383</a>
  480. </li>
  481. </ul>
  482. </section>
  483. <section class="section" id="issues__bugs"><h3 class="title sectiontitle">Bugs</h3>
  484. <p class="p">DITA Open Toolkit Release <span class="keyword">2.3</span> provides fixes for the following bugs:</p>
  485. <ul class="ul">
  486. <li class="li" id="issues__1931">PDF: The message "No topicTitleNumber mode template" has been removed. This removes extraneous
  487. messages that appeared when processing a bookmap with <code class="keyword markupname xmlelement">&lt;notices&gt;</code> or
  488. <code class="keyword markupname xmlelement">&lt;bookabstract&gt;</code>, or which refers to a subject scheme map.
  489. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/1931" target="_blank">#1931</a>
  490. </li>
  491. <li class="li" id="issues__2065">HTML: trademark symbols previously only appeared for <code class="keyword markupname xmlelement">&lt;tm&gt;</code> elements in
  492. English and a select few languages. This was a legacy of processing carried over from beta processing before
  493. DITA-OT 1.0; HTML trademark processing will now work the same regardless of document language.
  494. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2065" target="_blank">#2065</a>
  495. </li>
  496. <li class="li" id="issues__2141">Processing for <code class="keyword markupname xmlelement">&lt;coderef&gt;</code> elements could be broken when the
  497. <code class="keyword markupname xmlelement">&lt;coderef&gt;</code> was part of a larger section reused by conref. This is fixed by resolving
  498. <code class="keyword markupname xmlelement">&lt;coderef&gt;</code> during the <code class="ph codeph">topic-fragment</code> step of preprocessing.
  499. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2141" target="_blank">#2141</a>
  500. </li>
  501. <li class="li" id="issues__2161">The AXF document-info attribute <code class="keyword markupname xmlatt">@title</code> is deprecated; XSL-FO output for Antenna
  502. House output should use the <code class="keyword markupname xmlatt">@document-title</code> attribute instead.
  503. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2161" target="_blank">#2161</a>,
  504. <a class="xref" href="https://github.com/dita-ot/dita-ot/pull/2162" target="_blank">#2162</a>
  505. </li>
  506. <li class="li" id="issues__2190">When using keys, referencing a file outside of the current directory causes processing to fail.
  507. Previously, the target file URI was resolved against the root of the temp directory. This has been updated
  508. to resolve the URI against the source file URI, which should always yield the correct result.
  509. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2190" target="_blank">#2190</a>,
  510. <a class="xref" href="https://github.com/dita-ot/dita-ot/pull/2223" target="_blank">#2223</a>
  511. </li>
  512. <li class="li" id="issues__2197">In previous releases, specializations of the <code class="keyword markupname xmlelement">&lt;link&gt;</code> element did not work
  513. as intended. The corresponding XSLT template mode <code class="ph codeph">related-links:link</code> has been modified to
  514. properly handle new elements that are based on the <code class="keyword markupname xmlelement">&lt;link&gt;</code> element.
  515. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2197" target="_blank">#2197</a>,
  516. <a class="xref" href="https://github.com/dita-ot/dita-ot/pull/2199" target="_blank">#2199</a>
  517. </li>
  518. <li class="li" id="issues__2227">Circular key definitions, when an element used <code class="keyword markupname xmlatt">@keyref</code> to refer to a key on the
  519. same element, resulted in a stack overflow in KeydefReader. This construct is now reported as an error with
  520. message <span class="keyword msgnum">DOTJ069E</span>.
  521. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2227" target="_blank">#2227</a>
  522. </li>
  523. <li class="li" id="issues__2243">Publishing failed when using <code class="keyword markupname xmlelement">&lt;term&gt;</code> with keyref and chunking, as the
  524. chunking module created file references with backslashes. Processing has been updated to convert any
  525. backslashes to slashes before using the <code class="ph codeph">resolve-uri</code> function in XSLT. This ensures that the
  526. attribute values are valid URI references according to
  527. <a class="xref" href="https://tools.ietf.org/html/rfc3986" target="_blank">RFC 3986</a>.
  528. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2243" target="_blank">#2243</a>
  529. </li>
  530. <li class="li" id="issues__2294">PDF: In the simplified Chinese variables file (zh-CN), additional translations have been
  531. provided for some static strings that previously appeared in English.
  532. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2294" target="_blank">#2294</a>,
  533. <a class="xref" href="https://github.com/dita-ot/dita-ot/pull/2353" target="_blank">#2353</a>
  534. </li>
  535. <li class="li" id="issues__2304">Resource-only topic references were considered duplicates by key processing, resulting in
  536. renamed output files in some cases. The resource-only instances are now ignored when determining whether to
  537. rename output files.
  538. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2304" target="_blank">#2304</a>
  539. </li>
  540. <li class="li" id="issues__2326">PDF code was cleaned up to remove a broken message that could not be triggered
  541. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2326" target="_blank">#2326</a>,
  542. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2351" target="_blank">#2351</a>
  543. </li>
  544. <li class="li" id="issues__2339">In previous releases, specifying a <code class="keyword markupname xmlatt">@keyscope</code> attribute on the root
  545. <code class="keyword markupname xmlelement">&lt;map&gt;</code> element would cause builds to fail. Processing has been modified to handle
  546. this situation correctly.
  547. <a class="xref" href="https://github.com/dita-ot/dita-ot/issues/2339" target="_blank">#2339</a>
  548. </li>
  549. </ul>
  550. </section>
  551. <section class="section" id="issues__contrib"><h3 class="title sectiontitle">Contributors</h3>
  552. <p class="p">DITA Open Toolkit Release <span class="keyword">2.3</span> includes
  553. <a class="xref" href="https://github.com/dita-ot/dita-ot/graphs/contributors" target="_blank">contributions</a> by the following people:</p>
  554. <ol class="ol">
  555. <li class="li">Jarno Elovirta</li>
  556. <li class="li">Robert D. Anderson</li>
  557. <li class="li">Eero Helenius</li>
  558. <li class="li">Roger Sheen</li>
  559. <li class="li">Eliot Kimber</li>
  560. <li class="li">Radu Coravu</li>
  561. <li class="li">Shane Taylor</li>
  562. <li class="li">Stefan Eike</li>
  563. <li class="li">George Bina</li>
  564. <li class="li">Kristen James Eberlein</li>
  565. </ol>
  566. <p class="p">For the complete list of changes since the previous release, see the
  567. <a class="xref" href="https://github.com/dita-ot/dita-ot/compare/2.2...2.3" target="_blank">
  568. changelog</a> on GitHub.</p>
  569. </section>
  570. <section class="section" id="issues__docs"><h3 class="title sectiontitle">Documentation updates</h3>
  571. <p class="p">The documentation for DITA Open Toolkit Release <span class="keyword">2.3</span> includes corrections and
  572. improvements to existing topics, along with several notable enhancements, including:</p>
  573. <ul class="ul">
  574. <li class="li">The DITA Open Toolkit <cite class="cite">User Guide</cite> includes new topics on additional methods of publishing via
  575. the <span class="keyword cmdname">dita</span> command:
  576. <ul class="ul">
  577. <li class="li">
  578. <a class="xref" href="../user-guide/build-using-dita-properties-file.html" title="Usually, DITA builds require setting a number of parameters that do not change frequently. You can reference a set of build parameters defined in a .properties file when building output with the dita command. If needed, you can override any parameter by specifying it explicitly as an argument to the dita command.">Using a properties file</a>
  579. </li>
  580. <li class="li">
  581. <a class="xref" href="../user-guide/build-migrating-ant-to-dita.html" title="Although Ant builds are still supported in the DITA Open Toolkit, you might want to switch to use the new dita command.">Migrating Ant builds</a>
  582. </li>
  583. </ul>
  584. </li>
  585. <li class="li">The DITA Open Toolkit <cite class="cite">Developer Reference</cite> includes several new sections dedicated to
  586. customization:
  587. <ul class="ul">
  588. <li class="li">
  589. <a class="xref" href="../dev_ref/pdf-customization.html" title="You can create custom DITA-OT plug-ins that build on the default DITA to PDF transformation. Plug-ins can customize covers and page layouts, modify formatting, override logic of the default PDF plug-in, and much more.">Customizing PDF output</a> provides an overview of approaches commonly used to customize the
  590. default PDF output and includes recommendations on best practices and additional resources.</li>
  591. <li class="li">
  592. <a class="xref" href="../dev_ref/migration.html" title="If you have XSL transformation overrides, plug-ins or other customizations written prior to DITA-OT 2.3, you may need to make changes to ensure your overrides work properly with the latest toolkit versions.">Migrating customizations</a> highlights customization-related changes in recent releases to assist plug-in
  593. developers in updating overrides to work with the latest toolkit versions.</li>
  594. </ul>
  595. </li>
  596. <li class="li">
  597. <p class="p">
  598. <a class="xref" href="https://travis-ci.org/" target="_blank">Travis CI</a> continuous integration
  599. is used to automatically publish the latest development version of the documentation on the project
  600. website at
  601. <a class="xref" href="http://www.dita-ot.org/dev/" target="_blank">dita-ot.org/dev</a> whenever
  602. changes are pushed to the <code class="ph codeph">develop</code> branch of the
  603. <a class="xref" href="https://github.com/dita-ot/docs" target="_blank">dita-ot/docs</a> repository
  604. on GitHub.</p></li>
  605. <li class="li">
  606. <p class="p">In the latest
  607. <a class="xref" href="http://www.dita-ot.org/dev/" target="_blank">development version</a> of the
  608. documentation, page footers now include <span class="ph uicontrol">Edit this page</span> links that open the DITA
  609. source file for the topic in
  610. <a class="xref" href="https://www.oxygenxml.com/webauthor/" target="_blank">oXygen XML Web
  611. Author</a>.</p>
  612. <p class="p">The web-based authoring workflow prompts users to log in to GitHub and fork the
  613. <a class="xref" href="https://github.com/dita-ot/docs" target="_blank">dita-ot/docs</a> repository
  614. if necessary. Changes saved in the authoring environment are committed to a new branch, and a pull request
  615. is created to submit changes for review by the DITA-OT documentation team.</p>
  616. </li>
  617. </ul>
  618. <p class="p">For additional information on documentation issues resolved in DITA Open Toolkit Release <span class="keyword">2.3</span>, see the
  619. <a class="xref" href="https://github.com/dita-ot/docs/issues?q=milestone%3A2.3+is%3Aclosed" target="_blank">
  620. <span class="keyword">2.3</span> milestone</a> in the documentation repository.</p>
  621. <p class="p">For the complete list of documentation changes since the previous release, see the
  622. <a class="xref" href="https://github.com/dita-ot/docs/compare/2.2...2.3" target="_blank">
  623. changelog</a>.</p>
  624. </section>
  625. </div>
  626. </article>
  627. </article></main></body></html>